Sign in
Token

Token Transfer History

Returns recent transfer events for a specific token (ERC-20/TRC-20 contract).

Pass the token contract address in address — returns every on-chain transfer of that token regardless of sender/receiver.

Included fields: sender, receiver, raw amount, block timestamp.

Use this to analyze a token's on-chain activity (e.g. large movements, distribution patterns).

Lookup: address (token contract) + chain. Sort by asc or desc.

Data refresh: ~24 hours · Chains: Ethereum, Base, BSC, Arbitrum, Tron (Solana uses a different source with no delay)

get/gateway/v1/token/transfers

Query parameters

addressstring required

Token CONTRACT ADDRESS — 0x-prefixed hex for EVM chains, base58 for Solana. This is NOT a ticker symbol (e.g. do NOT pass USDC or BTC). To resolve a ticker symbol to a contract address, call GET /v1/search/token?q={symbol}&chain={chain} and use the address whose chain is supported by this endpoint. This endpoint has no symbol parameter.

Example:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48

Token CONTRACT ADDRESS — 0x-prefixed hex for EVM chains, base58 for Solana. This is NOT a ticker symbol (e.g. do NOT pass USDC or BTC). To resolve a ticker symbol to a contract address, call GET /v1/search/token?q={symbol}&chain={chain} and use the address whose chain is supported by this endpoint. This endpoint has no symbol parameter.

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

Chain. Can be ethereum, base, solana, tron, bsc, or arbitrum.

Example:ethereum

Chain. Can be ethereum, base, solana, tron, bsc, or arbitrum.

fromstring

Start of date range. Accepts Unix seconds or YYYY-MM-DD. Defaults to 30 days ago.

Example:2025-01-01

Start of date range. Accepts Unix seconds or YYYY-MM-DD. Defaults to 30 days ago.

tostring

End of date range. Accepts Unix seconds or YYYY-MM-DD. Defaults to today.

Example:2025-03-01

End of date range. Accepts Unix seconds or YYYY-MM-DD. Defaults to today.

limitinteger

Results per page

Example:20

Results per page

offsetinteger

Pagination offset

Pagination offset

includestring

Comma-separated enrichments to attach to each transfer. Currently valid: labels — adds from_label and to_label fields.

Example:labels

Comma-separated enrichments to attach to each transfer. Currently valid: labels — adds from_label and to_label fields.

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

Example response

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

Changes

No recorded changes to this endpoint across all 1 revision of this API.