Danh sách token

Mô tả

Liệ kê token được ValueScan hỗ trợ, tìm kiếm mờ theo tên hoặc ký hiệu.

Tình huống: Lấy vsTokenId — tham số bắt buộc cho hầu hết API token.

Lưu ý: Nếu nhiều token trùng tên (chuỗi / tiêu chuẩn khác nhau), hãy cho người dùng chọn và cache map tên ↔ vsTokenId.

Tần suất cập nhật: Thời gian thực

Endpoint

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

Điểm tín phí

• Cost: 1

Điều kiện tiên quyết

Không.

Body (JSON)

Trường	Kiểu	Bắt buộc	Mô tả
search	string	Không	Từ khóa (ký hiệu), fuzzy, tối đa 100 ký tự, không phân biệt hoa thường

Phản hồi — data[]

Trường	Kiểu	Serialize	Mô tả
id	long	long	Token id (vsTokenId)
symbol	string	string	Ký hiệu (vd. BTC)
name	string	string	Tên đầy đủ (vd. Bitcoin)

Ngữ nghĩa

Trường	Ý nghĩa	Gợi ý
id	Định danh chuẩn	Chính là vsTokenId — nên cache
symbol	Hiển thị
name	Phân biệt	Khi trùng symbol

Ví dụ

{
    "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\"}"

Mẫu thành công

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