交易所资金流向
查询代币链上转账与交易所资金流向。
GET/api/v1/flows/token-transfers
可查询数据
- 返回数据
- 代币链上转账与交易所资金流向
- 市场覆盖
- Crypto
- 查询粒度
- 每次查询一个资产或链上代币部署；每条记录对应一笔链上转账
认证
所有请求需携带 Authorization: Bearer YOUR_API_KEY 或 X-API-KEY。
请求参数
资产定位
至少填写 query、ticker、symbol、asset_id 中一项，或同时填写 chain 和 token_address。
querystringquery示例USDT条件必须代币名称、代码或合约地址。
tickerstringquery示例USDT条件必须代币代码，query 的别名。
symbolstringquery示例USDT条件必须代币代码，query 的别名。
asset_idstringquery示例asset_usdt条件必须GateData 标准资产 ID。
chainstringquery示例ethereum条件必须链标识；直接地址查询时必填，多链资产用于指定部署。
token_addressstringquery示例0xdAC17F958D2ee523a2206206994597C13D831ec7条件必须代币合约地址，直接查询时与 chain 同时填写。
wallet_addressstringquery示例0x5bC3...条件必须查询原生币时必填，并同时提供 chain 和资产定位参数。
交易筛选
fromstringquery示例0xabc...可选转出钱包地址。
tostringquery示例0xdef...可选转入钱包地址。
tx_statusstringquery示例success可选交易状态：all、success、pending。
时间范围
from_timestringquery示例1785513600可选开始时间，Unix 秒级时间戳，须早于结束时间。
to_timestringquery示例1787673600可选结束时间，Unix 秒级时间戳，建议与开始时间同时填写。
交易筛选
valuestringquery示例1000000可选转账代币数量下限，非美元金额。
value_upper_limitstringquery示例10000000可选转账代币数量上限，不小于下限。
分页
pageintegerquery示例1可选页码，从 1 开始。
page_sizeintegerquery示例20可选每页返回数量。
响应
数据状态：ready、partial、no_data、not_ready。
items[]object[]
转账记录列表。
tx_hashstring示例<transaction_hash>交易哈希。
block_numberinteger示例21890321区块高度。
tx_timestring示例2026-08-27T03:58:14Z交易时间。
tx_statusstring示例success交易状态。
chainstring示例ethereum链标识。
token_addressstring示例0xdAC17F958D2ee523a2206206994597C13D831e…代币合约地址。
asset_idstring示例asset_usdt资产标识，标识股票、加密资产等资产对象
symbolstring示例USDT代币代码。
from_addressstring示例<from_address>转出钱包地址。
to_addressstring示例<to_address>转入钱包地址。
amountstring示例2500000代币数量。
decimalsinteger示例6代币精度。
数据状态：ready、partial、no_data、not_ready。
pageinteger示例1当前页码。
page_sizeinteger示例20每页条数。
metadataobject
响应元信息。
actual_taskstring示例exchange_flows实际执行的任务。
resolved_assetobject
解析后的资产及链上部署。
asset_idstring示例asset_usdt资产标识，标识股票、加密资产等资产对象
symbolstring示例USDT代币代码。
chainstring示例ethereum链标识。
chain_slugstring示例ethereum区块链浏览器链标识。
token_addressstring示例0xdAC17F958D2ee523a2206206994597C13D831e…代币合约地址。
resolved_fromstring示例query资产定位来源。
updated_atstring示例2026-08-27T04:00:00Z响应更新时间。
错误与降级
200
assets_resolve 名称多命中；从 data[] 候选确认。
200
对象已解析但无可用数据；empty_reason 可为 not_covered_by_source / unsupported_metric / limited_depth。
400
参数无效，或行情 listing 多命中；歧义响应含 required_params + candidates。
401
缺少 API Key，或 Key 无效。
403
当前 Key 的 scope 或套餐无权访问该数据域。
404
请求的资源不存在；数据源不覆盖不归入 404。
402
Credits 或月度额度耗尽。
429
请求频率超限；body 返回 retry_after，响应头同步返回 Retry-After。