> ## Documentation Index
> Fetch the complete documentation index at: https://docs.krokoswap.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 代币

> 代币列表和搜索端点

# Tokens API

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

## GET /api/v1/tokens2

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

### 参数

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

### 响应

```json theme={null}
{
  "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` 字段，使用子串匹配。

### 示例

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

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

***

## 代币地址发现

如果你有代币合约地址但它不在 API 中：

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