GateData.AI

Wallet Transactions

Query wallet trades and transfers.

GET/api/v1/wallets/transactions
Domain
Flows & Wallets
Level
On-chain address
MCP tool
ownership_flows_query (task=wallet_transactions)

Available data

Returns
Wallet trades and transfers
Market coverage
Major EVM chains and Solana
Query granularity
One address per query; filter by chain or time window

Authentication

Send Authorization: Bearer YOUR_API_KEY or X-API-KEY on every request.

Query Parameters

Wallet positioning

address and chain are required.

addressstringqueryExample0x1ab4973a48dc892cd9971ece8e01dcc7688f8f23required

Wallet address.

chainstringqueryExampleethereumrequired

Chain code.

Filters

All optional.

querystringqueryExampleETHoptional

Filter by asset name or symbol.

asset_idstringqueryExampleasset_ethoptional

Filter by canonical asset ID.

deployment_idstringqueryExampledeployment_ethoptional

Filter by deployment ID.

token_addressstringqueryExample0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48optional

Filter by token contract address.

directionstringqueryExampleoutoptional

Flow direction: in, out, or self.

tx_statusstringqueryExamplesuccessoptional

Transaction status.

from_timedatetimequeryExample2026-01-01T00:00:00Zoptional

Start time.

to_timedatetimequeryExample2026-09-18T00:00:00Zoptional

End time.

min_value_usdnumberqueryExample10000optional

Minimum transaction value in USD.

include_labelsbooleanqueryExampletrueoptional

Whether to include address labels.

Pagination

All optional.

pageintegerqueryExample1optional

Page number, starting at 1.

page_sizeintegerqueryExample20optional

Rows per page.

Response

items[]object[]

Wallet transaction rows

tx_hashstring / string / integerExample0xabc

Transaction hash, chain, and block number

chainstring / string / integerExampleethereum

Transaction hash, chain, and block number

block_numberstring / string / integerExample22910420

Transaction hash, chain, and block number

from_addressstring | nullExample0x1ab4973a48dc892cd9971ece8e01dcc7688f8f…

Addresses and flow direction

to_addressstring | nullExample0x8ba1f109551bd432803012645ac136ddd64dba…

Addresses and flow direction

directionstring | nullExampleout

Addresses and flow direction

valuedecimal string | nullExample0

Native value, fee, and USD fee

feedecimal string | nullExample0.00042

Native value, fee, and USD fee

fee_usddecimal string | nullExample1.42

Native value, fee, and USD fee

statusstring | nullExampleconfirmed

Transaction status and explorer URL

tx_statusstring | nullExamplesuccess

Transaction status and explorer URL

explorer_urlstring | nullExamplehttps://etherscan.io/tx/0xabc

Transaction status and explorer URL

tx_timedatetime | null / integer | nullExample2026-09-18T06:30:00Z

Transaction time

tx_timestampdatetime | null / integer | nullExample1789713000

Transaction time

transfers[]object[]

Token transfers in the transaction

amountdecimal string | nullExample2.50

Transfer amount, USD value, and token identity

value_usddecimal string | nullExample2.50

Transfer amount, USD value, and token identity

symboldecimal string | nullExampleUSDC

Transfer amount, USD value, and token identity

token_addressdecimal string | nullExample0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb…

Transfer amount, USD value, and token identity

data_statusDataStatusExamplepartial

Data availability status

pageintegerExample1

Current page and page size

page_sizeintegerExample20

Current page and page size

metadataobject

Task, completeness, limitations, and update time

object_refs[]object[]

Unified object references

Errors & fallback

200
assets_resolve name multi-match; confirm from data[] candidates.
200
The object resolved but no data is available; empty_reason may be not_covered_by_source, unsupported_metric, or limited_depth.
400
Invalid parameters or an ambiguous market listing; ambiguity responses include required_params + candidates.
401
The API key is missing or invalid.
403
The current key scope or plan cannot access this data domain.
404
The requested resource does not exist; source coverage gaps are not 404 responses.
402
Credits or monthly quota exhausted.
429
Request rate exceeded; retry_after is returned in the body and Retry-After in the response headers.