Xu hướng thay đổi chi phí chủ lực

Mô tả API

Lấy dữ liệu chi phí nắm giữ trung bình theo thời gian thực của cá voi trên các chuỗi BTC, EVM, Tron và nhiều chuỗi khác cho token.

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

• Lấy dữ liệu chi phí nắm giữ trung bình của cá voi on-chain cho token chỉ định
• Phân tích hành vi chủ lực
• Đánh giá mức độ lệch của giá hiện tại so với chi phí chủ lực

Gợi ý sử dụng:

• Khi người dùng hỏi về chi phí chủ lực bằng ngôn ngữ tự nhiên, thường dùng API này để lấy dữ liệu chi phí chủ lực on-chain
• Với truy vấn tổng hợp như phân tích chủ lực, tình hình chủ lực, cần gọi API này

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

Đ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
startTime	long	Không	Thời gian bắt đầu (timestamp mili giây)
endTime	long	Không	Thời gian kết thúc (timestamp mili giây)

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ả
vsTokenId	long	string	ID token
symbol	string	string	Ký hiệu token
name	string	string	Tên token
date	long	long	Thời gian (timestamp mili giây)
price	number	string	Giá tại thời điểm đó (USD)
cost	number	string	Chi phí chủ lực (USD)
balance	number	string	Số dư

Ý nghĩa nghiệp vụ

Trường	Ý nghĩa nghiệp vụ	Gợi ý sử dụng
cost	Chi phí nắm giữ chủ lực	Chi phí nắm giữ trung bình của chủ lực tính theo trọng số giao dịch lớn; dùng để đánh giá lãi/lỗ so với chủ lực
balance	Số dư nắm giữ chủ lực	Phản ánh thay đổi số lượng nắm giữ của cá voi; tăng liên tục cho thấy chủ lực đang tích lũy
price	Giá thị trường token	So sánh với cost để tính độ lệch giá: (price - cost) / cost * 100%

Ví dụ yêu cầu

{
    "vsTokenId": 1,           // ID token
    "startTime": 1770825600000, // Thời gian bắt đầu (timestamp)
    "endTime": 1773417600000    // Thời gian kết thúc (timestamp)
}

Ví dụ cURL (Linux/macOS)

curl --location --request POST 'http://${host}/api/open/v1/trade/getCoinTradeCost' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
    "vsTokenId": 1,
    "startTime": 1770825600000,
    "endTime": 1773417600000
}'

Ví dụ cURL (Windows CMD)

curl --location --request POST "http://${host}/api/open/v1/trade/getCoinTradeCost" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{    \"vsTokenId\": 1,    \"startTime\": 1770825600000,    \"endTime\": 1773417600000}"

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
            "date": 1770825600000,       // Thời gian
            "price": "67308.54906296561", // Giá
            "cost": "60410.667759839053903122", // Chi phí chủ lực
            "balance": "3878063.59266208"       // Số dư
        },
        {
            "vsTokenId": "1",
            "symbol": "BTC",
            "name": "Bitcoin",
            "date": 1770912000000,
            "price": "66945.34755133065",
            "cost": "60419.968721902531478833",
            "balance": "3869188.04491703"
        },
        {
            "vsTokenId": "1",
            "symbol": "BTC",
            "name": "Bitcoin",
            "date": 1770998400000,
            "price": "66945.34755133065",
            "cost": "60530.743564442072031617",
            "balance": "3879695.17965919"
        }
        // ... thêm dữ liệu bị lược bỏ
    ],
    "requestId": "xxx-xxx-xxx"
}