Large Transactions

Description

Returns large transaction data for a specified token across 20+ major public chains including BTC-series, EVM-series, and Tron-series networks.

Use cases:

Monitor and analyze large or abnormal on-chain transactions for a token
Monitor large transfers between whale addresses and exchanges
Track whale movements and market anomaly alerts

Update frequency: Updated once per day

Endpoint

Method: POST
Path: /open/v1/chain/trade/large

Credits

Cost: 2

Prerequisites

Obtain vsTokenId

Condition	Description	How to obtain
vsTokenId available	Use cached vsTokenId; no repeat lookup	Auto-extracted from context
vsTokenId missing	Call `POST /vs-token/list`	Prerequisite API call

Request parameters

Parameters are sent as JSON in the request body.

Field	Type	Required	Description
vsTokenId	long	Yes	Token ID
page	integer	No	Current page; default 1
pageSize	integer	No	Items per page; default 10, max 100

Response fields

Structure of each object in the data array:

Field	Type	Serialized	Description
vsTokenId	long	string	Token ID
symbol	string	string	Token symbol
name	string	string	Token name
blockNumber	long	long	Block height
transIndex	integer	integer	Transaction index in the block
coinKey	string	string	Coin key
transHash	string	string	Transaction hash
fromAddress	string	string	Sender address
fromExchangeName	string	string	Sender label
toAddress	string	string	Receiver address
toExchangeName	string	string	Receiver label
amount	number	string	Transaction amount
blockTime	long	long	Block time (millisecond timestamp)
coinInfo	object	object	Token info
coinKey	string	string	Coin key
coinName	string	string	Coin name
symbol	string	string	Coin symbol
protocol	string	string	Protocol
contractAddress	string	string	Contract address
chainName	string	string	Chain name
icon	string	string	Icon URL
price	number	string	Price
addressInfo	object	object	Address info
address	string	string	Address
label	object	object	Label
labelName	string	string	Label name
iconUrl	string	string	Icon URL
isContract	boolean	boolean	Whether it is a contract address
exchangeSymbol	string	string	Exchange name
labelType	string	string	Type
reliability	integer	integer	Reliability
nativeLabelName	string	string	Native label name
balance	number	string	Balance
profit	number	string	Profit
exchangeInfo	object	object	Exchange info
address	string	string	Address
name	string	string	Name
icon	string	string	Icon
label	object	object	Label
labelName	string	string	Label name
iconUrl	string	string	Icon URL
isContract	boolean	boolean	Whether it is a contract address
exchangeSymbol	string	string	Exchange name
labelType	string	string	Type
reliability	integer	integer	Reliability
nativeLabelName	string	string	Native label name
addresses	array	array	Address list
amount	number	string	Amount
exchangeCount	integer	integer	Exchange count

Field semantics

Field	Meaning	Tip
fromExchangeName	Sender label	Identifies sender ownership, e.g. exchange name
toExchangeName	Receiver label	Identifies receiver ownership, e.g. exchange name
amount	Transaction amount	Token quantity in large trades; use to monitor whale movements

Example

json

{
    "vsTokenId": 1,      // Token ID
    "page": 1,           // Current page; default 1
    "pageSize": 10       // Items per page; default 10, max 100
}

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
}'

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}"

Success response example

json

{
    "code": 200,
    "message": "success",
    "data": [
        {
            "vsTokenId": "1",                                           // Token ID
            "symbol": "BTC",                                             // Token symbol
            "name": "Bitcoin",                                           // Token name
            "blockNumber": 928673,                                       // Block height
            "transIndex": 2779,                                          // Transaction index in block
            "coinKey": "BTC_BTC",                                        // Coin key
            "transHash": "3886677340fa8a77bb97e72f5b8bc2992cfb272fef8de9e7b7bf0da919612b36", // Transaction hash
            "fromAddress": "",                                           // Sender address
            "fromExchangeName": "",                                      // Sender label
            "toAddress": "",                                             // Receiver address
            "toExchangeName": "Gate.io",                                 // Receiver label
            "amount": "237.25912679",                                    // Transaction amount
            "blockTime": 1766216779000,                                  // Block time
            "coinInfo": {
                "coinKey": "BTC_BTC",                                    // Coin key
                "coinName": "Bitcoin",                                   // Coin name
                "symbol": "BTC",                                         // Coin symbol
                "protocol": "",                                          // Protocol
                "contractAddress": "BTC",                                // Contract address
                "chainName": "BTC",                                      // Chain name
                "icon": "https://static.valuescan.io/valuescan/icon/BTC.svg", // Icon URL
                "price": "88161.61615187663"                             // Price
            },
            "addressInfo": {
                "address": "",                                           // Address
                "label": "",                                             // Label
                "balance": "",                                           // Balance
                "profit": ""                                             // Profit
            },
            "exchangeInfo": {
                "address": "",                                           // Address
                "name": "Gate.io",                                       // Name
                "icon": "",                                              // Icon
                "label": "",                                             // Label
                "addresses": [                                           // Address list
                    "1G47mSr3oANXMafVrR8UC4pzV7FEAzo3r9"
                ],
                "amount": "237.25912679",                                // Amount
                "exchangeCount": 1                                       // Exchange count
            }
        },
        {
            "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
            }
        }
        // ... more data omitted
    ],
    "requestId": "xxx-xxx-xxx"
}

Large Transactions ​

Description ​

Endpoint ​

Credits ​

Prerequisites ​

Request parameters ​

Response fields ​

Field semantics ​

Example ​

cURL (Linux/macOS) ​

cURL (Windows CMD) ​

Success response example ​