API Endpoints

Wallet - Leaderboard

get
https://public-api.birdeye.so/wallet/v2/leaderboard

Retrieve the wallet leaderboard sorted by total asset value in descending order.

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

Wallet leaderboard by total asset value.

  • limit supports 1 to 100, and offset supports up to 10,000.
  • from_value defaults to 100,000 and cannot go below that threshold.
  • to_value, when provided, must be greater than from_value.
  • Results are sorted by total asset value in descending order.
Compute Unit ⚙️
  • This endpoint consumes 25 CU per request.
Use Cases 💡
  • Build whale leaderboards and wallet-rich-list style screens.
  • Slice wallet rankings by value bands for cohort analysis.
  • Find large wallets worth investigating further with PnL or funding endpoints.
How to Use 🛠️
  • Set x-chain=solana.
  • Use from_value and optional to_value to define the wallet band.
  • Page through the leaderboard with offset and limit.
Best Practices ✅
  • Use the leaderboard as a discovery layer, then drill into individual wallets with net-worth and PnL endpoints.
  • Keep value bands explicit so comparisons stay meaningful across screens.
Limitations ⚠️
  • Solana only.
  • from_value has a hard floor of 100,000.

Query Params
float
≥ 100000
Defaults to 100000

Minimum total value filter. Defaults to 100,000 and must be greater than or equal to 100,000.

float
≥ 100000

Maximum total value filter. Must be greater than or equal to 100,000 and greater than from_value.

string
enum
Defaults to total_value

Field used to sort leaderboard results.
Supported values:

  • total_value: Total wallet value in USD.
  • trade_count: Total number of trades.
  • volume_usd: Total trading volume in USD.
  • realized_pnl: Realized profit and loss in USD.
  • unrealized_pnl: Unrealized profit and loss in USD.
Allowed:
string
enum
Defaults to 7d

Time interval used to calculate leaderboard metrics.

string
enum
Defaults to net_cash

PNL calculation method. wac (Weighted Average Cost): calculates PNL for each sell against the average cost of the position held at the time of the sell. Buys only re-average the cost of the remaining inventory, and previously realized sell PNL is not affected by later trades. net_cash (Net Cash): calculates PNL across the full trade history using the spread between cumulative average sell price and cumulative average buy price. The buy average includes all buys and is not reduced by sells, so later buys can change the reported PNL.

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. Can be negative.

float

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

float

Minimum unrealized PnL in USD. Can be negative.

float

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

integer
1 to 100
Defaults to 20
integer
0 to 10000
Defaults to 0

Make sure offset <= 10000

Headers
string
enum
Defaults to solana

Solana network only.

Allowed:
Responses

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

Did this page help you?