大额交易

接口描述

获取指定代币在BTC系列，EVM系列，波场系列20+主流公链上的大额交易数据。

使用场景：

适用于对代币在链上的大额交易或异常交易流动监控追踪及分析
适用于鲸鱼地址和交易所之间的大额转账监控
适用于追踪大户动向和市场异动预警

数据更新频率：每天更新一次

请求URL

方法：POST
路径：/open/v1/chain/trade/large

积分消耗

消耗积分：2

前置条件

获取 vsTokenId

条件	说明	获取方式
已有 vsTokenId	直接使用缓存的 vsTokenId，无需重复查询	上下文自动提取
未有 vsTokenId	调用 `POST /vs-token/list` 接口获取	前置接口调用

请求参数

参数通过请求体（Body）以 JSON 格式传递。

参数名	类型	必需	描述
vsTokenId	long	是	代币 ID
page	integer	否	当前页，默认1
pageSize	integer	否	当前页数据数量，默认10，最大100

响应字段

仅展示 data 数组内每个对象的字段结构：

字段	类型	实际返回类型	描述
vsTokenId	long	string	代币 ID
symbol	string	string	代币符号
name	string	string	代币名称
blockNumber	long	long	区块高度
transIndex	integer	integer	交易在区块列表中的下标
coinKey	string	string	币标识
transHash	string	string	交易 hash
fromAddress	string	string	发出方地址
fromExchangeName	string	string	发出方标签
toAddress	string	string	接收方地址
toExchangeName	string	string	接收方标签
amount	number	string	交易金额
blockTime	long	long	区块时间（毫秒时间戳）
coinInfo	object	object	代币信息
coinKey	string	string	币标识
coinName	string	string	币名
symbol	string	string	币标识
protocol	string	string	协议
contractAddress	string	string	合约地址
chainName	string	string	链名
icon	string	string	图标 URL
price	number	string	价格
addressInfo	object	object	地址信息
address	string	string	地址
label	object	object	标签
labelName	string	string	标签名
iconUrl	string	string	图标 URL
isContract	boolean	boolean	是否是合约地址
exchangeSymbol	string	string	交易所名称
labelType	string	string	类型
reliability	integer	integer	可信度
nativeLabelName	string	string	原生标签名
balance	number	string	余额
profit	number	string	收益
exchangeInfo	object	object	交易所信息
address	string	string	地址
name	string	string	名称
icon	string	string	图标
label	object	object	标签
labelName	string	string	标签名
iconUrl	string	string	图标 URL
isContract	boolean	boolean	是否是合约地址
exchangeSymbol	string	string	交易所名称
labelType	string	string	类型
reliability	integer	integer	可信度
nativeLabelName	string	string	原生标签名
addresses	array	array	地址列表
amount	number	string	金额
exchangeCount	integer	integer	交易所计数

字段业务含义

字段	业务含义	使用建议
fromExchangeName	发出方标签	标识转出地址归属，如交易所名称
toExchangeName	接收方标签	标识转入地址归属，如交易所名称
amount	交易金额	大额交易的代币数量，用于监控鲸鱼动向

请求示例

json

{
    "vsTokenId": 1,      // 代币 id
    "page": 1,           // 当前页，默认1
    "pageSize": 10       // 当前页数据数量，默认10，最大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}"

成功响应示例

json

{
    "code": 200,
    "message": "success",
    "data": [
        {
            "vsTokenId": "1",                                           // 代币 ID
            "symbol": "BTC",                                             // 代币符号
            "name": "Bitcoin",                                           // 代币名称
            "blockNumber": 928673,                                       // 区块高度
            "transIndex": 2779,                                          // 交易在区块列表中的下标
            "coinKey": "BTC_BTC",                                        // 币标识
            "transHash": "3886677340fa8a77bb97e72f5b8bc2992cfb272fef8de9e7b7bf0da919612b36", // 交易 hash
            "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", // 图标 URL
                "price": "88161.61615187663"                             // 价格
            },
            "addressInfo": {
                "address": "",                                           // 地址
                "label": "",                                             // 标签
                "balance": "",                                           // 余额
                "profit": ""                                             // 收益
            },
            "exchangeInfo": {
                "address": "",                                           // 地址
                "name": "Gate.io",                                       // 名称
                "icon": "",                                              // 图标
                "label": "",                                             // 标签
                "addresses": [                                           // 地址列表
                    "1G47mSr3oANXMafVrR8UC4pzV7FEAzo3r9"
                ],
                "amount": "237.25912679",                                // 金额
                "exchangeCount": 1                                       // 交易所计数
            }
        },
        {
            "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
            }
        }
        // ... 更多数据省略
    ],
    "requestId": "xxx-xxx-xxx"
}

大额交易 ​

接口描述 ​

请求URL ​

积分消耗 ​

前置条件 ​

请求参数 ​

响应字段 ​

字段业务含义 ​

请求示例 ​

cURL 示例（Linux/macOS） ​

cURL 示例（Windows CMD） ​

成功响应示例 ​

大额交易

接口描述

请求URL

积分消耗

前置条件

请求参数

响应字段

字段业务含义

请求示例

cURL 示例（Linux/macOS）

cURL 示例（Windows CMD）

成功响应示例