代币链上活动

按代币部署查询交易所资金流、DEX 成交及流动性增减事件。

GET/api/v1/onchain/token-activities
数据域
网络与协议
解析层级
按代币部署查询,CEX、DEX、LP 分组返回
MCP 工具
REST-only

可查询数据

返回数据
按代币部署查询交易所资金流、DEX 成交及流动性增减事件。
每次返回什么
按代币部署查询,CEX、DEX、LP 分组返回

认证

所有请求需携带 Authorization: Bearer YOUR_API_KEY 或 X-API-KEY。

请求参数

按资产查询

使用资产标识或query定位,或在下一组同时填写chain与token_address。兼容别名不必一起填写

asset_idstringquery条件必须

已知的 GateData 资产 ID

querystringquery条件必须

按名称/符号查找;会扫描该资产的多个部署

兼容定位字段
tickerstringquery条件必须

资产符号线索

symbolstringquery条件必须

资产符号

按链与合约地址查询

chain与token_address两项同时填写,定位指定链上的代币部署

chainstringquery示例solana条件必须

链 slug;示例 solana。 与 token_address 成对使用

token_addressstringquery示例So11111111111111111111111111111111111111112条件必须

代币部署地址;示例 So11111111111111111111111111111111111111112。 与 chain 成对使用

活动类型

选择cex、dex、lp、all或逗号分隔的组合;只发送所选类型适用的筛选项

event_typesstringquery示例dex,lp可选

cex | dex | lp | all;支持逗号 OR,例如 dex,lp。 · 默认: all

交易所资金流筛选

仅适用于cex活动;金额门槛按代币数量计

venuestringquery可选

CEX 代码或 venue_id,支持逗号 OR;只在 event_types 包含 cex 时使用

cex_flow_directionstringquery可选

CEX 方向;默认不含内部划转,all 可包含 internal。 · 默认: inflow,outflow,exchange_transfer

cex_min_amountnumberquery可选

CEX 代币数量门槛,不是 USD;不支持 cex_min_usd

DEX成交筛选

仅适用于DEX成交;金额门槛单位为USD

dex_sidestringquery可选

buy | sell | all;支持逗号 OR。 · 默认: all

dex_min_usdnumberquery可选

DEX 成交美元金额门槛。 · 默认: 10000

流动性事件筛选

仅适用于流动性事件;金额门槛单位为USD

lp_sidestringquery可选

add | remove | unilateral_add | unilateral_remove | all;支持逗号 OR。 · 默认: all

lp_min_usdnumberquery可选

LP 事件美元金额门槛。 · 默认: 10

通用筛选与分页

page_size控制每组返回数量;max_scan_pages控制每个来源扫描页数

wallet_addressstringquery可选

按钱包地址过滤

pageintegerquery可选

查询页码。 · 默认: 1

page_sizeintegerquery示例2可选

每组最多返回条数;最大 100;示例 2。 · 默认: 50 · ≤ 100

max_scan_pagesintegerquery示例1可选

每源最多扫描页数;最大 20;示例 1。 · 默认: 5 · ≤ 20

响应

dataobject

业务数据,结构见各接口的响应定义

cex_flowsobject[]

交易所相关转账

dex_tradesobject[]

DEX 成交

lp_eventsobject[]

流动性增减事件

cex_flows[]array[object]
amountstring

转账数量

token_value_usdstring

转账美元价值

flow_directionstring

流入、流出或交易所间划转方向

from_addressstring

转出地址

to_addressstring

转入地址

from_venue_idstring | null

转出交易所标识

to_venue_idstring | null

转入交易所标识

tx_timestring

交易时间

tx_hashstring

交易哈希

tx_linkstring

区块浏览器链接

dex_trades[]array[object]
amountstring

成交数量

price_usdstring

成交美元单价

volume_usdstring

成交美元金额

sidestring

buy / sell

trade_timestring

成交时间

makerstring

交易地址

pairstring

交易池/币对地址

tx_hashstring

交易哈希

tx_linkstring

区块浏览器链接

lp_events[]array[object]
amount0string

token0 数量

amount1string

token1 数量

token0_addressstring

token0 地址

token1_addressstring

token1 地址

total_volume_usdstring

该 LP 事件总美元金额

sidestring

流动性增减类型

block_timestampinteger

区块时间,Unix 时间戳,单位为秒

valuation_statusstring

估值状态

threshold_bypassedboolean

是否绕过金额门槛

tx_hashstring

交易哈希

tx_linkstring

区块浏览器链接

data_statusDataStatus

verified / ok:返回业务数据;partial:部分可用;no_data:无数据;not_ready:暂不可用

errornull | string | object

错误信息;正常结果为 null

empty_reasonstring

无数据或暂不可用的原因

missing_fieldsstring[]

未提供的字段列表

coverage_fromstring

已返回历史数据的起始日期

coverage_tostring

已返回历史数据的结束日期

coverage_notestring

数据覆盖范围说明

request_idstring

请求追踪标识

operation_idstring

接口操作标识

route_codestring

请求路由标识

observed_atstring

响应观测时间

metadataobject

状态、对象引用和限制等元信息

updated_atstring

响应元信息更新时间

object_refsobject[]

查询涉及的对象引用

limitationsstring[]

数据使用或覆盖限制

sourcesobject

cex / dex / lp 各源的 status、scanned_pages、next_page

limitationsstring[]

扫描截断或上游异常原因

applied_filtersobject

实际执行的过滤参数与扫描部署

applied_thresholdsobject

实际使用的三类金额/数量门槛

resolved_assetobject

解析结果;直接地址查询时 asset_id 可能为 null,不代表没有数据

错误与降级

200
部分事件组可用,或扫描达到限制;详情见 sources 和 limitations。
200
请求的数据源暂不可用;详情见 sources 和 limitations。
401
检查 API Key。
403
检查 Key 的数据域权限。