Large on-chain transfers

Description

Large transfers across 20+ chains (BTC family, EVM, Tron, etc.).

Use cases

• Whale and abnormal flow monitoring
• Exchange ↔ whale corridors
• Early warning on market moves

Update: Daily

Endpoint

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

Credits

• Cost: 2

Prerequisites

vsTokenId — POST /vs-token/list

Request body (JSON)

Field	Type	Required	Description
vsTokenId	long	Yes	Token id
page	integer	No	Page (default 1)
pageSize	integer	No	Size (default 10, max 100)

Response — data[]

Field	Type	Serialized	Description
vsTokenId	long	string	Token id
symbol	string	string	Ticker
name	string	string	Name
blockNumber	long	long	Block
transIndex	integer	integer	Tx index in block
coinKey	string	string	Token key
transHash	string	string	Tx hash
fromAddress	string	string	From
fromExchangeName	string	string	From label
toAddress	string	string	To
toExchangeName	string	string	To label
amount	number	string	Amount (tokens)
blockTime	long	long	Block time (ms)
coinInfo	object	object	Token meta
coinKey	string	string	Key
coinName	string	string	Name
symbol	string	string	Symbol
protocol	string	string	Protocol
contractAddress	string	string	Contract
chainName	string	string	Chain
icon	string	string	Icon
price	number	string	Price
addressInfo	object	object	Counterparty
exchangeInfo	object	object	Venue aggregation

(Sub-fields mirror zh-CN table — label, balance, profit, nested label on addresses/exchanges.)

Semantics

Field	Meaning	Tip
fromExchangeName / toExchangeName	Attribution	Venue tags
amount	Token units	Whale sizing

Example

{
    "vsTokenId": 1,
    "page": 1,
    "pageSize": 10
}

cURL (Linux/macOS)

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)

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

Sample success

{
    "code": 200,
    "message": "success",
    "data": [
        {
            "vsTokenId": "1",
            "symbol": "BTC",
            "name": "Bitcoin",
            "blockNumber": 928673,
            "transIndex": 2779,
            "coinKey": "BTC_BTC",
            "transHash": "3886677340fa8a77bb97e72f5b8bc2992cfb272fef8de9e7b7bf0da919612b36",
            "fromAddress": "",
            "fromExchangeName": "",
            "toAddress": "",
            "toExchangeName": "Gate.io",
            "amount": "237.25912679",
            "blockTime": 1766216779000,
            "coinInfo": {
                "coinKey": "BTC_BTC",
                "coinName": "Bitcoin",
                "symbol": "BTC",
                "protocol": "",
                "contractAddress": "BTC",
                "chainName": "BTC",
                "icon": "https://static.valuescan.io/valuescan/icon/BTC.svg",
                "price": "88161.61615187663"
            },
            "addressInfo": {
                "address": "",
                "label": "",
                "balance": "",
                "profit": ""
            },
            "exchangeInfo": {
                "address": "",
                "name": "Gate.io",
                "icon": "",
                "label": "",
                "addresses": [
                    "1G47mSr3oANXMafVrR8UC4pzV7FEAzo3r9"
                ],
                "amount": "237.25912679",
                "exchangeCount": 1
            }
        }
    ],
    "requestId": "xxx-xxx-xxx"
}