v2

latestOpenAPI 3.1.02026-07-316132736.5 KB
V2 - Trades

Get token trades (POST)

Retrieve trades for a specific token or pool with pagination, filtering by swap types, addresses, dates, and amounts. Use POST for complex filter queries.

post/api/2/token/trades

Request body

chainIdstring

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

addressstring

Token or pool contract address

offsetnumber nullable required

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.

label'sniper' | 'insider' | 'bundler' | 'proTrader' | 'smartTrader' | 'freshTrader' | 'dev' | 'liquidityPool' | 'locker'

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

type'buy' | 'sell'

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

maxAmountUSDnumber nullable

Maximum trade amount in USD

minAmountUSDnumber nullable

Minimum trade amount in USD

Response

Token trades response