Trader - Gainers/Losers

curl --request GET \
  --url https://public-api.birdeye.so/trader/gainers-losers \
  --header 'X-API-KEY: <api-key>'

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

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

{
  "success": true,
  "data": {
    "items": [
      {
        "address": "1JKP3jcMcBzpp5SUSj9DFMFZGiJiXLyuRyGYcf6E97z",
        "pnl": 67395290.55367899,
        "realized_pnl": 761218.7928862367,
        "unrealized_pnl": 66634071.76079275,
        "volume": 7103127.149509426,
        "trade_count": 83,
        "network": "solana"
      },
      {
        "address": "81m9aRw8RSAKchZ6pZo1L8m6DeJskq8hLZoTLU5gzoUc",
        "pnl": 64080474.36939919,
        "realized_pnl": -26045.200510758965,
        "unrealized_pnl": 64106519.56990995,
        "volume": 971495.1923311986,
        "trade_count": 82,
        "network": "solana"
      }
    ]
  }
}

GET

trader

gainers-losers

Trader - Gainers/Losers

curl --request GET \
  --url https://public-api.birdeye.so/trader/gainers-losers \
  --header 'X-API-KEY: <api-key>'

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

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

{
  "success": true,
  "data": {
    "items": [
      {
        "address": "1JKP3jcMcBzpp5SUSj9DFMFZGiJiXLyuRyGYcf6E97z",
        "pnl": 67395290.55367899,
        "realized_pnl": 761218.7928862367,
        "unrealized_pnl": 66634071.76079275,
        "volume": 7103127.149509426,
        "trade_count": 83,
        "network": "solana"
      },
      {
        "address": "81m9aRw8RSAKchZ6pZo1L8m6DeJskq8hLZoTLU5gzoUc",
        "pnl": 64080474.36939919,
        "realized_pnl": -26045.200510758965,
        "unrealized_pnl": 64106519.56990995,
        "volume": 971495.1923311986,
        "trade_count": 82,
        "network": "solana"
      }
    ]
  }
}

Usage Note
Accessibility
Chain Supported

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 controls the ranking basis.

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 and sort_by.
Use min_trade and max_trade to filter by the number of trades.
Use min_volume_usd and max_volume_usd to filter by trading volume.
Use the realized, unrealized, or total PnL min/max filters to narrow the ranked traders by USD PnL.
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.

Authorizations

X-API-KEY

string

header

required

API key for authentication

Headers

x-chain

enum<string>

default:solana

A chain name listed in supported networks.

Available options:

solana,

ethereum,

bsc,

base,

robinhood,

arc,

sui,

mantle,

hyperevm,

arbitrum,

avalanche,

optimism,

polygon,

zksync,

monad,

aptos,

fogo,

megaeth

Query Parameters

type

enum<string>

default:1W

required

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

Available options:

yesterday,

today,

1W,

30d,

90d

sort_by

enum<string>

default:PnL

required

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.

Available options:

PnL,

realized_pnl,

unrealized_pnl,

trader_score

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. Must be greater than or equal to 1000. Defaults to 1000 when sort_by=realized_pnl and this parameter is not provided.

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. Must be greater than or equal to 1000. Defaults to 1000 when sort_by=unrealized_pnl and this parameter is not provided..

max_unrealized_pnl

number<float>

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

min_pnl

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

max_pnl

number<float>

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

offset

integer

default:0

Pagination start position. offset + limit <= 10000

Required range: 0 <= x <= 10000

limit

integer

default:20

Required range: 1 <= x <= 100

Response

JSON object containing a list of top gainer loser traders

success

boolean

required

Indicates whether the request was successful.

data

object

required

Contains the trader gainer/loser result.

Show child attributes