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 30 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.

Allowed:
string
enum
required
Defaults to desc

Specify the sort order.

Allowed:
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 6 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 6 days ago

Did this page help you?