GateData.AI

钱包交易

查询钱包交易与转账记录。

GET/api/v1/wallets/transactions
数据域
持仓与资金流
解析层级
链上地址
MCP 工具
ownership_flows_query (task=wallet_transactions)

可查询数据

返回数据
钱包交易与转账记录
市场覆盖
主流 EVM 链、Solana
查询粒度
每次查询一个地址，可按链或时间筛选

认证

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

请求参数

钱包定位

address 和 chain 必填。

addressstringquery示例0x1ab4973a48dc892cd9971ece8e01dcc7688f8f23必填

钱包地址。

chainstringquery示例ethereum必填

区块链代码。

筛选条件

均为可选。

querystringquery示例ETH可选

查询关键词、代码或名称。

asset_idstringquery示例asset_eth可选

资产标识，标识股票、加密资产等资产对象

deployment_idstringquery示例deployment_eth可选

按链上部署 ID 筛选。

token_addressstringquery示例0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48可选

按代币合约地址筛选。

directionstringquery示例out可选

资金方向：in、out 或 self。

tx_statusstringquery示例success可选

交易状态。

from_timedatetimequery示例2026-01-01T00:00:00Z可选

开始时间。

to_timedatetimequery示例2026-09-18T00:00:00Z可选

结束时间。

min_value_usdnumberquery示例10000可选

最低美元交易价值。

include_labelsbooleanquery示例true可选

是否返回地址标签。

分页

均为可选。

pageintegerquery示例1可选

页码，从 1 开始。

page_sizeintegerquery示例20可选

每页条数。

响应

items[]object[]

钱包交易列表

tx_hashstring / string / integer示例0xabc

交易哈希、链与区块高度

chainstring / string / integer示例ethereum

交易哈希、链与区块高度

block_numberstring / string / integer示例22910420

交易哈希、链与区块高度

from_addressstring | null示例0x1ab4973a48dc892cd9971ece8e01dcc7688f8f…

收发地址与资金方向

to_addressstring | null示例0x8ba1f109551bd432803012645ac136ddd64dba…

收发地址与资金方向

directionstring | null示例out

收发地址与资金方向

valuedecimal string | null示例0

原生币金额、手续费与美元手续费

feedecimal string | null示例0.00042

原生币金额、手续费与美元手续费

fee_usddecimal string | null示例1.42

原生币金额、手续费与美元手续费

statusstring | null示例confirmed

交易状态与浏览器链接

tx_statusstring | null示例success

交易状态与浏览器链接

explorer_urlstring | null示例https://etherscan.io/tx/0xabc

交易状态与浏览器链接

tx_timedatetime | null / integer | null示例2026-09-18T06:30:00Z

交易时间

tx_timestampdatetime | null / integer | null示例1789713000

交易时间

transfers[]object[]

交易内的代币转账

amountdecimal string | null示例2.50

转账数量、美元价值与代币信息

value_usddecimal string | null示例2.50

转账数量、美元价值与代币信息

symboldecimal string | null示例USDC

转账数量、美元价值与代币信息

token_addressdecimal string | null示例0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb…

转账数量、美元价值与代币信息

data_statusDataStatus示例partial

数据可用状态

pageinteger示例1

当前页与每页条数

page_sizeinteger示例20

当前页与每页条数

metadataobject

任务、完整性、限制与更新时间

object_refs[]object[]

统一对象引用数组

错误与降级

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。