Tokens API

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

GET /api/v1/tokens2

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

参数

参数	类型	必填	描述
`limit`	`number`	否	返回的代币数量（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。

参数

参数	类型	必填	描述
`q`	`string`	是	搜索关键词（不区分大小写）
`limit`	`number`	否	最大结果数量（默认：`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 中：

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

概述

接口

代币

Tokens API

GET /api/v1/tokens2

参数

响应

排名逻辑

GET /api/v1/tokens2/search

参数

响应

示例

代币地址发现

​Tokens API

​GET /api/v1/tokens2

​参数

​响应

​排名逻辑

​GET /api/v1/tokens2/search

​参数

​响应

​示例

​代币地址发现

Tokens API

GET /api/v1/tokens2

参数

响应

排名逻辑

GET /api/v1/tokens2/search

参数

响应

示例

代币地址发现