Major-holder cost trend

Description

Real-time weighted average cost of large holders across BTC / EVM / Tron families.

Use cases

• On-chain major cost series
• Behavior vs spot price

Tips

• Natural-language “major cost” → usually this endpoint
• Broad “major analysis” → include this API

Update: Daily

Endpoint

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

Credits

• Cost: 2

Prerequisites

vsTokenId

Request body (JSON)

Field	Type	Required	Description
vsTokenId	long	Yes	Token id
startTime	long	No	Start (ms)
endTime	long	No	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)
price	number	string	Market price (USD)
cost	number	string	Major-holder cost (USD)
balance	number	string	Major-holder balance

Semantics

Field	Meaning	Tip
cost	Weighted avg cost	Large-trade based
balance	Whale inventory	Rising → accumulation
price	Spot	Vs cost → % distance

Example

{
    "vsTokenId": 1,
    "startTime": 1770825600000,
    "endTime": 1773417600000
}

cURL (Linux/macOS)

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

cURL (Windows CMD)

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

Sample success

{
    "code": 200,
    "message": "success",
    "data": [
        {
            "vsTokenId": "1",
            "symbol": "BTC",
            "name": "Bitcoin",
            "date": 1770825600000,
            "price": "67308.54906296561",
            "cost": "60410.667759839053903122",
            "balance": "3878063.59266208"
        }
    ],
    "requestId": "xxx-xxx-xxx"
}