代幣基本資訊

介面描述

取得指定代幣的基礎資訊，包括市場資訊，鏈上基本資訊，行情基本資訊等。

使用情境：

• 適用於代幣的通用資訊查詢
• 適用於取得代幣的完整資訊，包括價格、市值、供應量等
• 適用於取得 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	代幣符號
icon	string	string	代幣圖標 URL
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	鏈上主力成本	依鏈上大額交易計算的平均持倉成本
icon	代幣圖標 URL	用於前端展示代幣圖標

請求範例

{
    "vsTokenId": 1      // 代币 id
}

cURL 範例（Linux/macOS）

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）

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}"

成功回應範例

{
    "code": 200,
    "message": "success",
    "data": {
        "vsTokenId": "1",                           // 代币 ID
        "name": "Bitcoin",                           // 代币名称
        "symbol": "BTC",                             // symbol
        "icon": "https://static.valuescan.io/valuescan/cmc/coins/1.png", // 代币图标
        "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"
}