Tag Leaderboard

Returns a P&L leaderboard filtered to markets with a specific tag. This direct tag route is best for smaller/niche tags.

For broad tags or categories such as crypto, sports, or politics, use the projected global leaderboard with ?tags= or ?category=. It is the preferred route for high-cardinality leaderboard filters.

Request

GET /v3/tags/{slug}/leaderboard

Query parameters

Parameter	Type	Default	Description
`sort`	string	`net_pnl`	Sort by `net_pnl` (default), `volume`, `profit`, or `loss`
`limit`	integer	100	Max 300
`offset`	integer	0	Pagination offset

Slug handling

The tag slug is matched case-insensitively. URL-style hyphens are also converted to spaces, so /v3/tags/us-election/leaderboard resolves to the stored tag US Election.

Broad tag alternative

curl "https://api.polynode.dev/v3/leaderboard?tags=crypto&limit=20"
curl "https://api.polynode.dev/v3/leaderboard?category=crypto&limit=20"

Use GET /v3/leaderboard for broad tag/category rankings or pick a more specific tag for this route.

Example

curl https://api.polynode.dev/v3/tags/taylor-swift/leaderboard?limit=1

{
  "data": [
    {
      "wallet": "0x4aec3e3c555ecbeec58adba532e8ea8b1c76e9b6",
      "net_pnl": "60212.914000000000",
      "gross_profit": "60212.914000000000",
      "gross_loss": "0.000000000000000000",
      "total_volume": "62721.000000000000",
      "position_count": 3
    }
  ],
  "rows_returned": 1,
  "has_more": true,
  "offset": 0,
  "limit": 1,
  "elapsed_ms": 26
}

Response fields (per row in `data`)

Field	Type	Description
`wallet`	string	Wallet address
`net_pnl`	string (decimal)	Net realized P&L in this tag (USD)
`gross_profit`	string (decimal)	Sum of winning positions (USD)
`gross_loss`	string (decimal)	Sum of losing positions (USD, negative or zero)
`total_volume`	string (decimal)	Total volume traded in this tag (USD)
`position_count`	integer	Number of positions in markets with this tag

Overview

V3 Data API

Wallet P&L

Wallet Activity

Credits

Identity

Fees

Combos

Rewards

Markets & Search

Orderbook

Leaderboard & Tags

Builders

Polymarket Profiles

Global

Tokens

Perps

Perps Market Data

Perps Wallets

Perps Analytics

Perps On-Chain

Perps Streaming

Crypto

Sports

BYOL

Backtesting

Market Card

System

Search & Context

Onchain V2 (legacy)

Request

Query parameters

Slug handling

Broad tag alternative

Example

Response fields (per row in `data`)

​Request

​Query parameters

​Slug handling

​Broad tag alternative

​Example

​Response fields (per row in data)

Request

Query parameters

Slug handling

Broad tag alternative

Example

Response fields (per row in `data`)