Sector token capital

Description

Returns real-time capital accumulation data for all tokens within a specified sector, for spot or perpetual markets across different time windows.

Use cases:

• Monitor token-level capital within a sector during sector rotation
• Discover sector leaders or tokens with anomalous flow
• Capital analysis for thematic investment strategies

Update frequency: Every 5 minutes

Endpoint

• Method: POST
• Path: /open/v1/trade/categories/CoinTradeList

Credits

• Cost: 3

Prerequisites

Obtain tag

Condition	Description	How to obtain
tag available	Use cached sector tag; no repeat lookup	Auto-extracted from context
tag missing	Call POST /open/v1/trade/categories/getTradeList to list sectors and their tags	Prerequisite API call

Request parameters

Parameters are sent as JSON in the request body.

Field	Type	Required	Description
tag	string	Yes	Category tag
tradeType	integer	Yes	Trade type (1: spot, 2: perpetual)

Enum reference

tradeType — Trade type

Value	Meaning
1	Spot
2	Perpetual

Response fields

Structure of each object in the data array:

Field	Type	Serialized	Description
updateTime	long	long	Updated at (ms timestamp)
tag	string	string	Sector tag
tradeType	integer	integer	Trade type (1: spot, 2: perpetual)
vsTokenId	long	string	Token ID
symbol	string	string	Token symbol
name	string	string	Token name
categoriesTradeDataList	array	array	Sector capital data list
timeRange	string	string	Time window
timeParticleEnum	integer	integer	Statistical granularity
tradeInflow	number	number	Net inflow (USD)

Field semantics

Field	Meaning	Tip
categoriesTradeDataList	Sector capital data	Net inflow by time window for the token; use to analyze flow within a sector
tradeInflow	Net inflow	Positive = inflow; negative = outflow

Example

{
    "tag": "AI",          // Category tag
    "tradeType": 1        // Trade type (1: spot, 2: perpetual)
}

cURL (Linux/macOS)

curl --location --request POST 'http://${host}/api/open/v1/trade/categories/CoinTradeList' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
    "tag": "AI",
    "tradeType": 1
}'

cURL (Windows CMD)

curl --location --request POST "http://${host}/api/open/v1/trade/categories/CoinTradeList" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{    \"tag\": \"AI\",    \"tradeType\": 1}"

Success response example

{
    "code": 200,
    "message": "success",
    "data": [
        {
            "updateTime": 1773298200000,                 // Updated at
            "tag": "AI",                                  // Sector tag
            "tradeType": 1,                               // Trade type (1: spot, 2: perpetual)
            "vsTokenId": "1637",                          // Token ID
            "symbol": "RLC",                              // Token symbol
            "name": "iExec RLC",                         // Token name
            "categoriesTradeDataList": [
                {
                    "timeRange": "H6",                    // Time window
                    "timeParticleEnum": 106,              // Statistical granularity
                    "tradeInflow": "3753.6444"            // Net inflow (USD)
                },
                {
                    "timeRange": "M3",
                    "timeParticleEnum": 303,
                    "tradeInflow": "-716516.5178999999"
                },
                {
                    "timeRange": "D90",
                    "timeParticleEnum": 290,
                    "tradeInflow": "-716516.5179"
                }
                // ... more rows omitted
            ]
        },
        {
            "updateTime": 1773298200000,
            "tag": "AI",
            "tradeType": 1,
            "vsTokenId": "1732",
            "symbol": "NMR",
            "name": "Numeraire",
            "categoriesTradeDataList": [
                {
                    "timeRange": "H6",
                    "timeParticleEnum": 106,
                    "tradeInflow": "-1088.4043000000013"
                },
                {
                    "timeRange": "M3",
                    "timeParticleEnum": 303,
                    "tradeInflow": "2671317.5315"
                },
                {
                    "timeRange": "D90",
                    "timeParticleEnum": 290,
                    "tradeInflow": "2671317.5314999996"
                }
                // ... more rows omitted
            ]
        },
        {
            "updateTime": 1773298200000,
            "tag": "AI",
            "tradeType": 1,
            "vsTokenId": "1768",
            "symbol": "ADX",
            "name": "AdEx",
            "categoriesTradeDataList": [
                {
                    "timeRange": "H6",
                    "timeParticleEnum": 106,
                    "tradeInflow": "-11146.473400000003"
                },
                {
                    "timeRange": "M3",
                    "timeParticleEnum": 303,
                    "tradeInflow": "303446.2417000001"
                },
                {
                    "timeRange": "D90",
                    "timeParticleEnum": 290,
                    "tradeInflow": "303446.2417"
                }
                // ... more rows omitted
            ]
        }
    ],
    "requestId": "xxx-xxx-xxx"
}