Địa chỉ nắm giữ token
Mô tả API
Lấy danh sách địa chỉ nắm giữ on-chain và thông tin cơ bản của địa chỉ cho token chỉ định. Đồng thời hỗ trợ truy vấn thông tin cơ bản của một địa chỉ cụ thể.
Tình huống sử dụng:
- Theo dõi và phân tích thông tin on-chain của cá voi, dự án, sàn giao dịch, v.v.
- Nhận diện hành vi nắm giữ của cá voi và phân tích quyền sở hữu địa chỉ
- Nghiên cứu phân bổ nắm giữ on-chain và mức độ tập trung token
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/chain/trade/token/holdPage
Điểm tín phí
- Điểm tín phí mỗi lần gọi:
2
Điều kiện tiên quyết
Lấy vsTokenId
| Trường hợp | Mô tả | Cách lấy |
|---|---|---|
| Đã có vsTokenId | Dùng vsTokenId đã cache, không cần truy vấn lại | Tự động lấy từ ngữ cảnh |
| Chưa có vsTokenId | Gọi API POST /vs-token/list để lấy | Gọi API tiên quyết |
Lấy coinKey
| Trường hợp | Mô tả | Cách lấy |
|---|---|---|
| Đã có coinKey | Dùng coinKey đã cache, không cần truy vấn lại | Tự động lấy từ ngữ cảnh |
| Chưa có coinKey | Gọi API POST /vs-token/detail để lấy coinKey của token trên các chuỗi khác nhau | 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 |
| page | integer | Có | Trang hiện tại; mặc định 1 |
| pageSize | integer | Có | Số bản ghi mỗi trang; mặc định 10, tối đa 10.000 bản ghi |
| coinKey | string | Có | Thông tin coinKey của token (chuỗi + địa chỉ hợp đồng); lấy từ chi tiết token |
| address | string | Không | Địa chỉ |
Trường phản hồi
Chỉ liệt kê cấu trúc trường của từng phần tử trong mảng data:
| Trường | Kiểu | Kiểu thực tế trả về | Mô tả |
|---|---|---|---|
| vsTokenId | long | string | ID token |
| symbol | string | string | Ký hiệu token |
| name | string | string | Tên token |
| coinKey | string | string | Khóa token |
| address | string | string | Địa chỉ |
| label | object | object | Nhãn địa chỉ |
| labelName | string | string | Tên nhãn |
| iconUrl | string | string | URL biểu tượng |
| isContract | boolean | boolean | Có phải địa chỉ hợp đồng |
| exchangeSymbol | string | string | Tên sàn giao dịch |
| labelType | string | string | Loại |
| reliability | integer | integer | Độ tin cậy |
| balance | number | string | Số dư |
| price | number | string | Giá |
| profit | number | string | Lợi nhuận |
| cost | number | string | Chi phí nắm giữ |
| preCost | number | string | Chi phí nắm giữ lần trước |
| chainName | string | string | Tên chuỗi |
Ý nghĩa nghiệp vụ
| Trường | Ý nghĩa nghiệp vụ | Gợi ý sử dụng |
|---|---|---|
| label | Nhãn địa chỉ | Xác định quyền sở hữu địa chỉ (ví dụ sàn giao dịch, hợp đồng); giúp nhận diện danh tính cá voi |
| profit | Lợi nhuận nắm giữ | Lãi/lỗ thả nổi tính theo giá hiện tại và chi phí nắm giữ |
| cost | Chi phí nắm giữ | Giá mua trung bình của token tại địa chỉ này |
Ví dụ yêu cầu
json
{
"vsTokenId": 1, // ID token
"page": 1, // Trang hiện tại; mặc định 1
"pageSize": 10, // Số bản ghi mỗi trang; mặc định 10, tối đa 10.000 bản ghi
"coinKey": "BTC_BTC" // Thông tin coinKey của token (chuỗi + địa chỉ hợp đồng); lấy từ chi tiết token
}Ví dụ cURL (Linux/macOS)
bash
curl --location --request POST 'http://${host}/api/open/v1/chain/trade/token/holdPage' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
"vsTokenId": 1,
"page": 1,
"pageSize": 10,
"coinKey": "BTC_BTC"
}'Ví dụ cURL (Windows CMD)
cmd
curl --location --request POST "http://${host}/api/open/v1/chain/trade/token/holdPage" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{ \"vsTokenId\": 1, \"page\": 1, \"pageSize\": 10, \"coinKey\": \"BTC_BTC\"}"Ví dụ phản hồi thành công
json
{
"code": 200,
"message": "success",
"data": [
{
"vsTokenId": "1", // ID token
"symbol": "BTC", // Ký hiệu token
"name": "Bitcoin", // Tên token
"coinKey": "BTC_BTC", // Khóa token
"address": "34xp4vRoCGJym3xR7yCVPFHoCNxv4Twseo", // Địa chỉ
"label": { // Nhãn địa chỉ
"labelName": "Binance Cold Wallet", // Tên nhãn
"iconUrl": "/icon/label/Binance.png", // URL biểu tượng
"isContract": false, // Có phải địa chỉ hợp đồng
"exchangeSymbol": "", // Tên sàn giao dịch
"labelType": "Exchange", // Loại
"reliability": "" // Độ tin cậy
},
"balance": "248597.58214169", // Số dư
"price": "70624.85790154382", // Giá
"profit": "7913271920.4341697967652188545", // Lợi nhuận
"cost": "38828.441617175034708941", // Chi phí nắm giữ
"preCost": "38828.441617175034708941", // Chi phí nắm giữ lần trước
"chainName": "BTC" // Tên chuỗi
},
{
"vsTokenId": "1",
"symbol": "BTC",
"name": "Bitcoin",
"coinKey": "BTC_BTC",
"address": "3M219KR5vEneNb47ewrPfWyb5jQ2DjxRP6",
"label": {
"labelName": "Binance Cold Wallet",
"iconUrl": "/icon/label/Binance.png",
"isContract": false,
"exchangeSymbol": "",
"labelType": "Exchange",
"reliability": ""
},
"balance": "156026.54705644",
"price": "70624.85790154382",
"profit": "1804396311.20359371149441240088",
"cost": "59095.423712405135733623",
"preCost": "59095.423712405135733623",
"chainName": "BTC"
},
{
"vsTokenId": "1",
"symbol": "BTC",
"name": "Bitcoin",
"coinKey": "BTC_BTC",
"address": "bc1ql49ydapnjafl5t2cp9zqpjwe6pdgmxy98859v2",
"label": {
"labelName": "Robinhood Cold",
"iconUrl": "/icon/default.png",
"isContract": false,
"exchangeSymbol": "",
"labelType": "",
"reliability": ""
},
"balance": "140574.82614005",
"price": "70624.85790154382",
"profit": "5416163383.0562816957331038294",
"cost": "32131.412397458211476123",
"preCost": "32131.412397458211476123",
"chainName": "BTC"
}
// ... thêm dữ liệu bị lược bỏ
],
"requestId": "xxx-xxx-xxx"
}