资金市值比
接口描述
提供代币实时主力资金与市值的比值查询，支持现货和合约两种交易类型。
使用场景：
- 适用于实时主力资金在市场的积累占比情况监测
- 适用于判断资金流入强度和市场关注度
- 适用于筛选资金关注度较高的代币标的
数据更新频率：每天更新一次
请求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"
}