Skip to main content
GET
Token - Trade Data (Multiple)

Batch trading-activity stats for multiple tokens.

  • Pass token addresses as a comma-separated list in list_address.
  • Maximum batch size is 20 token addresses per request.
  • Use frames to request the same set of timeframes for every token in the batch.
  • Returns trade, wallet, buy/sell, volume, and change metrics for indexed tokens across the same requested time windows.
  • Batch CU is calculated as ceil(10 * count^0.8).
  • Compare trading activity across a watchlist or screener result set.
  • Detect volume spikes and buy/sell pressure across many tokens with fewer API calls.
  • Compare which tokens are attracting fresh participation or losing activity across the same recent windows.
  • Rank tokens by recent participation, trade count, and volume momentum.
  • Feed batch trade metrics into bots, alerting systems, and analytics pipelines.
  • Set x-chain for the target network.
  • Pass list_address as comma-separated token addresses.
  • Use the same frames across the batch so every token is comparable.
  • Use this endpoint when you want multi-token activity windows, not just current price or valuation snapshots.
  • Use the single endpoint for drill-down views after a user selects one token.
  • Use batch trade data for screeners and alerts where every token should be scored on the same timeframe set.
  • Deduplicate addresses and keep the requested frame list consistent.
  • Join with batch market data to rank both market quality and current activity.

Authorizations

​
X-API-KEY
string
header
required

API key for authentication

Headers

​
x-chain
enum<string>
default:solana

A chain name listed in supported networks.

Available options:
solana,
ethereum,
bsc,
base,
robinhood,
sui,
mantle,
hyperevm,
arbitrum,
avalanche,
optimism,
polygon,
zksync,
monad,
aptos,
fogo,
megaeth

Query Parameters

​
list_address
string
required

A list of token addresses in string separated by commas (,)

​
frames
string

A list of custom time intervals separated by comma (,). Users can pass up to 8 intervals. Rules:

  • Minute intervals: from 1m up to 1440m (e.g. 1m,15m,16m,17m,89m,90m,92m,1440m ...).
  • Second intervals: must be multiples of 5s, from 5s up to 3600s (e.g. 5s,10s,15s,90s,3600s ...).
  • Hours intervals: only support (1h 2h 4h 8h 24h)
​
ui_amount_mode
enum<string>
default:scaled

Indicate whether to use the scaled amount for scaled ui amount tokens. Only support solana

Available options:
raw,
scaled

Response

JSON object containing trade data of multiple tokens

​
success
boolean
required

Whether the request completed successfully.

​
data
object
required

Map keyed by token address. Each value is the token trade-data object for that token, or null when trade data is unavailable.