Giao dịch lớn

Mô tả API

Lấy dữ liệu giao dịch lớn của token chỉ định trên hơn 20 chuỗi công khai chính, bao gồm chuỗi BTC, EVM và Tron.

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

Giám sát và phân tích giao dịch lớn hoặc dòng giao dịch bất thường on-chain
Giám sát chuyển khoản lớn giữa địa chỉ cá voi và sàn giao dịch
Theo dõi động thái cá voi và cảnh báo biến động thị trường

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

Đ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
page	integer	Không	Trang hiện tại; mặc định 1
pageSize	integer	Không	Số bản ghi mỗi trang; mặc định 10, tối đa 100

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
blockNumber	long	long	Chiều cao khối
transIndex	integer	integer	Chỉ số giao dịch trong khối
coinKey	string	string	Mã coin
transHash	string	string	Hash giao dịch
fromAddress	string	string	Địa chỉ gửi
fromExchangeName	string	string	Nhãn bên gửi
toAddress	string	string	Địa chỉ nhận
toExchangeName	string	string	Nhãn bên nhận
amount	number	string	Số tiền giao dịch
blockTime	long	long	Thời gian khối (timestamp mili giây)
coinInfo	object	object	Thông tin token
coinKey	string	string	Mã coin
coinName	string	string	Tên coin
symbol	string	string	Ký hiệu coin
protocol	string	string	Giao thức
contractAddress	string	string	Địa chỉ hợp đồng
chainName	string	string	Tên chuỗi
icon	string	string	URL biểu tượng
price	number	string	Giá
addressInfo	object	object	Thông tin địa chỉ
address	string	string	Địa chỉ
label	object	object	Nhãn
labelName	string	string	Tên nhãn
iconUrl	string	string	URL biểu tượng
isContract	boolean	boolean	Có phải địa chỉ hợp đồng
exchangeSymbol	string	string	Tên sàn giao dịch
labelType	string	string	Loại
reliability	integer	integer	Độ tin cậy
nativeLabelName	string	string	Tên nhãn gốc
balance	number	string	Số dư
profit	number	string	Lợi nhuận
exchangeInfo	object	object	Thông tin sàn giao dịch
address	string	string	Địa chỉ
name	string	string	Tên
icon	string	string	Biểu tượng
label	object	object	Nhãn
labelName	string	string	Tên nhãn
iconUrl	string	string	URL biểu tượng
isContract	boolean	boolean	Có phải địa chỉ hợp đồng
exchangeSymbol	string	string	Tên sàn giao dịch
labelType	string	string	Loại
reliability	integer	integer	Độ tin cậy
nativeLabelName	string	string	Tên nhãn gốc
addresses	array	array	Danh sách địa chỉ
amount	number	string	Số tiền
exchangeCount	integer	integer	Số lượng sàn giao dịch

Ý nghĩa nghiệp vụ

Trường	Ý nghĩa nghiệp vụ	Gợi ý sử dụng
fromExchangeName	Nhãn bên gửi	Xác định quyền sở hữu địa chỉ gửi, ví dụ tên sàn giao dịch
toExchangeName	Nhãn bên nhận	Xác định quyền sở hữu địa chỉ nhận, ví dụ tên sàn giao dịch
amount	Số tiền giao dịch	Số lượng token trong giao dịch lớn; dùng để giám sát động thái cá voi

Ví dụ yêu cầu

json

{
    "vsTokenId": 1,      // ID token
    "page": 1,           // Trang hiện tại; mặc định 1
    "pageSize": 10       // Số bản ghi mỗi trang; mặc định 10, tối đa 100
}

Ví dụ cURL (Linux/macOS)

bash

curl --location --request POST 'http://${host}/api/open/v1/chain/trade/large' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
    "vsTokenId": 1,
    "page": 1,
    "pageSize": 10
}'

Ví dụ cURL (Windows CMD)

cmd

curl --location --request POST "http://${host}/api/open/v1/chain/trade/large" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{    \"vsTokenId\": 1,    \"page\": 1,    \"pageSize\": 10}"

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
            "blockNumber": 928673,                                       // Chiều cao khối
            "transIndex": 2779,                                          // Chỉ số giao dịch trong khối
            "coinKey": "BTC_BTC",                                        // Mã coin
            "transHash": "3886677340fa8a77bb97e72f5b8bc2992cfb272fef8de9e7b7bf0da919612b36", // Hash giao dịch
            "fromAddress": "",                                           // Địa chỉ gửi
            "fromExchangeName": "",                                      // Nhãn bên gửi
            "toAddress": "",                                             // Địa chỉ nhận
            "toExchangeName": "Gate.io",                                 // Nhãn bên nhận
            "amount": "237.25912679",                                    // Số tiền giao dịch
            "blockTime": 1766216779000,                                  // Thời gian khối
            "coinInfo": {
                "coinKey": "BTC_BTC",                                    // Mã coin
                "coinName": "Bitcoin",                                   // Tên coin
                "symbol": "BTC",                                         // Ký hiệu coin
                "protocol": "",                                          // Giao thức
                "contractAddress": "BTC",                                // Địa chỉ hợp đồng
                "chainName": "BTC",                                      // Tên chuỗi
                "icon": "https://static.valuescan.io/valuescan/icon/BTC.svg", // URL biểu tượng
                "price": "88161.61615187663"                             // Giá
            },
            "addressInfo": {
                "address": "",                                           // Địa chỉ
                "label": "",                                             // Nhãn
                "balance": "",                                           // Số dư
                "profit": ""                                             // Lợi nhuận
            },
            "exchangeInfo": {
                "address": "",                                           // Địa chỉ
                "name": "Gate.io",                                       // Tên
                "icon": "",                                              // Biểu tượng
                "label": "",                                             // Nhãn
                "addresses": [                                           // Danh sách địa chỉ
                    "1G47mSr3oANXMafVrR8UC4pzV7FEAzo3r9"
                ],
                "amount": "237.25912679",                                // Số tiền
                "exchangeCount": 1                                       // Số lượng sàn giao dịch
            }
        },
        {
            "vsTokenId": "1",
            "symbol": "BTC",
            "name": "Bitcoin",
            "blockNumber": 928614,
            "transIndex": 619,
            "coinKey": "BTC_BTC",
            "transHash": "74ff8ba02659aadde9ba474d0c42216fd58e1635ea8dd4412047bddd41cf0538",
            "fromAddress": "",
            "fromExchangeName": "Coinbase",
            "toAddress": "",
            "toExchangeName": "",
            "amount": "292.07321743",
            "blockTime": 1766184312000,
            "coinInfo": {
                "coinKey": "BTC_BTC",
                "coinName": "Bitcoin",
                "symbol": "BTC",
                "protocol": "",
                "contractAddress": "BTC",
                "chainName": "BTC",
                "icon": "https://static.valuescan.io/valuescan/icon/BTC.svg",
                "price": "88247.12283016353"
            },
            "addressInfo": {
                "address": "",
                "label": "",
                "balance": "",
                "profit": ""
            },
            "exchangeInfo": {
                "address": "",
                "name": "Coinbase",
                "icon": "",
                "label": "",
                "addresses": [
                    "3Eb17r7G4mwDzNn2oGNBD5mz8oDt5pSrv1",
                    "32V6a7K46pSb1XQNGdrmdE2wjgndVfJPet",
                    "3GPV1xVDrC7qFcdrpUmLF4N5wvWYmAjDrs"
                ],
                "amount": "273.35750643",
                "exchangeCount": 1
            }
        },
        {
            "vsTokenId": "1",
            "symbol": "BTC",
            "name": "Bitcoin",
            "blockNumber": 928574,
            "transIndex": 2827,
            "coinKey": "BTC_BTC",
            "transHash": "b98c1d2243e50c206c53262361b57c5732ff8e3491aa39552dac6e258615a0ca",
            "fromAddress": "",
            "fromExchangeName": "",
            "toAddress": "",
            "toExchangeName": "Crypto.com",
            "amount": "301.93699604",
            "blockTime": 1766163476000,
            "coinInfo": {
                "coinKey": "BTC_BTC",
                "coinName": "Bitcoin",
                "symbol": "BTC",
                "protocol": "",
                "contractAddress": "BTC",
                "chainName": "BTC",
                "icon": "https://static.valuescan.io/valuescan/icon/BTC.svg",
                "price": "88287.06586315356"
            },
            "addressInfo": {
                "address": "",
                "label": "",
                "balance": "",
                "profit": ""
            },
            "exchangeInfo": {
                "address": "",
                "name": "Crypto.com",
                "icon": "",
                "label": "",
                "addresses": [
                    "bc1qr4dl5wa7kl8yu792dceg9z5knl2gkn220lk7a9"
                ],
                "amount": "301.93699604",
                "exchangeCount": 1
            }
        }
        // ... thêm dữ liệu bị lược bỏ
    ],
    "requestId": "xxx-xxx-xxx"
}

Giao dịch lớn ​

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 ​