Capital-to-market-cap ratio
Description
Major-flow vs market cap for spot, perp, and combined.
Use cases
- How aggressively capital is building vs size
- Attention / crowding proxy
- Screen high flow-to-mcap names
Update: Daily
Endpoint
- Method:
POST - Path:
/open/v1/trade/getCoinTradeInflowMarketCapRatio
Credits
- Cost:
3
Prerequisites
vsTokenId
| Case | Note | How |
|---|---|---|
| Known | Cache | Context |
| Unknown | POST /vs-token/list | Pre-call |
Request body (JSON)
| Field | Type | Required | Description |
|---|---|---|---|
| vsTokenId | long | Yes | Token id |
Response — data
| Field | Type | Serialized | Description |
|---|---|---|---|
| updateTime | long | long | Updated at (ms) |
| vsTokenId | long | string | Token id |
| symbol | string | string | Ticker |
| name | string | string | Name |
| marketCap | number | string | Market cap (USD) |
| spotTradeInflow | number | string | Spot net inflow (USD) |
| spotMarketCapRatio | double | number | Spot flow / mcap |
| contractTradeInflow | number | string | Perp net inflow (USD) |
| contractMarketCapRatio | double | number | Perp flow / mcap |
| totalTradeInflow | number | string | Spot + perp net inflow |
| totalMarketCapRatio | double | number | Combined ratio |
Semantics
| Field | Meaning | Tip |
|---|---|---|
| spotMarketCapRatio | Spot intensity | Higher → more spot flow per mcap |
| contractMarketCapRatio | Perp heat | Perp participation vs size |
| totalMarketCapRatio | Combined | Overall attention metric |
Example
json
{
"vsTokenId": 1
}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}"Sample success
json
{
"code": 200,
"message": "success",
"data": {
"updateTime": 1771001700000,
"vsTokenId": "1",
"symbol": "BTC",
"name": "Bitcoin",
"marketCap": "1380637213701.3374",
"spotTradeInflow": "6952062.183567308",
"spotMarketCapRatio": 5.04E-4,
"contractTradeInflow": "6952062.183567308",
"contractMarketCapRatio": 5.04E-4,
"totalTradeInflow": "13904124.367134616",
"totalMarketCapRatio": 0.001007
},
"requestId": "xxx-xxx-xxx"
}