Token list

Description

Lists ValueScan-supported tokens with fuzzy search on name or symbol.

Use case: Resolve vsTokenId required by other token APIs.

Note: If multiple tokens match the query (different chains or standards), prompt the user to choose and cache name ↔ vsTokenId.

Update frequency: Real-time

Endpoint

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

Credits

• Cost: 1

Prerequisites

None.

Request body (JSON)

Field	Type	Required	Description
search	string	No	Symbol keyword, fuzzy, max 100 chars, case-insensitive

Response — data[]

Field	Type	Serialized	Description
id	long	long	Token id (vsTokenId)
symbol	string	string	Ticker (e.g. BTC)
name	string	string	Full name (e.g. Bitcoin)

Semantics

Field	Meaning	Tip
id	Canonical id	Same as vsTokenId; cache it
symbol	Display / confirm
name	Disambiguate	When symbols collide

Example

{
    "search": "btc"
}

cURL (Linux/macOS)

curl --location --request POST 'http://${host}/api/open/v1/vs-token/list' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
    "search": "btc"
}'

cURL (Windows CMD)

curl --location --request POST "http://${host}/api/open/v1/vs-token/list" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{    \"search\": \"btc\"}"

Sample success

{
    "code": 200,
    "message": "success",
    "data": [
        {
            "id": 1,
            "symbol": "BTC",
            "name": "Bitcoin"
        },
        {
            "id": 33652,
            "symbol": "LBTC",
            "name": "Lombard Staked BTC"
        },
        {
            "id": 50460,
            "symbol": "SBTC",
            "name": "sBTC"
        }
    ],
    "requestId": "xxx-xxx-xxx"
}