> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bravadotrade.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /leaderboard: Wallet Leaderboard

> Polymarket wallets ranked for a rolling window, with trading-style filters and metric floors. Cursor-paginated.

> [!NOTE]
>
> Sign each request with a fresh HMAC signature. The cURL and HTTP header values below are placeholders, not reusable credentials. For runnable signing code, use [request signing examples](https://docs.bravadotrade.com/authentication-examples.md).

Ranks Polymarket wallets for the requested window by the chosen metric, with trading-style include/exclude and volume/trade floors. Fixed to Polymarket (no `venue` parameter). See [response conventions](https://docs.bravadotrade.com/api/polymarket/overview.md) for the number, timestamp and null rules.

```text theme={null}
GET https://partner-api.bravadotrade.com/v2/polymarket/leaderboard
```

### Query Parameters

**window** `string` (default: all\_time)

Rolling window: one of `1d`, `7d`, `30d`, `all_time`.

**sort\_by** `string`

Rank metric: one of `total_pnl`, `roi`, `win_rate`, `volume`, `trades`.

**order** `string`

Sort direction: `asc` or `desc`.

**style** `string`

Include only wallets carrying this trading style (e.g. `WHALE`, `MARKET_MAKER`). Case-insensitive.

**exclude\_style** `string`

Exclude wallets carrying this trading style.

**min\_volume** `number`

Minimum volume in USD.

**min\_trades** `integer`

Minimum trade count.

**limit** `integer`

Rows per page, up to 100.

**pagination\_key** `string`

Opaque cursor from the previous page's `pagination.pagination_key`.

### Response

**entries** `array`

**entry**

**user** `string`

Wallet address.

**rank** `integer`

1-based rank within this page's ordering.

**entry\_edge** `string`

Decimal string; `null` when unknown.

**first\_trade\_at** `integer`

Unix seconds; `null` when unknown.

**metrics** `object`

Window metrics. `realized_pnl`, `total_pnl`, `volume` (USD decimal strings); `roi`, `win_rate` (`0`–`1` decimals); `trades`, `wins`, `losses`, `positions_closed` (counts); `profit_factor`, `avg_buy_price`, `avg_sell_price`; `fees_paid`, `fees_refunded`. Every field is a decimal string or `null` (see [conventions](https://docs.bravadotrade.com/api/polymarket/overview.md) — `fees_paid` is `null` on day windows, `fees_refunded` is always `null`).

**trading\_styles** `object`

`is_whale`, `is_market_maker`, `is_active_trader`, `is_buy_and_hold`, `is_degen`, `is_high_conviction`, `is_contrarian`, `is_value_hunter` (booleans) and `primary_style` (string or `null`).

**pagination** `object`

`limit`, `count`, `has_more` (boolean), `pagination_key` (string or `null`).

**computed\_at** `integer`

Unix seconds the snapshot was computed.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.