Tích lũy vốn thời gian thực
Mô tả API
Lấy dữ liệu vốn thời gian thực (tức dữ liệu dòng vào ròng thời gian thực) do giao dịch token trên sàn giao dịch tập trung tạo ra, cùng dữ liệu tích lũy vốn chủ lực trong ngày, bao gồm giao dịch giao ngay và hợp đồng của token.
Tình huống sử dụng:
- Phù hợp giám sát tình hình tích lũy vốn trong các cửa sổ thời gian khác nhau tại các thời điểm khác nhau trong ngày
- Phù hợp theo dõi hành vi vốn chủ lực
Gợi ý sử dụng:
- Khi truy vấn vốn chủ lực trong ngày, xem giá trị dòng vào ròng lớn nhất trong 24h (giờ); khi truy vấn vốn chủ lực, xem giá trị dòng vào ròng lớn nhất trong 90d (ngày).
- Dòng vào ròng dương biểu thị chủ lực mua vào, thuận lợi. Dòng vào ròng âm biểu thị chủ lực bán ra, bất lợi.
- Khi truy vấn bằng ngôn ngữ tự nhiên về vốn chủ lực (chưa chỉ định loại giao dịch), cần cung cấp dữ liệu vốn cả giao ngay và hợp đồng.
- Khi truy vấn bằng ngôn ngữ tự nhiên về phân tích chủ lực, tình hình chủ lực, v.v., cần gọi API này.
Tần suất cập nhật dữ liệu: Cập nhật mỗi 5 phút
URL yêu cầu
- Phương thức:
POST - Đường dẫn:
/open/v1/trade/getCoinTrade
Điểm tín phí
- Điểm tín phí mỗi lần gọi:
4
Đ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 từ ngữ cảnh |
| Chưa có vsTokenId | Gọi API POST /vs-token/list để lấy | 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 đối tượng data:
| Trường | Kiểu | Kiểu thực tế trả về | Mô tả |
|---|---|---|---|
| updateTime | long | long | Thời điểm cập nhật (timestamp ms) |
| vsTokenId | long | string | ID token |
| symbol | string | string | Ký hiệu token |
| name | string | string | Tên token |
| coinPrice | number | string | Giá token (USD) |
| marketCap | number | string | Vốn hóa (USD) |
| hasSpotGoods | boolean | boolean | Có dữ liệu giao ngay hay không |
| spotMaxInflow | number | number | Tích lũy vốn chủ lực giao ngay (USD) |
| spotGoodsList | array | array | Danh sách dữ liệu giao ngay |
| timeRange | string | string | Khung thời gian |
| timeParticleEnum | integer | integer | Độ mịn thống kê thời gian |
| tradeInflow | number | string | Số tiền dòng vào ròng giao dịch (USD) |
| tradeAmount | number | string | Khối lượng giao dịch (USD) |
| tradeInflowChange | double | number | Tỷ lệ thay đổi dòng vào ròng |
| tradeOut | number | string | Số tiền dòng ra giao dịch (USD) |
| tradeIn | number | string | Số tiền dòng vào giao dịch (USD) |
| hasContract | boolean | boolean | Có dữ liệu hợp đồng hay không |
| contractMaxInflow | number | number | Tích lũy vốn chủ lực hợp đồng (USD) |
| contractList | array | array | Danh sách dữ liệu hợp đồng |
| timeRange | string | string | Khung thời gian |
| timeParticleEnum | integer | integer | Độ mịn thống kê thời gian |
| tradeInflow | number | string | Số tiền dòng vào ròng giao dịch (USD) |
| tradeAmount | number | string | Khối lượng giao dịch (USD) |
| tradeInflowChange | double | number | Tỷ lệ thay đổi dòng vào ròng |
| tradeOut | number | string | Số tiền dòng ra giao dịch (USD) |
| tradeIn | number | string | Số tiền dòng vào giao dịch (USD) |
Ý nghĩa nghiệp vụ
| Trường | Ý nghĩa nghiệp vụ | Gợi ý sử dụng |
|---|---|---|
| spotMaxInflow | Tích lũy chủ lực giao ngay | Vốn chủ lực giao ngay là giá trị dòng vào ròng lớn nhất trong các cửa sổ thời gian giao dịch giao ngay trong 90d (ngày) |
| contractMaxInflow | Tích lũy chủ lực hợp đồng | Vốn chủ lực hợp đồng là giá trị dòng vào ròng lớn nhất trong các cửa sổ thời gian giao dịch hợp đồng trong 90d (ngày) |
| hasSpotGoods | Cờ dữ liệu giao ngay | true nghĩa là có dữ liệu giao ngay, false nghĩa là không có; khi không yêu cầu thời gian cụ thể, mặc định trả về toàn bộ chu kỳ thời gian trong 90d |
| hasContract | Cờ dữ liệu hợp đồng | true nghĩa là có dữ liệu hợp đồng, false nghĩa là không có; khi không yêu cầu thời gian cụ thể, mặc định trả về toàn bộ chu kỳ thời gian trong 90d |
| tradeInflowChange | Tỷ lệ thay đổi dòng vào ròng | So sánh vốn của chu kỳ thời gian hiện tại với chu kỳ thời gian trước đó |
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/trade/getCoinTrade' \
--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/trade/getCoinTrade" ^
--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": {
"updateTime": 1773220800000, // Thời điểm cập nhật
"vsTokenId": "1", // ID token
"symbol": "BTC", // Ký hiệu token
"name": "Bitcoin", // Tên token
"coinPrice": "70559.18", // Giá token (USD)
"marketCap": "1412725749093.2734", // Vốn hóa (USD)
"hasSpotGoods": true, // Có dữ liệu giao ngay hay không
"spotMaxInflow": 2588472.3329447997, // Tích lũy vốn chủ lực giao ngay (USD)
"spotGoodsList": [
{
"timeRange": "5m", // Khung thời gian
"timeParticleEnum": 5, // Độ mịn thống kê thời gian
"tradeInflow": "1914106.2828805007", // Số tiền dòng vào ròng giao dịch (USD)
"tradeAmount": "4389778.5824913", // Khối lượng giao dịch (USD)
"tradeInflowChange": 373.39, // Tỷ lệ thay đổi dòng vào ròng
"tradeOut": "2475814.5678", // Số tiền dòng ra giao dịch (USD)
"tradeIn": "4389920.8506" // Số tiền dòng vào giao dịch (USD)
},
{
"timeRange": "15m", // Khung thời gian
"timeParticleEnum": 15, // Độ mịn thống kê thời gian
"tradeInflow": "2588472.3329447997", // Số tiền dòng vào ròng giao dịch (USD)
"tradeAmount": "8590968.535904001", // Khối lượng giao dịch (USD)
"tradeInflowChange": 2.06, // Tỷ lệ thay đổi dòng vào ròng
"tradeOut": "6002496.2029", // Số tiền dòng ra giao dịch (USD)
"tradeIn": "8590968.5359" // Số tiền dòng vào giao dịch (USD)
},
{
"timeRange": "30m", // Khung thời gian
"timeParticleEnum": 30, // Độ mịn thống kê thời gian
"tradeInflow": "137283.75568691065", // Số tiền dòng vào ròng giao dịch (USD)
"tradeAmount": "33263896.482198115", // Khối lượng giao dịch (USD)
"tradeInflowChange": -0.95, // Tỷ lệ thay đổi dòng vào ròng
"tradeOut": "33126612.7265", // Số tiền dòng ra giao dịch (USD)
"tradeIn": "33263896.4822" // Số tiền dòng vào giao dịch (USD)
}
// ... bỏ qua thêm dữ liệu
],
"hasContract": true, // Có dữ liệu hợp đồng hay không
"contractMaxInflow": 17609356.027199995, // Tích lũy vốn chủ lực hợp đồng (USD)
"contractList": [
{
"timeRange": "5m", // Khung thời gian
"timeParticleEnum": 5, // Độ mịn thống kê thời gian
"tradeInflow": "9098861.077599995", // Số tiền dòng vào ròng giao dịch (USD)
"tradeAmount": "32832991.129399996", // Khối lượng giao dịch (USD)
"tradeInflowChange": 3.18, // Tỷ lệ thay đổi dòng vào ròng
"tradeOut": "23734130.0518", // Số tiền dòng ra giao dịch (USD)
"tradeIn": "32832991.1294" // Số tiền dòng vào giao dịch (USD)
},
{
"timeRange": "15m", // Khung thời gian
"timeParticleEnum": 15, // Độ mịn thống kê thời gian
"tradeInflow": "13098330.522699993", // Số tiền dòng vào ròng giao dịch (USD)
"tradeAmount": "72156543.4141", // Khối lượng giao dịch (USD)
"tradeInflowChange": 1.9, // Tỷ lệ thay đổi dòng vào ròng
"tradeOut": "59058212.8914", // Số tiền dòng ra giao dịch (USD)
"tradeIn": "72156543.4141" // Số tiền dòng vào giao dịch (USD)
},
{
"timeRange": "30m", // Khung thời gian
"timeParticleEnum": 30, // Độ mịn thống kê thời gian
"tradeInflow": "17609356.027199995", // Số tiền dòng vào ròng giao dịch (USD)
"tradeAmount": "162089903.7944", // Khối lượng giao dịch (USD)
"tradeInflowChange": 3.33, // Tỷ lệ thay đổi dòng vào ròng
"tradeOut": "144480547.7672", // Số tiền dòng ra giao dịch (USD)
"tradeIn": "162089903.7944" // Số tiền dòng vào giao dịch (USD)
}
// ... bỏ qua thêm dữ liệu
]
},
"requestId": "xxx-xxx-xxx"
}