代币基本信息
接口描述
获取指定代币的基础信息，包括市场信息，链上基本信息，行情基本信息等。
使用场景：
- 适用于代币的通用信息查询
- 适用于获取代币的完整信息，包括价格、市值、供应量等
- 适用于获取
coinKey（调用链上数据接口的必要参数）
重要提示：chainAddresses 数组中包含该代币在不同区块链上的 coinKey，如需查询链上持仓地址、余额趋势等数据，需让用户选择目标链并缓存对应的 coinKey。
数据更新频率：实时更新
请求URL
- 方法：
POST - 路径：
/open/v1/vs-token/detail
积分消耗
- 消耗积分：
1
前置条件
获取 vsTokenId
| 条件 | 说明 | 获取方式 |
|---|---|---|
| 已有 vsTokenId | 直接使用缓存的 vsTokenId，无需重复查询 | 上下文自动提取 |
| 未有 vsTokenId | 调用 POST /vs-token/list 接口获取 | 前置接口调用 |
请求参数
参数通过请求体（Body）以 JSON 格式传递。
| 参数名 | 类型 | 必需 | 描述 |
|---|---|---|---|
| vsTokenId | long | 是 | 代币 ID |
响应字段
仅展示 data 对象内的字段结构：
| 字段 | 类型 | 实际返回类型 | 描述 |
|---|---|---|---|
| vsTokenId | long | string | 代币 ID |
| name | string | string | 代币名称 |
| symbol | string | string | 代币符号 |
| oldSymbol | string | string | 改名前的 symbol |
| price | number | string | 当前价格 (USD) |
| highPrice | number | string | 历史最高价 (USD) |
| lowPrice | number | string | 历史最低价 (USD) |
| marketCapDominance | number | string | 市值占比 (%) |
| volume24h | number | string | 24H 交易量 (USD) |
| volumeChange24h | number | string | 24H 交易量变化率 (%) |
| percentChange1h | number | string | 1 小时涨跌幅 (%) |
| percentChange24h | number | string | 24 小时涨跌幅 (%) |
| percentChange7d | number | string | 7 天涨跌幅 (%) |
| percentChange30d | number | string | 30 天涨跌幅 (%) |
| percentChange60d | number | string | 60 天涨跌幅 (%) |
| percentChange90d | number | string | 90 天涨跌幅 (%) |
| marketCap | number | string | 市值 (USD) |
| totalSupply | number | string | 总供应量 |
| circulationSupply | number | string | 流通量 |
| maxSupply | number | string | 最大供应量 |
| cost | number | string | 链上持仓成本 (USD) |
| chainAddresses | array | array | 各个链上信息 |
| contractAddress | string | string | 合约地址 |
| chainName | string | string | 链名 |
| holderCount | integer | string | 持仓地址数 |
| transCount | integer | string | 交易笔数 |
| issueDate | long | long | 发行时间（毫秒时间戳） |
| precision | string | string | 精度 |
| totalSupply | string | string | 该链上供应量 |
| coinKey | string | string | 链上代币标识（重要） |
字段业务含义
| 字段 | 业务含义 | 使用建议 |
|---|---|---|
| coinKey | 链上代币唯一标识 | 调用链上数据接口（持仓地址、余额趋势等）的必要参数，格式为「链名_合约地址」，如 BTC_BTC、eth_0x... |
| chainAddresses | 多链信息列表 | 同一代币可能在多个链上发行，需让用户选择目标链后缓存对应的 coinKey |
| cost | 链上主力成本 | 根据链上大额交易计算的平均持仓成本 |
请求示例
json
{
"vsTokenId": 1 // 代币 id
}cURL 示例（Linux/macOS）
bash
curl --location --request POST 'http://${host}/api/open/v1/vs-token/detail' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
"vsTokenId": 1
}'cURL 示例（Windows CMD）
cmd
curl --location --request POST "http://${host}/api/open/v1/vs-token/detail" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{ \"vsTokenId\": 1}"成功响应示例
json
{
"code": 200,
"message": "success",
"data": {
"vsTokenId": "1", // 代币 ID
"name": "Bitcoin", // 代币名称
"symbol": "BTC", // symbol
"oldSymbol": "", // 改名前的 symbol
"price": "70559.18", // 币种价格
"highPrice": "126198.06960343386", // 最高币价
"lowPrice": "0.04864654", // 最低币价
"marketCapDominance": "", // 市值占比
"volume24h": "54389029990.497185", // 24H 交易量
"volumeChange24h": "15.6056", // 24H 交易量变化率
"percentChange1h": "-0.09167097", // 币价 1 小时变化量
"percentChange24h": "-1.29235993", // 币价 24 小时变化量
"percentChange7d": "3.96301796", // 币价 7 天变化量
"percentChange30d": "5.35405481", // 币价 30 天变化量
"percentChange60d": "-23.17390208", // 币价 60 天变化量
"percentChange90d": "-21.71414845", // 币价 90 天变化量
"marketCap": "1412725749093.2734", // 市值
"totalSupply": "20001887", // 供应量
"circulationSupply": "20001887", // 流通量
"maxSupply": "21000000", // 最大供应量
"cost": "60515.829728843657394618", // 链上持仓成本
"chainAddresses": [
{
"contractAddress": "BTC", // 合约地址
"chainName": "BTC", // 链名
"holderCount": "55905596", // 地址数
"transCount": "1322741358", // 交易笔数
"issueDate": 1230998400000, // 发行时间
"precision": "8", // 精度
"totalSupply": "20001892", // 供应量
"coinKey": "BTC_BTC" // coinKey
}
]
},
"requestId": "xxx-xxx-xxx"
}