Bắt đầu nhanh

Luồng tích hợp

Bước 1: Khóa API

Trong Developer Portal, tạo ứng dụng và lấy khóa.

Bước 2: Môi trường

Môi trường	Base URL	Mục đích
Staging	https://api-beta.valuescan.io/api	Dev / kiểm thử
Production	https://api.valuescan.io/api	Chạy thật

Bước 3: Yêu cầu đầu tiên

Ví dụ danh sách token:

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' \
--header 'X-SIGN: SIGNATURE' \
--data-raw '{
    "search": "BTC"
}'

Bước 4: Phản hồi

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

Tham số cốt lõi

Tham số	Ý nghĩa	Cách lấy
vsTokenId	ID token nội bộ	API Danh sách token
coinKey	ID on-chain	API Chi tiết token

Chuỗi gọi điển hình

1. Danh sách token → vsTokenId
      ↓
2. Chi tiết token → coinKey
      ↓
3. API nghiệp vụ (K-line, dòng vốn, on-chain, AI…)

Tiếp theo

• Thông tin cơ bản — quy ước chung
• Xử lý lỗi — mã trạng thái
• Từng trang API — tham số & điểm tín phí