Token ↔ CEX flow
Description
On-chain holders vs centralized exchange in/out flows and change rates.
Use cases
- Sentiment and flow direction
- How chain supply interacts with CEX inventory
Update: Daily
Endpoint
- Method:
POST - Path:
/open/v1/trade/getCoinTradeFlow
Credits
- Cost:
2
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 |
|---|---|---|---|
| vsTokenId | long | string | Token id |
| symbol | string | string | Ticker |
| name | string | string | Name |
| coinTradeFlowDataV1Vos | array | array | Exchange-flow windows |
| timeRange | string | string | Window |
| timeParticleEnum | integer | integer | Granularity |
| tradeIn | number | string | In (USD) |
| tradeOut | number | string | Out (USD) |
| tradeInNumber | number | string | In (tokens) |
| tradeOutNumber | number | string | Out (tokens) |
| tradeInflow | number | string | Net inflow (USD) |
| tradeAmount | number | string | Volume (USD) |
| tradeInflowChange | number | number | Net-inflow change rate |
Semantics
| Field | Meaning | Tip |
|---|---|---|
| tradeInflow | Net to CEX | + often risk-off (bearish); − off-exchange (bullish) per doc |
| tradeInflowChange | Acceleration | + faster inflow to CEX; − faster outflow |
Example
json
{
"vsTokenId": 1
}cURL (Linux/macOS)
bash
curl --location --request POST 'http://${host}/api/open/v1/trade/getCoinTradeFlow' \
--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/getCoinTradeFlow" ^
--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": {
"vsTokenId": "1",
"symbol": "BTC",
"name": "Bitcoin",
"coinTradeFlowDataV1Vos": [
{
"timeRange": "H1",
"timeParticleEnum": 101,
"tradeIn": "18287486.3421524716",
"tradeOut": "20431186.0069537593",
"tradeInNumber": "261.06338392",
"tradeOutNumber": "292.2527353",
"tradeInflow": "-2143699.6648012877",
"tradeAmount": "38718672.3491062309",
"tradeInflowChange": -1.0504178361
}
]
},
"requestId": "xxx-xxx-xxx"
}