Real-time capital accumulation

Description

Spot and perpetual net inflow on CEX for a token, plus same-day major-fund accumulation metrics.

Use cases

• Intraday accumulation across windows
• Tracking dominant flow behavior

Tips

• Intraday “major flow”: look at max net inflow within 24h windows
• “Major flow” in general: max net inflow within 90d windows
• Positive net inflow = buying pressure; negative = selling
• If the user asks generically for major flow without market type, return both spot and perp
• Broad “major player analysis” queries → this endpoint

Update: Every 5 minutes

Endpoint

• Method: POST
• Path: /open/v1/trade/getCoinTrade

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
hasSpotGoods	boolean	boolean	Has spot series
spotMaxInflow	number	number	Spot major accumulation (USD)
spotGoodsList	array	array	Spot windows
timeRange	string	string	Window label
timeParticleEnum	integer	integer	Granularity enum
tradeInflow	number	string	Net inflow (USD)
tradeAmount	number	string	Volume (USD)
tradeInflowChange	double	number	Net-inflow change rate
tradeOut	number	string	Outflow (USD)
tradeIn	number	string	Inflow (USD)
hasContract	boolean	boolean	Has perp series
contractMaxInflow	number	number	Perp major accumulation (USD)
contractList	array	array	Perp windows (same subfields)

Semantics

Field	Meaning	Tip
spotMaxInflow	Spot major	Max net inflow across 90d windows — spot
contractMaxInflow	Perp major	Same for perp
hasSpotGoods / hasContract	Flags	If no time filter, default all windows within ~90d
tradeInflowChange	MoM-style delta	Versus prior window

Example

{
    "vsTokenId": 1
}

cURL (Linux/macOS)

curl --location --request POST 'http://${host}/api/open/v1/trade/getCoinTrade' \
--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)

curl --location --request POST "http://${host}/api/open/v1/trade/getCoinTrade" ^
--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

{
    "code": 200,
    "message": "success",
    "data": {
        "updateTime": 1773220800000,
        "vsTokenId": "1",
        "symbol": "BTC",
        "name": "Bitcoin",
        "hasSpotGoods": true,
        "spotMaxInflow": 2588472.3329447997,
        "spotGoodsList": [
            {
                "timeRange": "5m",
                "timeParticleEnum": 5,
                "tradeInflow": "1914106.2828805007",
                "tradeAmount": "4389778.5824913",
                "tradeInflowChange": 373.39,
                "tradeOut": "2475814.5678",
                "tradeIn": "4389920.8506"
            }
        ],
        "hasContract": true,
        "contractMaxInflow": 17609356.027199995,
        "contractList": []
    },
    "requestId": "xxx-xxx-xxx"
}