Trade count trend

Description

Counts and notionals of sends/receives for an address on one coinKey.

Use cases

• Activity level
• Buy vs sell intensity

Update: Daily

Endpoint

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

Credits

• Cost: 2

Prerequisites

vsTokenId, coinKey, address — same as other address-scoped chain APIs

Request body (JSON)

Field	Type	Required	Description
vsTokenId	long	Yes	Token id
coinKey	string	Yes	Chain 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)
fromCount	integer	string	Outgoing tx count
toCount	integer	string	Incoming tx count
fromAmount	number	string	Out amount
toAmount	number	string	In amount
price	number	string	Price

Semantics

Field	Meaning	Tip
fromCount	Sells / sends	Higher → more distribution txs
toCount	Buys / receives	Higher → more accumulation txs
fromAmount / toAmount	Notionals	Flow direction

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/tradeCountTrend' \
--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/tradeCountTrend" ^
--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,
            "fromCount": "1",
            "toCount": "1",
            "fromAmount": "0.01",
            "toAmount": "0.01",
            "price": "6359.49"
        }
    ],
    "requestId": "xxx-xxx-xxx"
}