Token - Trade Data (Multiple)

get

https://public-api.birdeye.so/defi/v3/token/trade-data/multiple

Retrieve trade data of multiple tokens. Maximum 20 addresses.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

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.

Compute Unit ⚙️

Use Cases 💡

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.

How to Use 🛠️

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.

Best Practices ✅

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.

Query Params

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

string

enum

Defaults to scaled

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

Allowed:

Headers

x-chain

string

enum

Defaults to solana

A chain name listed in supported networks.

Responses

200JSON object containing trade data of multiple tokens