跳转到主要内容

​
Tokens API

查询 Kroko DEX 上可用的代币列表，按交易活跃度排名。

​
GET /api/v1/tokens2

返回按交易活跃度排名的代币列表（基于 V2 交易对和 V3 池子的总交易次数）。

​
参数

参数类型必填描述
limitnumber否返回的代币数量（1–500，默认：100）

​
响应

{
  "tokens": [
    {
      "address": "0x2c2Ae87Ba178F48637acAe54B87c3924F544a83e",
      "symbol": "WKAS",
      "name": "Wrapped KAS",
      "decimals": 18,
      "logoURI": "https://..."
    },
    {
      "address": "0xB190a6A7fC2873f1Abf145279eD664348d5Ef630",
      "symbol": "HUB",
      "name": "Hub Token",
      "decimals": 18,
      "logoURI": null
    }
  ]
}
字段描述
address代币合约地址（校验和格式）
symbol代币缩写符号
name代币全称
decimals小数位数
logoURI代币图标 URL（可为 null）

​
排名逻辑

代币按其参与的所有 V2 交易对和 V3 池子汇总的 txCount 总交易次数排名。置顶代币（由管理员设置优先级）无论活跃度如何都显示在最前面。

​
GET /api/v1/tokens2/search

按符号或名称搜索代币。适用于代币选择器 UI。

​
参数

参数类型必填描述
qstring是搜索关键词（不区分大小写）
limitnumber否最大结果数量（默认：10）

​
响应

格式与 /api/v1/tokens2 相同。同时搜索 symbol 和 name 字段，使用子串匹配。

​
示例

# 搜索名称或符号中包含 "SUN" 的代币
curl "https://dex.kasplex.org/api/v1/tokens2/search?q=SUN&limit=10"

{
  "tokens": [
    {
      "address": "0x1234...",
      "symbol": "SUN",
      "name": "Sun Token",
      "decimals": 18,
      "logoURI": "https://..."
    }
  ]
}

​
代币地址发现

如果你有代币合约地址但它不在 API 中：
  1. 通过地址搜索目前 API 暂不支持
  2. 链上读取：直接调用 ERC-20 合约的 symbol()、name() 和 decimals() 方法
  3. 导入：联系团队将代币添加到官方列表