Xu hướng hành vi giao dịch

Mô tả API

Lấy dữ liệu thống kê giao dịch của địa chỉ chỉ định đối với token trên blockchain. Hỗ trợ truy vấn tình hình giao dịch on-chain theo khoảng thời gian bằng cách chỉ định token, tên chuỗi và khoảng thời gian.

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

Theo dõi mức độ hoạt động giao dịch của địa chỉ cụ thể
Phân tích hành vi mua/bán và tần suất 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/chain/trade/token/tradeCountTrend

Đ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

Lấy coinKey

Trường hợp	Mô tả	Cách lấy
Đã có coinKey	Dùng coinKey đã cache, không cần truy vấn lại	Tự động lấy từ ngữ cảnh
Chưa có coinKey	Gọi API `POST /vs-token/detail` để lấy coinKey của token trên các chuỗi khác nhau	Gọi API tiên quyết

Lấy address

Trường hợp	Mô tả	Cách lấy
Đã có address	Dùng địa chỉ nắm giữ đã biết	Người dùng nhập
Chưa có address	Gọi API `POST /chain/trade/token/holdPage` để truy vấn danh sách địa chỉ nắm giữ	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
coinKey	string	Có	coinKey của token (chuỗi + địa chỉ hợp đồng); lấy từ chi tiết token
address	string	Có	Địa chỉ
startTime	long	Không	Thời gian bắt đầu (timestamp mili giây)
endTime	long	Có	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)
fromCount	integer	string	Số lần chuyển ra
toCount	integer	string	Số lần chuyển vào
fromAmount	number	string	Số tiền chuyển ra
toAmount	number	string	Số tiền chuyển vào
price	number	string	Giá token

Ý nghĩa nghiệp vụ

Trường	Ý nghĩa nghiệp vụ	Gợi ý sử dụng
fromCount	Số lần giao dịch chuyển ra	Phản ánh mức độ hoạt động bán của địa chỉ
toCount	Số lần giao dịch chuyển vào	Phản ánh mức độ hoạt động mua của địa chỉ
fromAmount	Số tiền chuyển ra	Giá trị dương cho thấy vốn rời khỏi địa chỉ
toAmount	Số tiền chuyển vào	Giá trị dương cho thấy vốn chảy vào địa chỉ

Ví dụ yêu cầu

json

{
    "vsTokenId": 1,                         // ID token
    "coinKey": "BTC_BTC",                    // coinKey của token (chuỗi + địa chỉ hợp đồng); lấy từ chi tiết token
    "address": "3M219KR5vEneNb47ewrPfWyb5jQ2DjxRP6", // Địa chỉ
    "endTime": 1773479265534                  // Thời gian kết thúc
}

Ví dụ cURL (Linux/macOS)

bash

curl --location --request POST 'http://${host}/api/open/v1/chain/trade/token/tradeCountTrend' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
    "vsTokenId": 1,
    "coinKey": "BTC_BTC",
    "address": "3M219KR5vEneNb47ewrPfWyb5jQ2DjxRP6",
    "endTime": 1773479265534
}'

Ví dụ cURL (Windows CMD)

cmd

curl --location --request POST "http://${host}/api/open/v1/chain/trade/token/tradeCountTrend" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{    \"vsTokenId\": 1,    \"coinKey\": \"BTC_BTC\",    \"address\": \"3M219KR5vEneNb47ewrPfWyb5jQ2DjxRP6\",    \"endTime\": 1773479265534}"

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

json

{
    "code": 200,
    "message": "success",
    "data": [
        {
            "vsTokenId": "1",           // ID token
            "symbol": "BTC",             // Ký hiệu token
            "name": "Bitcoin",           // Tên token
            "date": 1542038400000,       // Thời gian
            "fromCount": "1",             // Số lần chuyển ra
            "toCount": "1",               // Số lần chuyển vào
            "fromAmount": "0.01",         // Số tiền chuyển ra
            "toAmount": "0.01",           // Số tiền chuyển vào
            "price": "6359.49"            // Giá token
        },
        {
            "vsTokenId": "1",
            "symbol": "BTC",
            "name": "Bitcoin",
            "date": 1542124800000,
            "fromCount": "0",
            "toCount": "1",
            "fromAmount": "0",
            "toAmount": "1",
            "price": "5738.35"
        },
        {
            "vsTokenId": "1",
            "symbol": "BTC",
            "name": "Bitcoin",
            "date": 1542211200000,
            "fromCount": "2",
            "toCount": "1",
            "fromAmount": "20001",
            "toAmount": "20000",
            "price": "5648.03"
        }
        // ... thêm dữ liệu bị lược bỏ
    ],
    "requestId": "xxx-xxx-xxx"
}

Xu hướng hành vi giao dịch ​

Mô tả API ​

URL yêu cầu ​

Điểm tín phí ​

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

Tham số yêu cầu ​

Trường phản hồi ​

Ý nghĩa nghiệp vụ ​

Ví dụ yêu cầu ​

Ví dụ cURL (Linux/macOS) ​

Ví dụ cURL (Windows CMD) ​

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