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`	获取代币列表

速率限制

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

概述

接口

API 概览

API 概览

基础 URL

认证

通用规则

请求格式

响应格式

代币数量

代币地址

端点列表

速率限制

​API 概览

​基础 URL

​认证

​通用规则

​请求格式

​响应格式

​代币数量

​代币地址

​端点列表

​速率限制

API 概览

基础 URL

认证

通用规则

请求格式

响应格式

代币数量

代币地址

端点列表

速率限制