Token detail

Description

Returns market, on-chain, and quote basics for a token.

Use cases

• General token lookups
• Price, market cap, supply, changes
• Obtain coinKey for on-chain endpoints

Note: chainAddresses[] holds per-chain coinKey. For holder lists, balance trends, etc., pick a chain and cache its coinKey.

Update frequency: Real-time

Endpoint

• Method: POST
• Path: /open/v1/vs-token/detail

Credits

• Cost: 1

Prerequisites

vsTokenId

Case	Note	How
Known	Use cached id	From context
Unknown	Call POST /vs-token/list	Pre-call

Request body (JSON)

Field	Type	Required	Description
vsTokenId	long	Yes	Token id

Response — data

Field	Type	Serialized	Description
vsTokenId	long	string	Token id
name	string	string	Name
symbol	string	string	Ticker
oldSymbol	string	string	Previous symbol
price	number	string	Price (USD)
highPrice	number	string	ATH (USD)
lowPrice	number	string	ATL (USD)
marketCapDominance	number	string	Dominance (%)
volume24h	number	string	24h volume (USD)
volumeChange24h	number	string	24h volume change (%)
percentChange1h	number	string	1h change (%)
percentChange24h	number	string	24h change (%)
percentChange7d	number	string	7d change (%)
percentChange30d	number	string	30d change (%)
percentChange60d	number	string	60d change (%)
percentChange90d	number	string	90d change (%)
marketCap	number	string	Market cap (USD)
totalSupply	number	string	Total supply
circulationSupply	number	string	Circulating supply
maxSupply	number	string	Max supply
cost	number	string	On-chain avg cost (USD)
chainAddresses	array	array	Per-chain rows
contractAddress	string	string	Contract
chainName	string	string	Chain
holderCount	integer	string	Holder count
transCount	integer	string	Tx count
issueDate	long	long	Issue time (ms)
precision	string	string	Decimals
totalSupply	string	string	Chain supply
coinKey	string	string	On-chain key

Semantics

Field	Meaning	Tip
coinKey	Chain-scoped id	Required for on-chain APIs; pattern like BTC_BTC, eth_0x...
chainAddresses	Multi-chain	User picks chain → cache coinKey
cost	Major-holder cost	From large-trade weighted average

Example

{
    "vsTokenId": 1
}

cURL (Linux/macOS)

curl --location --request POST 'http://${host}/api/open/v1/vs-token/detail' \
--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/vs-token/detail" ^
--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": {
        "vsTokenId": "1",
        "name": "Bitcoin",
        "symbol": "BTC",
        "oldSymbol": "",
        "price": "70559.18",
        "highPrice": "126198.06960343386",
        "lowPrice": "0.04864654",
        "marketCapDominance": "",
        "volume24h": "54389029990.497185",
        "volumeChange24h": "15.6056",
        "percentChange1h": "-0.09167097",
        "percentChange24h": "-1.29235993",
        "percentChange7d": "3.96301796",
        "percentChange30d": "5.35405481",
        "percentChange60d": "-23.17390208",
        "percentChange90d": "-21.71414845",
        "marketCap": "1412725749093.2734",
        "totalSupply": "20001887",
        "circulationSupply": "20001887",
        "maxSupply": "21000000",
        "cost": "60515.829728843657394618",
        "chainAddresses": [
            {
                "contractAddress": "BTC",
                "chainName": "BTC",
                "holderCount": "55905596",
                "transCount": "1322741358",
                "issueDate": 1230998400000,
                "precision": "8",
                "totalSupply": "20001892",
                "coinKey": "BTC_BTC"
            }
        ]
    },
    "requestId": "xxx-xxx-xxx"
}