Dòng vốn token theo sector

Mô tả API

Lấy dữ liệu tích lũy vốn thời gian thực của tất cả token trong sector chỉ định, cho giao ngay hoặc hợp đồng trên các cửa sổ thời gian khác nhau.

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

• Phù hợp giám sát tình hình vốn của các token trong sector khi theo dõi luân chuyển sector
• Phù hợp phát hiện token dẫn dắt hoặc token biến động bất thường trong sector
• Phù hợp phân tích vốn cho chiến lược đầu tư theo chủ đề ngành

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/categories/CoinTradeList

Điểm tín phí

• Điểm tín phí mỗi lần gọi: 3

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

Lấy tag

Trường hợp	Mô tả	Cách lấy
Đã có tag	Dùng nhãn sector đã cache, không cần truy vấn lại	Tự động từ ngữ cảnh
Chưa có tag	Gọi API POST /open/v1/trade/categories/getTradeList để lấy tất cả sector và tag	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ả
tag	string	Có	Nhãn phân loại
tradeType	integer	Có	Loại giao dịch (1: giao ngay, 2: hợp đồng)

Giải thích giá trị liệt kê

tradeType — Loại giao dịch

Giá trị	Ý nghĩa
1	Giao ngay
2	Hợp đồng

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ả
updateTime	long	long	Thời điểm cập nhật (timestamp ms)
tag	string	string	Nhãn sector
tradeType	integer	integer	Loại giao dịch (1: giao ngay, 2: hợp đồng)
vsTokenId	long	string	ID token
symbol	string	string	Ký hiệu token
name	string	string	Tên token
categoriesTradeDataList	array	array	Danh sách dữ liệu vốn sector
timeRange	string	string	Khung thời gian
timeParticleEnum	integer	integer	Độ mịn thống kê thời gian
tradeInflow	number	number	Số tiền dòng vào ròng giao dịch (USD)

Ý nghĩa nghiệp vụ

Trường	Ý nghĩa nghiệp vụ	Gợi ý sử dụng
categoriesTradeDataList	Dữ liệu vốn sector	Dữ liệu dòng vào ròng vốn của token theo các độ mịn thời gian khác nhau, dùng để phân tích dòng vốn trong sector
tradeInflow	Dòng vào ròng giao dịch	Giá trị dương biểu thị dòng vốn vào, giá trị âm biểu thị dòng vốn ra

Ví dụ yêu cầu

{
    "tag": "AI",          // Nhãn phân loại
    "tradeType": 1        // Loại giao dịch (1: giao ngay, 2: hợp đồng)
}

Ví dụ cURL (Linux/macOS)

curl --location --request POST 'http://${host}/api/open/v1/trade/categories/CoinTradeList' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
    "tag": "AI",
    "tradeType": 1
}'

Ví dụ cURL (Windows CMD)

curl --location --request POST "http://${host}/api/open/v1/trade/categories/CoinTradeList" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{    \"tag\": \"AI\",    \"tradeType\": 1}"

Ví dụ phản hồi thành công

{
    "code": 200,
    "message": "success",
    "data": [
        {
            "updateTime": 1773298200000,                 // Thời điểm cập nhật
            "tag": "AI",                                  // Nhãn sector
            "tradeType": 1,                               // Loại giao dịch (1: giao ngay, 2: hợp đồng)
            "vsTokenId": "1637",                          // ID token
            "symbol": "RLC",                              // Ký hiệu token
            "name": "iExec RLC",                         // Tên token
            "categoriesTradeDataList": [
                {
                    "timeRange": "H6",                    // Khung thời gian
                    "timeParticleEnum": 106,              // Độ mịn thống kê thời gian
                    "tradeInflow": "3753.6444"            // Số tiền dòng vào ròng giao dịch (USD)
                },
                {
                    "timeRange": "M3",
                    "timeParticleEnum": 303,
                    "tradeInflow": "-716516.5178999999"
                },
                {
                    "timeRange": "D90",
                    "timeParticleEnum": 290,
                    "tradeInflow": "-716516.5179"
                }
                // ... bỏ qua thêm dữ liệu
            ]
        },
        {
            "updateTime": 1773298200000,
            "tag": "AI",
            "tradeType": 1,
            "vsTokenId": "1732",
            "symbol": "NMR",
            "name": "Numeraire",
            "categoriesTradeDataList": [
                {
                    "timeRange": "H6",
                    "timeParticleEnum": 106,
                    "tradeInflow": "-1088.4043000000013"
                },
                {
                    "timeRange": "M3",
                    "timeParticleEnum": 303,
                    "tradeInflow": "2671317.5315"
                },
                {
                    "timeRange": "D90",
                    "timeParticleEnum": 290,
                    "tradeInflow": "2671317.5314999996"
                }
                // ... bỏ qua thêm dữ liệu
            ]
        },
        {
            "updateTime": 1773298200000,
            "tag": "AI",
            "tradeType": 1,
            "vsTokenId": "1768",
            "symbol": "ADX",
            "name": "AdEx",
            "categoriesTradeDataList": [
                {
                    "timeRange": "H6",
                    "timeParticleEnum": 106,
                    "tradeInflow": "-11146.473400000003"
                },
                {
                    "timeRange": "M3",
                    "timeParticleEnum": 303,
                    "tradeInflow": "303446.2417000001"
                },
                {
                    "timeRange": "D90",
                    "timeParticleEnum": 290,
                    "tradeInflow": "303446.2417"
                }
                // ... bỏ qua thêm dữ liệu
            ]
        }
    ],
    "requestId": "xxx-xxx-xxx"
}