Get token trades

chainIdstring

Blockchain chain ID (e.g., "evm:56", "solana:solana")

addressstring

Token or pool contract address

offsetnumber nullable

Offset for pagination (default: 0)

limitnumber nullable

Number of trades per page (default: 10)

sortOrder'asc' | 'desc' required

Sort order: asc or desc (default: desc)

mode'pair' | 'pool' | 'asset' required

Query mode: "pair" (pool address), "asset" (token address). Auto-detects if omitted.

Filter by wallet label (e.g., sniper, insider, bundler)

string

OR

string[]

Comma-separated swap types to filter (e.g., "REGULAR,MEV")

type'buy' | 'sell'

Filter by trade direction: "buy" or "sell"

string

OR

string[]

Comma-separated wallet addresses to filter (max 25)

maxAmountUSDnumber nullable

Maximum trade amount in USD

minAmountUSDnumber nullable

Minimum trade amount in USD

integer nullable

OR

string nullable

OR

{"stackTrail":"paths:/api/2/token/trades:get:parameters:12:schema:anyOf:2","oasType":"schema","type":"unknown","nullable":true}

Start date filter (timestamp or ISO string)

integer nullable

OR

string nullable

OR

{"stackTrail":"paths:/api/2/token/trades:get:parameters:13:schema:anyOf:2","oasType":"schema","type":"unknown","nullable":true}

End date filter (timestamp or ISO string)

v2