Capital-to-market-cap ratio
Description
Returns the ratio of real-time major-fund flow to market cap for a token, supporting both spot and perpetual markets.
Use cases:
- Monitor how major funds accumulate relative to market size
- Assess inflow intensity and market attention
- Screen tokens with high capital attention
Update frequency: Once per day
Endpoint
- Method:
POST - Path:
/open/v1/trade/getCoinTradeInflowMarketCapRatio
Credits
- Cost:
3
Prerequisites
Obtain vsTokenId
| Condition | Description | How to obtain |
|---|---|---|
| vsTokenId available | Use cached vsTokenId; no repeat lookup | Auto-extracted from context |
| vsTokenId missing | Call POST /vs-token/list | Prerequisite API call |
Request parameters
Parameters are sent as JSON in the request body.
| Field | Type | Required | Description |
|---|---|---|---|
| vsTokenId | long | Yes | Token ID |
Response fields
Structure of fields inside the data object:
| Field | Type | Serialized | Description |
|---|---|---|---|
| updateTime | long | long | Updated at (ms timestamp) |
| vsTokenId | long | string | Token ID |
| symbol | string | string | Token symbol |
| name | string | string | Token name |
| marketCap | number | string | Market cap (USD) |
| spotTradeInflow | number | string | Spot net inflow (USD) |
| spotMarketCapRatio | double | number | Spot flow-to-market-cap ratio |
| contractTradeInflow | number | string | Perpetual net inflow (USD) |
| contractMarketCapRatio | double | number | Perpetual flow-to-market-cap ratio |
| totalTradeInflow | number | string | Combined spot + perpetual net inflow (USD) |
| totalMarketCapRatio | double | number | Combined flow-to-market-cap ratio |
Field semantics
| Field | Meaning | Tip |
|---|---|---|
| spotMarketCapRatio | Spot flow-to-mcap ratio | Higher values indicate stronger spot inflow relative to market cap |
| contractMarketCapRatio | Perpetual flow-to-mcap ratio | Indicates perpetual market heat |
| totalMarketCapRatio | Combined flow-to-mcap ratio | Core metric for overall capital attention on the token |
Example
json
{
"vsTokenId": 1 // Token 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}"Success response example
json
{
"code": 200,
"message": "success",
"data": {
"updateTime": 1771001700000, // Updated at
"vsTokenId": "1", // Token ID
"symbol": "BTC", // Token symbol
"name": "Bitcoin", // Token name
"marketCap": "1380637213701.3374", // Market cap
"spotTradeInflow": "6952062.183567308", // Spot net inflow (USD)
"spotMarketCapRatio": 5.04E-4, // Spot flow-to-mcap ratio
"contractTradeInflow": "6952062.183567308", // Perpetual net inflow (USD)
"contractMarketCapRatio": 5.04E-4, // Perpetual flow-to-mcap ratio
"totalTradeInflow": "13904124.367134616", // Combined net inflow (USD)
"totalMarketCapRatio": 0.001007 // Combined flow-to-mcap ratio
},
"requestId": "xxx-xxx-xxx"
}