大额交易

接口描述

取得指定代幣在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）

成功回應示例