Quick Start

Onboarding

Step 1: API key

In the Developer Portal, obtain your API key.

Step 2: Environment

Environment	Base URL	Use
Staging	https://api-beta.valuescan.io/api	Development and testing
Production	https://api.valuescan.io/api	Live

Step 3: First request

Token list example:

Request body

{
    "search": "BTC"
}

cURL

curl --location --request POST 'https://api.valuescan.io/api/open/v1/vs-token/list' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: YOUR_API_KEY' \
--header 'X-TIMESTAMP: MILLISECONDS_TIMESTAMP' \
--header 'X-SIGN: SIGNATURE' \
--data-raw '{
    "search": "BTC"
}'

Step 4: Response

{
    "code": 200,
    "message": "success",
    "data": [
        {
            "id": 1,
            "symbol": "BTC",
            "name": "Bitcoin"
        }
    ],
    "requestId": "xxx-xxx-xxx"
}

Core parameters

Parameter	Meaning	How to get
vsTokenId	Token ID in ValueScan	Token list
coinKey	On-chain token key	Token detail

Typical flow

1. Token list → get vsTokenId
      ↓
2. Token detail → coinKey and metadata
      ↓
3. Data APIs → K-line, flow, on-chain, etc.

Next steps

• Basic info for request conventions
• Error handling for status codes
• Per-endpoint docs for parameters and credits