Sign in
Token

Top Transfer Counterparties

Ranked top counterparties (receivers or senders) of a token over a window — answers "who are the top receivers/senders?".

Lookup: address (token contract) + chain + direction (to = top receivers, from = top senders). Rank by metric (count, amount, amount_usd).

Related: raw rows → /v1/token/transfers; aggregate summary → /v1/token/transfer-stats.

Chains: Ethereum, Base, BSC, Arbitrum, Tron · Refresh: ~24h

get/gateway/v1/token/transfer-counterparties

Query parameters

addressstring required

Token CONTRACT ADDRESS (0x-hex for EVM; Tron accepts base58 T... or 0x-hex). Not a ticker — resolve a symbol via GET /v1/search/token?q={symbol}&chain={chain} and use a returned address whose chain is supported by this endpoint.

Example:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48

Token CONTRACT ADDRESS (0x-hex for EVM; Tron accepts base58 T... or 0x-hex). Not a ticker — resolve a symbol via GET /v1/search/token?q={symbol}&chain={chain} and use a returned address whose chain is supported by this endpoint.

chain'ethereum' | 'base' | 'bsc' | 'arbitrum' | 'tron' required

Chain the token contract is deployed on.

Example:ethereum

Chain the token contract is deployed on.

direction'to' | 'from' required

Ranking direction: to = top receivers, from = top senders.

Example:to

Ranking direction: to = top receivers, from = top senders.

metric'count' | 'amount' | 'amount_usd'

Ranking key: count = transfer frequency, amount = decimal-adjusted token sum, amount_usd = USD value sum (USD lags ~3 days; unreliable for recent windows).

Ranking key: count = transfer frequency, amount = decimal-adjusted token sum, amount_usd = USD value sum (USD lags ~3 days; unreliable for recent windows).

time_range'1d' | '7d' | '30d' | '90d'

Look-back window (hard 90d cap).

Look-back window (hard 90d cap).

limitinteger

Results per page.

Results per page.

offsetinteger

Pagination offset.

Pagination offset.

includestring

Comma-separated enrichments. labels attaches an entity label per counterparty.

Example:labels

Comma-separated enrichments. labels attaches an entity label per counterparty.

exclude_labelsstring

Comma-separated entity categories to drop (best-effort): cex, router, amm, bridge. Results may be fewer than limit when top counterparties are infrastructure.

Example:cex,router

Comma-separated entity categories to drop (best-effort): cex, router, amm, bridge. Results may be fewer than limit when top counterparties are infrastructure.

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

Example response

{
  "$schema": "https://example.com/schemas/DataResponseTransferCounterpartyItem.json"
}

Changes

No recorded changes to this endpoint across all 2 revisions of this API.