API Endpoints

Token - Top traders

get
https://public-api.birdeye.so/defi/v2/tokens/top_traders

Rank the top trader trading a token by volume, trade count, PnL, USD volume, or Solana holder position metrics. On Solana, the response can include wallet tags, current holding stats, average buy/sell prices, first and last trade time, and optional holder net worth and funding details.

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

Top traders ranks wallets by token trading impact and, on Solana, adds holder stats context.

  • Use sort_by=volume or sort_by=trade for activity leaders.
  • Use sort_by=total_pnl, realized_pnl, unrealized_pnl, or volume_usd for PnL and USD-volume views on supported chains.
  • On Solana, use sort_by=hold_volume to rank traders by the amount they still hold.
  • On Solana, wallet_tags filters the result by wallet cohort. Supported values are dev, bundler, sniper, insider, and smart_trader.
  • On Solana, get_holders_networth=true adds netWorth, solBalance, and funding to each trader item. This enriches holder stats but may make the response slightly slower.

Reading the numbers. tradeBuy and tradeSell count buy and sell transactions. volumeBuy and volumeSell are token amounts; volumeBuyUSD, volumeSellUSD, and volumeUsd are USD values. holdVolume, holdVolumeUsd, and holdAvgPrice describe the current remaining holder position. avgBuyPrice and avgSellPrice summarize historical trade prices. firstTradeUnixTime and lastTradeUnixTime are Unix timestamps in seconds.

Wallet Tag Definitions 🏷️
  • dev — The wallet that created the token, based on the mint creator / initialize-mint transaction.
  • sniper — A wallet that bought within the first n blocks of the token, counted from the token's first swap. On Solana, n = 5; a buy qualifies when its slot is within first_trade_slot + 5.
  • bundler — Coordinated buying detected at either level: Level 1 means at least 4 buy transactions in the same slot; Level 2 means at least 3 distinct wallets buying across adjacent slots where the max slot gap is 1.
  • insider — A wallet that received the token directly from the Chef wallet through a token transfer, not through a swap.
  • smart_trader — A non-bot wallet ranked in Top Realized PnL over the last 90 days with realized PnL greater than $10,000. Wallets identified as bots are excluded before ranking and never receive this tag.
Compute Unit ⚙️
  • This endpoint consumes 35 CU per request.
Use Cases 💡
  • Find the wallets that drove most token volume, trade count, or PnL during a launch or trading window.
  • Identify whether top traders are still holding, accumulating, or selling by comparing holdVolume against buy/sell activity.
  • Filter Solana results by wallet cohort to inspect developers, bundlers, snipers, insiders, or smart traders separately.
  • Use get_holders_networth=true to enrich wallet research with net worth, SOL balance, and funding source context.
  • Build token research dashboards that combine trader ranking, wallet tags, holder position stats, and PnL.
How to Use 🛠️
  • Provide a token address and choose x-chain.
  • Pick time_frame based on the analysis window. Solana additionally supports all_time.
  • Pick sort_by: use volume, trade, total_pnl, realized_pnl, unrealized_pnl, volume_usd, or Solana-only hold_volume.
  • On Solana, pass wallet_tags=dev,sniper,smart_trader to filter by wallet cohorts.
  • On Solana, set get_holders_networth=true when you need net worth, SOL balance, and funding details.
  • Use offset and limit to page through ranked traders.
Best Practices ✅
  • Start with sort_by=volume or trade to find active wallets, then switch to PnL or holder fields to understand outcomes.
  • Use hold_volume on Solana to separate traders who exited from traders still exposed to the token.
  • Compare realizedPnl and unrealizedPnl with holdVolumeUsd to distinguish realized profit from open exposure.
  • Use wallet tag filters to reduce noise when investigating launch behavior or suspicious cohorts.
  • Enable get_holders_networth only when holder net worth and funding context are needed, because it may add latency.
Limitations ⚠️
  • all_time, hold_volume, wallet_tags, holder position stats, and get_holders_networth are Solana-only additions.
  • Non-Solana chains keep their existing supported intervals, sort fields, parameters, and response behavior.
  • wallet_tags accepts dev, bundler, sniper, insider, and smart_trader.
  • get_holders_networth=true may return netWorth or solBalance as 0 when holder net worth data is unavailable.
  • Results are paginated with offset and limit.

Query Params
string
required

The address of the token contract.

string
enum
required
Defaults to 24h
string
enum
required
Defaults to desc

Specify the sort order.

Allowed:
string
enum
required
Defaults to volume

Specify the sort field.

Allowed:
integer
0 to 10000
Defaults to 0

Pagination start position. offset + limit <= 10000

integer
1 to 10
Defaults to 10

Number of items per page.

string
enum
Defaults to scaled

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

Allowed:
wallet_tags
array of strings

Filter Solana traders by wallet tags. Supports comma-separated values.

wallet_tags
Allowed:
boolean
Defaults to false

Solana only. When true, the response includes netWorth, solBalance, and funding for each trader. This may make the response slightly slower than when disabled.

Headers
string
enum
Defaults to solana

A chain name listed in supported networks.

Responses

Updated 1 day 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 1 day ago

Did this page help you?