API Endpoints

Trader - Gainers/Losers

get
https://public-api.birdeye.so/trader/gainers-losers

Retrieve detailed information about top gainers/losers

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

Top gaining and losing traders.

  • limit supports up to 100, and offset supports up to 10,000.
  • Use type to choose the ranking window and mode.
  • sort_by and sort_type control the ranking basis and order.
Compute Unit ⚙️
  • This endpoint consumes 25 CU per request.
Use Cases 💡
  • Rank top performing and worst performing traders over a selected window.
  • Build gainers/losers trader boards and wallet discovery tools.
  • Find unusual outperformers or underperformers for further wallet research.
How to Use 🛠️
  • Set x-chain for the target network.
  • Choose the ranking type, sort_by, and sort_type.
  • Page through the trader list with offset and limit.
Best Practices ✅
  • Treat leaderboard position as a discovery signal, not a conclusion; follow up with wallet-level PnL and transaction review.
  • Keep the selected time window visible so gains and losses are interpreted correctly.

Query Params
string
enum
required
Defaults to 1W

Specify the type of top gainers/losers. Filter for records with type equal to the specified type.

Allowed:
string
enum
required
Defaults to PnL

Specify the sort field. Use trader_score to rank traders by an overall 0–100 score based on profitability, consistency, trading quality, and activity relative to other eligible traders. Higher scores indicate stronger overall trading performance.

Allowed:
uint64
≥ 0

Minimum number of trades. Must be greater than or equal to 0.

uint64
≥ 0

Maximum number of trades. Must be greater than or equal to min_trade.

float
≥ 0

Minimum trading volume in USD. Must be greater than or equal to 0.

float
≥ 0

Maximum trading volume in USD. Must be greater than or equal to min_volume_usd.

float

Minimum realized PnL in USD. Must be greater than or equal to 1000. Defaults to 1000 when sort_by=realized_pnl and this parameter is not provided.

float

Maximum realized PnL in USD. Must be greater than or equal to min_realized_pnl.

float

Minimum unrealized PnL in USD. Must be greater than or equal to 1000. Defaults to 1000 when sort_by=unrealized_pnl and this parameter is not provided..

float

Maximum unrealized PnL in USD. Must be greater than or equal to min_unrealized_pnl.

float

Minimum PnL in USD. Must be greater than or equal to 1000. Defaults to 1000 when sort_by=PnL and this parameter is not provided.

float

Maximum PnL in USD. Must be greater than or equal to min_pnl.

integer
0 to 10000
Defaults to 0

Pagination start position. offset + limit <= 10000

integer
1 to 100
Defaults to 20
Headers
string
enum
Defaults to solana

A chain name listed in supported networks.

Responses

Updated 2 months 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 2 months ago

Did this page help you?