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

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,

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.

Available options:

PnL,

realized_pnl,

unrealized_pnl

sort_type

enum<string>

default:desc

required

Specify the sort order.

Available options:

desc,

asc

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