API 概览
Kroko DEX 提供一套 REST API,用于交换路由、价格报价、池子数据和代币信息查询。API 在链下处理复杂的路由逻辑,并返回可直接使用的交易 calldata。
基础 URL
https://krokoswap.io/swap-api
https://testnet.krokoswap.io/swap-api
以下所有端点均相对于上述基础 URL。
无需认证。API 目前可公开访问。
未来可能会引入认证机制。如果你正在构建长期集成,请定期回来查看此页面的更新。
通用规则
请求格式
GET 端点使用查询参数
POST 端点接受 JSON 请求体,需设置 Content-Type: application/json
响应格式
成功的响应直接返回 JSON 数据。错误响应格式如下:
{
"error": "Human-readable error message"
}
代币数量
所有代币数量均使用原始单位(wei)。对于一个 18 位小数的代币:
| 人类可读数量 | 原始数量 |
|---|
| 1.0 | 1000000000000000000 |
| 0.5 | 500000000000000000 |
| 100 | 100000000000000000000 |
转换公式:原始数量 = 人类可读数量 × 10^小数位数
代币地址
始终使用校验和格式或小写的 ERC-20 地址。对于原生 KAS,请使用 WKAS 地址(不是零地址)。
端点列表
| 方法 | 端点 | 描述 |
|---|
GET | /api/v1/quote | 获取最优路由的交换报价 |
POST | /api/v1/swap | 生成 Universal Router calldata |
GET | /api/v1/pools | 获取池子列表 |
GET | /api/v1/tokens | 获取代币列表 |
速率限制
目前没有速率限制。未来可能会有所变更——请使用合理的请求频率。