Token

Token DEX Trade History

Changed on

Returns recent DEX swap events for a token contract address.

Covered DEXes: uniswap, sushiswap, curve, balancer, pancakeswap (and other major DEXes per chain).

Included fields: trading pair, amounts, USD value, taker address.

Data refresh: ~24 hours · Chains: Ethereum, Base, BSC, Arbitrum, Tron, Robinhood

get/gateway/v1/token/dex-trades

Request

  • Base URL
    https://api.asksurf.ai
  • Auth
    HTTP bearer

Query parameters

addressstring required

Token CONTRACT ADDRESS — 0x-prefixed hex (EVM chains only; Tron also accepts base58 T...). 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
chain'ethereum' | 'base' | 'bsc' | 'arbitrum' | 'tron' | 'robinhood'

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

Example:ethereum
limitinteger

Results per page

Example:20
offsetinteger

Pagination offset

includestring

Comma-separated enrichments to attach to each trade. Currently valid: labels — adds a taker_label field with entity information for the taker address.

Example:labels

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

Example response

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

Changes