API Endpoints

Token - Trade Data (Single)

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

Retrieve trade data of a specified token.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Focused trading-activity stats for one token.

  • Returns buy/sell counts, trade counts, unique wallets, volume, and change metrics across requested timeframes.
  • Use frames to request one or more custom timeframes.
  • Use this endpoint when you need timeframe-based market activity around the current price, not just the current market snapshot.
  • Use ui_amount_mode=scaled for Solana Token-2022 scaled UI amounts when the token supports scaled UI amount extension.

Reading the numbers. Buy/sell counts and volumes describe activity inside each timeframe. Change-percent fields compare the current timeframe window with the previous matching window, which makes this endpoint useful for reading recent momentum and participation around price moves.

Compute Unit ⚙️
  • 12 CU per request.
Use Cases 💡
  • Analyze buy/sell pressure and trading activity for a single token.
  • Build momentum indicators using trade counts, unique wallets, and volume over selected frames.
  • Study how participation and turnover changed across recent windows before or after a price move.
  • Trigger alerts when trading activity, volume, or buy/sell imbalance changes quickly.
  • Combine with market data to explain whether valuation changes are backed by real activity.
How to Use 🛠️
  • Provide address as the token address and set x-chain.
  • Use frames=5m,1h,24h style requests for the horizons your product displays.
  • Use shorter frames when you care about recent momentum and reaction, and longer frames when you care about broader context.
  • Set ui_amount_mode=raw or scaled consistently with your Token-2022 amount handling.
  • Use Token Overview when you need both market fundamentals and trade activity in one payload.
Best Practices ✅
  • Pair trade counts with unique-wallet counts to separate broad market participation from repeated activity by a smaller wallet set.
  • Compare buy and sell volume together instead of reading total volume alone.
  • Use shorter frames for alerts and longer frames for ranking or trend summaries.

Query Params
string
required

The address of the token contract.

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)
string
enum
Defaults to scaled

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

Allowed:
Headers
string
enum
Defaults to solana

A chain name listed in supported networks.

Responses

Updated 12 days ago

Did this page help you?
Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 12 days ago

Did this page help you?