> ## Documentation Index
> Fetch the complete documentation index at: https://docs.krokoswap.io/llms.txt
> Use this file to discover all available pages before exploring further.

# API 概览

> 用于报价、交换、池子、代币和价格查询的 REST API

# API 概览

Kroko DEX 提供一套 REST API，用于交换路由、价格报价、池子数据和代币信息查询。API 在链下处理复杂的路由逻辑，并返回可直接使用的交易 calldata。

## 基础 URL

<Tabs>
  <Tab title="主网">
    ```
    https://krokoswap.io/swap-api
    ```
  </Tab>

  <Tab title="测试网">
    ```
    https://testnet.krokoswap.io/swap-api
    ```
  </Tab>
</Tabs>

以下所有端点均相对于上述基础 URL。

## 认证

无需认证。API 目前可公开访问。

<Info>
  未来可能会引入认证机制。如果你正在构建长期集成，请定期回来查看此页面的更新。
</Info>

## 通用规则

### 请求格式

* `GET` 端点使用查询参数
* `POST` 端点接受 JSON 请求体，需设置 `Content-Type: application/json`

### 响应格式

成功的响应直接返回 JSON 数据。错误响应格式如下：

```json theme={null}
{
  "error": "Human-readable error message"
}
```

### 代币数量

所有代币数量均使用**原始单位**（wei）。对于一个 18 位小数的代币：

| 人类可读数量 | 原始数量                    |
| ------ | ----------------------- |
| 1.0    | `1000000000000000000`   |
| 0.5    | `500000000000000000`    |
| 100    | `100000000000000000000` |

转换公式：`原始数量 = 人类可读数量 × 10^小数位数`

### 代币地址

始终使用**校验和格式或小写**的 ERC-20 地址。对于原生 KAS，请使用 **WKAS 地址**（不是零地址）。

## 端点列表

| 方法     | 端点                              | 描述                           |
| ------ | ------------------------------- | ---------------------------- |
| `GET`  | [`/api/v1/quote`](/api/quote)   | 获取最优路由的交换报价                  |
| `POST` | [`/api/v1/swap`](/api/swap)     | 生成 Universal Router calldata |
| `GET`  | [`/api/v1/pools`](/api/pools)   | 获取池子列表                       |
| `GET`  | [`/api/v1/tokens`](/api/tokens) | 获取代币列表                       |

## 速率限制

目前没有速率限制。未来可能会有所变更——请使用合理的请求频率。