Capital snapshot

Description

Historical accumulation for a token over the last 100 days at arbitrary timestamps, including major-fund accumulation in that window.

Use cases

• Point-in-time flow reconstruction
• Trend of accumulation
• Historical behavior studies

Tips

• Day-only query without clock time → defaults to UTC+8 time-of-day semantics per platform
• Broad “major flow trend” questions → this API

Update: Every 5 minutes

Endpoint

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

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	integer	Yes	Token id
date	long	Yes	Snapshot instant (ms)

Response — data

Field	Type	Serialized	Description
updateTime	integer	long	Updated at (ms)
vsTokenId	integer	string	Token id
symbol	string	string	Ticker
name	string	string	Name
hasSpotGoods	boolean	boolean	Has spot
spotMaxInflow	number	string	Spot major accumulation
spotGoodsList	array	array	Spot windows
timeRange	string	string	Window
timeParticleEnum	integer	integer	Granularity
tradeInflow	number	string	Net inflow (USD)
tradeAmount	number	string	Volume (USD)
hasContract	boolean	boolean	Has perp
contractMaxInflow	number	string	Perp major accumulation
contractList	array	array	Perp windows (same subfields)

Semantics

Field	Meaning	Tip
spotMaxInflow / contractMaxInflow	Major accumulation	Max net inflow bucket + all bucket series
date	Snapshot	Minimum step 5 minutes

Example

{
    "vsTokenId": 1,
    "date": 1773654600000
}

cURL (Linux/macOS)

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

cURL (Windows CMD)

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

Sample success

{
    "code": 200,
    "message": "success",
    "data": {
        "updateTime": 1773654600000,
        "vsTokenId": "1",
        "symbol": "BTC",
        "name": "Bitcoin",
        "hasSpotGoods": true,
        "spotMaxInflow": "173206257.989364",
        "spotGoodsList": [
            {
                "timeRange": "m5",
                "timeParticleEnum": 5,
                "tradeInflow": "973669.0454980996",
                "tradeAmount": "4176136.897351299"
            }
        ],
        "hasContract": true,
        "contractMaxInflow": "5115857220.793299",
        "contractList": []
    },
    "requestId": "xxx-xxx-xxx"
}