跳转到主要内容

API 概览

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

基础 URL

https://krokoswap.io/swap-api
以下所有端点均相对于上述基础 URL。

认证

无需认证。API 目前可公开访问。
未来可能会引入认证机制。如果你正在构建长期集成,请定期回来查看此页面的更新。

通用规则

请求格式

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

响应格式

成功的响应直接返回 JSON 数据。错误响应格式如下:
{
  "error": "Human-readable error message"
}

代币数量

所有代币数量均使用原始单位(wei)。对于一个 18 位小数的代币:
人类可读数量原始数量
1.01000000000000000000
0.5500000000000000000
100100000000000000000000
转换公式:原始数量 = 人类可读数量 × 10^小数位数

代币地址

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

端点列表

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

速率限制

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