Thông tin cơ bản token
Mô tả API
Lấy thông tin cơ bản của token chỉ định, bao gồm thông tin thị trường, thông tin cơ bản on-chain và thông tin giá.
Tình huống sử dụng:
- Tra cứu thông tin chung về token
- Lấy thông tin đầy đủ về token, bao gồm giá, vốn hóa, nguồn cung, v.v.
- Lấy
coinKey(tham số bắt buộc khi gọi API dữ liệu on-chain)
Lưu ý quan trọng: Mảng chainAddresses chứa coinKey của token trên từng blockchain. Để truy vấn địa chỉ nắm giữ on-chain, xu hướng số dư, v.v., cần cho người dùng chọn chuỗi mục tiêu và cache coinKey tương ứng.
Tần suất cập nhật dữ liệu: Cập nhật thời gian thực
URL yêu cầu
- Phương thức:
POST - Đường dẫn:
/open/v1/vs-token/detail
Điểm tín phí
- Điểm tín phí mỗi lần gọi:
1
Điều kiện tiên quyết
Lấy vsTokenId
| Điều kiện | Mô tả | Cách lấy |
|---|---|---|
| Đã có vsTokenId | Dùng vsTokenId đã cache, không cần truy vấn lại | Tự động trích xuất từ ngữ cảnh |
| Chưa có vsTokenId | Gọi API POST /vs-token/list | Gọi API tiên quyết |
Tham số yêu cầu
Tham số gửi trong body dạng JSON.
| Tên tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
| vsTokenId | long | Có | ID token |
Trường phản hồi
Chỉ liệt kê cấu trúc trường trong object data:
| Trường | Kiểu | Kiểu thực tế trả về | Mô tả |
|---|---|---|---|
| vsTokenId | long | string | ID token |
| name | string | string | Tên token |
| symbol | string | string | Ký hiệu token |
| icon | string | string | URL biểu tượng token |
| oldSymbol | string | string | symbol trước khi đổi tên |
| price | number | string | Giá hiện tại (USD) |
| highPrice | number | string | Giá cao nhất lịch sử (USD) |
| lowPrice | number | string | Giá thấp nhất lịch sử (USD) |
| marketCapDominance | number | string | Tỷ trọng vốn hóa (%) |
| volume24h | number | string | Khối lượng 24H (USD) |
| volumeChange24h | number | string | Tỷ lệ thay đổi khối lượng 24H (%) |
| percentChange1h | number | string | Biến động giá 1 giờ (%) |
| percentChange24h | number | string | Biến động giá 24 giờ (%) |
| percentChange7d | number | string | Biến động giá 7 ngày (%) |
| percentChange30d | number | string | Biến động giá 30 ngày (%) |
| percentChange60d | number | string | Biến động giá 60 ngày (%) |
| percentChange90d | number | string | Biến động giá 90 ngày (%) |
| marketCap | number | string | Vốn hóa (USD) |
| totalSupply | number | string | Tổng nguồn cung |
| circulationSupply | number | string | Lượng lưu hành |
| maxSupply | number | string | Nguồn cung tối đa |
| cost | number | string | Chi phí nắm giữ on-chain (USD) |
| chainAddresses | array | array | Thông tin từng chuỗi |
| contractAddress | string | string | Địa chỉ hợp đồng |
| chainName | string | string | Tên chuỗi |
| holderCount | integer | string | Số địa chỉ nắm giữ |
| transCount | integer | string | Số giao dịch |
| issueDate | long | long | Thời gian phát hành (timestamp ms) |
| precision | string | string | Độ chính xác |
| totalSupply | string | string | Nguồn cung trên chuỗi này |
| coinKey | string | string | Định danh token on-chain (quan trọng) |
Ý nghĩa nghiệp vụ
| Trường | Ý nghĩa nghiệp vụ | Gợi ý sử dụng |
|---|---|---|
| coinKey | Định danh duy nhất token on-chain | Tham số bắt buộc khi gọi API on-chain (địa chỉ nắm giữ, xu hướng số dư, v.v.); định dạng tên_chuỗi_địa_chỉ_hợp_đồng, ví dụ BTC_BTC, eth_0x... |
| chainAddresses | Danh sách đa chuỗi | Cùng token có thể phát hành trên nhiều chuỗi; cần cho người dùng chọn chuỗi mục tiêu và cache coinKey tương ứng |
| cost | Chi phí cá mập on-chain | Chi phí nắm giữ trung bình tính từ giao dịch lớn on-chain |
| icon | URL biểu tượng token | Hiển thị biểu tượng token trên giao diện |
Ví dụ yêu cầu
json
{
"vsTokenId": 1 // ID token
}Ví dụ cURL (Linux/macOS)
bash
curl --location --request POST 'http://${host}/api/open/v1/vs-token/detail' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
"vsTokenId": 1
}'Ví dụ cURL (Windows CMD)
cmd
curl --location --request POST "http://${host}/api/open/v1/vs-token/detail" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{ \"vsTokenId\": 1}"Ví dụ phản hồi thành công
json
{
"code": 200,
"message": "success",
"data": {
"vsTokenId": "1", // ID token
"name": "Bitcoin", // Tên token
"symbol": "BTC", // symbol
"icon": "https://static.valuescan.io/valuescan/cmc/coins/1.png", // Biểu tượng token
"oldSymbol": "", // symbol trước khi đổi tên
"price": "70559.18", // Giá
"highPrice": "126198.06960343386", // Giá cao nhất
"lowPrice": "0.04864654", // Giá thấp nhất
"marketCapDominance": "", // Tỷ trọng vốn hóa
"volume24h": "54389029990.497185", // Khối lượng 24H
"volumeChange24h": "15.6056", // Thay đổi khối lượng 24H
"percentChange1h": "-0.09167097", // Biến động giá 1 giờ
"percentChange24h": "-1.29235993", // Biến động giá 24 giờ
"percentChange7d": "3.96301796", // Biến động giá 7 ngày
"percentChange30d": "5.35405481", // Biến động giá 30 ngày
"percentChange60d": "-23.17390208", // Biến động giá 60 ngày
"percentChange90d": "-21.71414845", // Biến động giá 90 ngày
"marketCap": "1412725749093.2734", // Vốn hóa
"totalSupply": "20001887", // Tổng nguồn cung
"circulationSupply": "20001887", // Lượng lưu hành
"maxSupply": "21000000", // Nguồn cung tối đa
"cost": "60515.829728843657394618", // Chi phí nắm giữ on-chain
"chainAddresses": [
{
"contractAddress": "BTC", // Địa chỉ hợp đồng
"chainName": "BTC", // Tên chuỗi
"holderCount": "55905596", // Số địa chỉ
"transCount": "1322741358", // Số giao dịch
"issueDate": 1230998400000, // Thời gian phát hành
"precision": "8", // Độ chính xác
"totalSupply": "20001892", // Nguồn cung
"coinKey": "BTC_BTC" // coinKey
}
]
},
"requestId": "xxx-xxx-xxx"
}