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
What each request returns
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.