Balance trend

Description

Balance over time for an address ↔ token on one coinKey.

Use cases

• Accumulation vs distribution
• Whale balance monitoring

Update: Daily

Endpoint

• Method: POST
• Path: /open/v1/chain/trade/token/balanceTrend

Credits

• Cost: 2

Prerequisites

vsTokenId, coinKey, address — same pattern as P&L trend

Request body (JSON)

Field	Type	Required	Description
vsTokenId	long	Yes	Token id
coinKey	string	Yes	Chain token key
address	string	Yes	Wallet
startTime	long	No	Start (ms)
endTime	long	Yes	End (ms)

Response — data[]

Field	Type	Serialized	Description
vsTokenId	long	string	Token id
symbol	string	string	Ticker
name	string	string	Name
date	long	long	Time (ms)
balance	number	string	Balance
price	number	string	Price

Semantics

Field	Meaning	Tip
balance	Holdings	Rising → accumulation

Example

{
    "vsTokenId": 1,
    "coinKey": "BTC_BTC",
    "address": "3M219KR5vEneNb47ewrPfWyb5jQ2DjxRP6",
    "endTime": 1773479265534
}

cURL (Linux/macOS)

curl --location --request POST 'http://${host}/api/open/v1/chain/trade/token/balanceTrend' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
    "vsTokenId": 1,
    "coinKey": "BTC_BTC",
    "address": "3M219KR5vEneNb47ewrPfWyb5jQ2DjxRP6",
    "endTime": 1773479265534
}'

cURL (Windows CMD)

curl --location --request POST "http://${host}/api/open/v1/chain/trade/token/balanceTrend" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{    \"vsTokenId\": 1,    \"coinKey\": \"BTC_BTC\",    \"address\": \"3M219KR5vEneNb47ewrPfWyb5jQ2DjxRP6\",    \"endTime\": 1773479265534}"

Sample success

{
    "code": 200,
    "message": "success",
    "data": [
        {
            "vsTokenId": "1",
            "symbol": "BTC",
            "name": "Bitcoin",
            "date": 1542038400000,
            "balance": "0",
            "price": "6359.49"
        }
    ],
    "requestId": "xxx-xxx-xxx"
}