資金市值比
介面描述
提供代幣即時主力資金與市值的比值查詢，支援現貨和合約兩種交易類型。
使用情境：
- 適用於即時主力資金在市場的累積占比情況監測
- 適用於判斷資金流入強度和市場關注度
- 適用於篩選資金關注度较高的代幣標的
資料更新頻率：每天更新一次
請求 URL
- 方法：
POST - 路徑：
/open/v1/trade/getCoinTradeInflowMarketCapRatio
點數消耗
- 消耗點數：
3
前置條件
取得 vsTokenId
| 條件 | 說明 | 取得方式 |
|---|---|---|
| 已有 vsTokenId | 直接使用快取的 vsTokenId，無需重複查詢 | 上下文自動提取 |
| 未有 vsTokenId | 呼叫 POST /vs-token/list 介面取得 | 前置介面呼叫 |
請求參數
參數透過請求體（Body）以 JSON 格式傳遞。
| 參數名 | 類型 | 必需 | 描述 |
|---|---|---|---|
| vsTokenId | long | 是 | 代幣 ID |
回應欄位
僅展示 data 物件內的欄位結構：
| 欄位 | 類型 | 實際回傳類型 | 描述 |
|---|---|---|---|
| updateTime | long | long | 更新時間（毫秒時間戳） |
| vsTokenId | long | string | 代幣ID |
| symbol | string | string | 代幣符號 |
| name | string | string | 代幣名稱 |
| marketCap | number | string | 市值 (USD) |
| spotTradeInflow | number | string | 現貨交易淨流入金額 (USD) |
| spotMarketCapRatio | double | number | 現貨資金市值比率 |
| contractTradeInflow | number | string | 合約交易淨流入金額 (USD) |
| contractMarketCapRatio | double | number | 合約資金市值比率 |
| totalTradeInflow | number | string | 現貨+合約交易淨流入金額 (USD) |
| totalMarketCapRatio | double | number | 現貨+合約資金市值比率 |
欄位業務含義
| 欄位 | 業務含義 | 使用建議 |
|---|---|---|
| spotMarketCapRatio | 現貨資金市值比 | 反映現貨資金流入強度，數值越大表示資金流入相對市值占比越高 |
| contractMarketCapRatio | 合約資金市值比 | 反映合約市場資金流入強度，可用於判斷合約市場热度 |
| totalMarketCapRatio | 綜合資金市值比 | 現貨+合約的綜合指標，是判斷代幣整體資金關注度的核心指標 |
請求範例
json
{
"vsTokenId": 1 // 代币id
}cURL 範例（Linux/macOS）
bash
curl --location --request POST 'http://${host}/api/open/v1/trade/getCoinTradeInflowMarketCapRatio' \
--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/trade/getCoinTradeInflowMarketCapRatio" ^
--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": {
"updateTime": 1771001700000, // 更新时间
"vsTokenId": "1", // 代币ID
"symbol": "BTC", // 代币符号
"name": "Bitcoin", // 代币名称
"marketCap": "1380637213701.3374", // 市值
"spotTradeInflow": "6952062.183567308", // 现货交易净流入金额 (USD)
"spotMarketCapRatio": 5.04E-4, // 现货资金市值比率
"contractTradeInflow": "6952062.183567308", // 合约交易净流入金额 (USD)
"contractMarketCapRatio": 5.04E-4, // 合约资金市值比率
"totalTradeInflow": "13904124.367134616", // 现货+合约交易净流入金额 (USD)
"totalMarketCapRatio": 0.001007 // 现货+合约资金市值比率
},
"requestId": "xxx-xxx-xxx"
}