Wallet - Leaderboard

curl --request GET \
  --url https://public-api.birdeye.so/wallet/v2/leaderboard \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://public-api.birdeye.so/wallet/v2/leaderboard', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "data": [
    {
      "owner": "3QG3aFvShbd6SxN3SdPowYQbokfReLGV6L141kMJQoLc",
      "total_value": 5235177.875046033,
      "trade_count": 82,
      "volume_usd": 2528308.586962412,
      "realized_pnl": -236.30401229077495,
      "unrealized_pnl": 0
    },
    {
      "owner": "226rXSbYUSwux7aHGC2XhhVhnuzazVPYuveGXyAsqvrt",
      "total_value": 27178262.34140204,
      "trade_count": 189,
      "volume_usd": 1575267.9387524147,
      "realized_pnl": -146.38501180820623,
      "unrealized_pnl": 0
    }
  ]
}

{
  "success": false,
  "message": "Bad request"
}

{
  "success": false,
  "message": "Unauthorized"
}

{
  "success": false,
  "message": "Access Denied"
}

{
  "success": false,
  "message": "Too many requests"
}

{
  "success": false,
  "message": "Internal Server Error"
}

GET

wallet

leaderboard

Wallet - Leaderboard

curl --request GET \
  --url https://public-api.birdeye.so/wallet/v2/leaderboard \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://public-api.birdeye.so/wallet/v2/leaderboard', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "data": [
    {
      "owner": "3QG3aFvShbd6SxN3SdPowYQbokfReLGV6L141kMJQoLc",
      "total_value": 5235177.875046033,
      "trade_count": 82,
      "volume_usd": 2528308.586962412,
      "realized_pnl": -236.30401229077495,
      "unrealized_pnl": 0
    },
    {
      "owner": "226rXSbYUSwux7aHGC2XhhVhnuzazVPYuveGXyAsqvrt",
      "total_value": 27178262.34140204,
      "trade_count": 189,
      "volume_usd": 1575267.9387524147,
      "realized_pnl": -146.38501180820623,
      "unrealized_pnl": 0
    }
  ]
}

{
  "success": false,
  "message": "Bad request"
}

{
  "success": false,
  "message": "Unauthorized"
}

{
  "success": false,
  "message": "Access Denied"
}

{
  "success": false,
  "message": "Too many requests"
}

{
  "success": false,
  "message": "Internal Server Error"
}

Usage Note
Accessibility
Chain Supported

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.

Authorizations

X-API-KEY

string

header

required

API key for authentication

Headers

x-chain

enum<string>

default:solana

Solana network only.

Available options:

solana

Query Parameters

from_value

number<float>

default:100000

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

Required range: x >= 100000

to_value

number<float>

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

Required range: x >= 100000

sort_by

enum<string>

default: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.

Available options:

total_value,

trade_count,

volume_usd,

realized_pnl,

unrealized_pnl

interval

enum<string>

default:7d

Time interval used to calculate leaderboard metrics.

Available options:

30m,

1h,

2h,

4h,

6h,

8h,

12h,

24h,

2d,

3d,

7d,

14d,

30d,

60d,

90d,

all_time

pnl_method

enum<string>

default: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.

Available options:

wac,

net_cash

min_trade

integer<uint64>

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

Required range: x >= 0

max_trade

integer<uint64>

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

Required range: x >= 0

min_volume_usd

number<float>

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

Required range: x >= 0

max_volume_usd

number<float>

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

Required range: x >= 0

min_realized_pnl

number<float>

Minimum realized PnL in USD. Can be negative.

max_realized_pnl

number<float>

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

min_unrealized_pnl

number<float>

Minimum unrealized PnL in USD. Can be negative.

max_unrealized_pnl

number<float>

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

limit

integer

default:20

Required range: 1 <= x <= 100

offset

integer

default:0

Make sure offset <= 10000

Required range: 0 <= x <= 10000

Response

JSON object containing the wallet leaderboard ranked by total asset value

success

boolean

required

Whether the request succeeded.

data

object[]

required

Ranked wallets for the requested leaderboard scope.

Show child attributes