GateData.AI

Exchange token flows

Query on-chain token transfers for exchange flow analysis.

GET/api/v1/flows/token-transfers
Domain
Flows & Wallets
Level
Crypto asset
MCP tool
ownership_flows_query (task=exchange_flows)

Available data

Returns
On-chain token transfers for exchange flow analysis
Market coverage
Crypto
Query granularity
One asset or on-chain token deployment per query; each row is one on-chain transfer

Authentication

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

Query Parameters

Asset identification

Provide query, ticker, symbol or asset_id, or both chain and token_address.

querystringqueryExampleUSDTconditional

Token name, symbol or contract address.

tickerstringqueryExampleUSDTconditional

Token ticker; alias of query.

symbolstringqueryExampleUSDTconditional

Token symbol; alias of query.

asset_idstringqueryExampleasset_usdtconditional

GateData asset ID.

chainstringqueryExampleethereumconditional

Chain; required for direct lookup and used to select a deployment.

token_addressstringqueryExample0xdAC17F958D2ee523a2206206994597C13D831ec7conditional

Token contract address; provide together with chain for direct lookup.

wallet_addressstringqueryExample0x5bC3...conditional

Required for native coins, together with chain and an asset identifier.

Transaction filters
fromstringqueryExample0xabc...optional

Sender wallet address.

tostringqueryExample0xdef...optional

Recipient wallet address.

tx_statusstringqueryExamplesuccessoptional

Transaction status: all, success, pending.

Time range
from_timestringqueryExample1785513600optional

Start time in Unix seconds; must precede end time.

to_timestringqueryExample1787673600optional

End time in Unix seconds; use with start time.

Transaction filters
valuestringqueryExample1000000optional

Minimum token amount, not USD value.

value_upper_limitstringqueryExample10000000optional

Maximum token amount; must be at least the minimum.

Pagination
pageintegerqueryExample1optional

Page number, starting at 1.

page_sizeintegerqueryExample20optional

Records per page.

Response

data_statusDataStatusExampleready

Data status: ready, partial, no_data, not_ready.

items[]object[]

Transfer records.

tx_hashstringExample<transaction_hash>

Transaction hash.

block_numberintegerExample21890321

Block height.

tx_timestringExample2026-08-27T03:58:14Z

Transaction time.

tx_statusstringExamplesuccess

Transaction status.

chainstringExampleethereum

Chain.

token_addressstringExample0xdAC17F958D2ee523a2206206994597C13D831e…

Token contract address.

asset_idstringExampleasset_usdt

Canonical asset ID.

symbolstringExampleUSDT

Token symbol.

from_addressstringExample<from_address>

Sender address.

to_addressstringExample<to_address>

Recipient address.

amountstringExample2500000

Token amount.

decimalsintegerExample6

Token decimals.

data_statusDataStatusExampleready

Data status: ready, partial, no_data, not_ready.

pageintegerExample1

Current page.

page_sizeintegerExample20

Page size.

metadataobject

Response metadata.

actual_taskstringExampleexchange_flows

Executed task.

resolved_assetobject

Resolved asset and deployment.

asset_idstringExampleasset_usdt

Canonical asset ID.

symbolstringExampleUSDT

Token symbol.

chainstringExampleethereum

Chain.

chain_slugstringExampleethereum

Explorer chain identifier.

token_addressstringExample0xdAC17F958D2ee523a2206206994597C13D831e…

Token contract address.

resolved_fromstringExamplequery

Resolution input.

updated_atstringExample2026-08-27T04:00:00Z

Response update time.

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.