Luồng token

Mô tả API

Lấy dữ liệu dòng vốn vào/ra và tỷ lệ thay đổi giữa địa chỉ nắm giữ on-chain và sàn giao dịch tập trung (CEX) của token.

Tình huống sử dụng:

• Đánh giá tâm lý thị trường và xu hướng dòng vốn
• Phân tích tương tác giữa vốn on-chain và vốn trên sàn giao dịch

Tần suất cập nhật dữ liệu: Cập nhật một lần mỗi ngày

URL yêu cầu

• Phương thức: POST
• Đường dẫn: /open/v1/trade/getCoinTradeFlow

Đ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

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ả
vsTokenId	long	string	ID token
symbol	string	string	Ký hiệu token
name	string	string	Tên token
coinTradeFlowDataV1Vos	array	array	Danh sách dữ liệu sàn giao dịch
timeRange	string	string	Khoảng thời gian
timeParticleEnum	integer	integer	Độ chi tiết thời gian thống kê
tradeIn	number	string	Số tiền dòng vào giao dịch (USD)
tradeOut	number	string	Số tiền dòng ra giao dịch (USD)
tradeInNumber	number	string	Số lượng dòng vào giao dịch
tradeOutNumber	number	string	Số lượng dòng ra giao dịch
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	number	number	Tỷ lệ thay đổi dòng vào ròng

Ý nghĩa nghiệp vụ

Trường	Ý nghĩa nghiệp vụ	Gợi ý sử dụng
tradeInflow	Dòng vào ròng giao dịch	Giá trị dương: vốn chảy vào sàn (giảm giá); giá trị âm: vốn chảy ra sàn (tăng giá)
tradeInflowChange	Tỷ lệ thay đổi dòng vào ròng	Phản ánh tốc độ dòng vào tăng/giảm; dương tăng tốc dòng vào, âm tăng tốc dòng ra

Ví dụ yêu cầu

{
    "vsTokenId": 1   // ID token
}

Ví dụ cURL (Linux/macOS)

curl --location --request POST 'http://${host}/api/open/v1/trade/getCoinTradeFlow' \
--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)

curl --location --request POST "http://${host}/api/open/v1/trade/getCoinTradeFlow" ^
--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

{
    "code": 200,
    "message": "success",
    "data": {
        "vsTokenId": "1",                                 // ID token
        "symbol": "BTC",                                  // Ký hiệu token
        "name": "Bitcoin",                                // Tên token
        "coinTradeFlowDataV1Vos": [
            {
                "timeRange": "H1",                         // Khoảng thời gian
                "timeParticleEnum": 101,                   // Độ chi tiết thời gian thống kê
                "tradeIn": "18287486.3421524716",          // Số tiền dòng vào giao dịch (USD)
                "tradeOut": "20431186.0069537593",         // Số tiền dòng ra giao dịch (USD)
                "tradeInNumber": "261.06338392",           // Số lượng dòng vào giao dịch
                "tradeOutNumber": "292.2527353",           // Số lượng dòng ra giao dịch
                "tradeInflow": "-2143699.6648012877",      // Số tiền dòng vào ròng giao dịch (USD)
                "tradeAmount": "38718672.3491062309",      // Khối lượng giao dịch (USD)
                "tradeInflowChange": -1.0504178361         // Tỷ lệ thay đổi dòng vào ròng
            },
            {
                "timeRange": "H2",
                "timeParticleEnum": 102,
                "tradeIn": "65441054.6086384475",
                "tradeOut": "25066077.7308015143",
                "tradeInNumber": "935.91343814",
                "tradeOutNumber": "358.55940114",
                "tradeInflow": "40374976.8778369332",
                "tradeAmount": "90507132.3394399618",
                "tradeInflowChange": -0.0011861865
            },
            {
                "timeRange": "H4",
                "timeParticleEnum": 104,
                "tradeIn": "142822570.5758415342",
                "tradeOut": "62024667.6912203477",
                "tradeInNumber": "2047.31953966",
                "tradeOutNumber": "889.23850568",
                "tradeInflow": "80797902.8846211865",
                "tradeAmount": "204847238.2670618819",
                "tradeInflowChange": 0.4744189803
            }
            // ... thêm dữ liệu bị lược bỏ
        ]
    },
    "requestId": "xxx-xxx-xxx"
}