Danh sách dòng vốn theo sector

Mô tả API

Cung cấp dữ liệu tích lũy vốn thời gian thực của tất cả loại sector 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 dữ liệu tích lũy vốn khi luân chuyển sector
• Phù hợp phát hiện sector hot hoặc sector có biến động vốn bất thường
• Phù hợp phân tích dòng vốn ở cấp ngành/sector

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/getTradeList

Đ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

Không có điều kiện tiên quyết, có thể gọi trực tiếp.

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ả
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)
tradeType	integer	integer	Loại giao dịch (1: giao ngay, 2: hợp đồng)
tag	string	string	Tên sector
tagsSimplified	string	string	Tên sector (tiếng Trung)
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
tag	Định danh sector tiếng Anh	Dùng làm tham số khi truy vấn danh sách token trong sector
tagsSimplified	Tên sector tiếng Trung	Dùng để hiển thị cho người dùng lựa chọn
categoriesTradeDataList	Dữ liệu vốn sector	Dữ liệu dòng vào ròng vốn của sector theo các độ mịn thời gian khác nhau

Ví dụ yêu cầu

{
    "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/getTradeList' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
    "tradeType": 1
}'

Ví dụ cURL (Windows CMD)

curl --location --request POST "http://${host}/api/open/v1/trade/categories/getTradeList" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{    \"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
            "tradeType": 1,                               // Loại giao dịch (1: giao ngay, 2: hợp đồng)
            "tag": "Metaverse",                            // Tên sector
            "tagsSimplified": "元宇宙",                    // Tên sector (tiếng Trung)
            "categoriesTradeDataList": [
                {
                    "timeRange": "m5",                     // Khung thời gian
                    "timeParticleEnum": 5,                 // Độ mịn thống kê thời gian
                    "tradeInflow": -167                     // Số tiền dòng vào ròng giao dịch (USD)
                },
                {
                    "timeRange": "m15",
                    "timeParticleEnum": 15,
                    "tradeInflow": 7708
                },
                {
                    "timeRange": "m30",
                    "timeParticleEnum": 30,
                    "tradeInflow": 25771
                }
                // ... bỏ qua thêm dữ liệu
            ]
        },
        {
            "updateTime": 1773298200000,
            "tradeType": 1,
            "tag": "Payments",
            "tagsSimplified": "Payments",
            "categoriesTradeDataList": [
                {
                    "timeRange": "m5",
                    "timeParticleEnum": 5,
                    "tradeInflow": 34939
                },
                {
                    "timeRange": "m15",
                    "timeParticleEnum": 15,
                    "tradeInflow": 294166
                },
                {
                    "timeRange": "m30",
                    "timeParticleEnum": 30,
                    "tradeInflow": 804896
                }
                // ... bỏ qua thêm dữ liệu
            ]
        },
        {
            "updateTime": 1773298200000,
            "tradeType": 1,
            "tag": "Yzi",
            "tagsSimplified": "Yzi",
            "categoriesTradeDataList": [
                {
                    "timeRange": "m5",
                    "timeParticleEnum": 5,
                    "tradeInflow": 28510
                },
                {
                    "timeRange": "m15",
                    "timeParticleEnum": 15,
                    "tradeInflow": 67193
                },
                {
                    "timeRange": "m30",
                    "timeParticleEnum": 30,
                    "tradeInflow": -34586
                }
                // ... bỏ qua thêm dữ liệu
            ]
        }
    ],
    "requestId": "xxx-xxx-xxx"
}