Bắt đầu nhanh

Quy trình tích hợp

Bước 1: Lấy API key

Trong Console, lấy API key của bạn.

Bước 2: Xác nhận URL cơ sở

Loại	URL cơ sở
Endpoint truy vấn API	https://api.valuescan.io/api
Endpoint push SSE	https://stream.valuescan.ai
Endpoint push WebSocket	wss://stream.valuescan.ai

Bước 3: Gửi yêu cầu đầu tiên

Ví dụ với endpoint Danh sách token:

Ví dụ yêu cầu

{
    "search": "BTC"
}

Ví dụ cURL

curl --location --request POST 'https://api.valuescan.io/api/open/v1/vs-token/list' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: api-key-cua-ban' \
--header 'X-TIMESTAMP: timestamp-mili-giay' \
--header 'X-SIGN: chu-ky' \
--data-raw '{
    "search": "BTC"
}'

Bước 4: Xử lý 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ố	Mô tả	Cách lấy
vsTokenId	Định danh token duy nhất	Qua endpoint Danh sách token
coinKey	Định danh token on-chain	Qua endpoint Thông tin token

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

1. Danh sách token → lấy vsTokenId
      ↓
2. Thông tin token → lấy chi tiết token và coinKey
      ↓
3. Endpoint nghiệp vụ → gọi API dữ liệu cụ thể (nến, vốn, on-chain, v.v.)

Bước tiếp theo

• Đọc Thông tin cơ bản để nắm quy ước API đầy đủ
• Đọc Xử lý lỗi để biết định nghĩa mã lỗi
• Xem tài liệu từng endpoint để biết tham số chi tiết