Tỷ lệ vốn / vốn hóa

Mô tả API

Cung cấp truy vấn tỷ lệ giữa vốn chủ lực thời gian thực và vốn hóa của token, hỗ trợ hai loại giao dịch giao ngay và hợp đồng.

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

• Phù hợp giám sát tỷ lệ tích lũy vốn chủ lực thời gian thực trên thị trường
• Phù hợp đánh giá cường độ dòng vốn vào và mức độ quan tâm thị trường
• Phù hợp lọc các token có mức độ quan tâm vốn cao

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

URL yêu cầu

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

Đ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 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
marketCap	number	string	Vốn hóa (USD)
spotTradeInflow	number	string	Số tiền dòng vào ròng giao dịch giao ngay (USD)
spotMarketCapRatio	double	number	Tỷ lệ vốn/vốn hóa giao ngay
contractTradeInflow	number	string	Số tiền dòng vào ròng giao dịch hợp đồng (USD)
contractMarketCapRatio	double	number	Tỷ lệ vốn/vốn hóa hợp đồng
totalTradeInflow	number	string	Số tiền dòng vào ròng giao dịch giao ngay + hợp đồng (USD)
totalMarketCapRatio	double	number	Tỷ lệ vốn/vốn hóa giao ngay + hợp đồng

Ý nghĩa nghiệp vụ

Trường	Ý nghĩa nghiệp vụ	Gợi ý sử dụng
spotMarketCapRatio	Tỷ lệ vốn/vốn hóa giao ngay	Phản ánh cường độ dòng vốn vào giao ngay; giá trị càng lớn, tỷ lệ dòng vốn vào so với vốn hóa càng cao
contractMarketCapRatio	Tỷ lệ vốn/vốn hóa hợp đồng	Phản ánh cường độ dòng vốn vào thị trường hợp đồng, dùng để đánh giá độ hot của thị trường hợp đồng
totalMarketCapRatio	Tỷ lệ vốn/vốn hóa tổng hợp	Chỉ số tổng hợp giao ngay + hợp đồng, là chỉ số cốt lõi để đánh giá mức độ quan tâm vốn tổng thể của token

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/getCoinTradeInflowMarketCapRatio' \
--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/getCoinTradeInflowMarketCapRatio" ^
--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": {
        "updateTime": 1771001700000,                    // Thời điểm cập nhật
        "vsTokenId": "1",                                // ID token
        "symbol": "BTC",                                 // Ký hiệu token
        "name": "Bitcoin",                               // Tên token
        "marketCap": "1380637213701.3374",               // Vốn hóa
        "spotTradeInflow": "6952062.183567308",          // Số tiền dòng vào ròng giao dịch giao ngay (USD)
        "spotMarketCapRatio": 5.04E-4,                   // Tỷ lệ vốn/vốn hóa giao ngay
        "contractTradeInflow": "6952062.183567308",      // Số tiền dòng vào ròng giao dịch hợp đồng (USD)
        "contractMarketCapRatio": 5.04E-4,               // Tỷ lệ vốn/vốn hóa hợp đồng
        "totalTradeInflow": "13904124.367134616",        // Số tiền dòng vào ròng giao dịch giao ngay + hợp đồng (USD)
        "totalMarketCapRatio": 0.001007                  // Tỷ lệ vốn/vốn hóa giao ngay + hợp đồng
    },
    "requestId": "xxx-xxx-xxx"
}