Tags

Returns all market tag categories ranked by market count.

Request

GET /v3/tags

Query parameters

Parameter	Type	Default	Description
`limit`	integer	100	Max 300
`offset`	integer	0	Pagination offset

Example

curl "https://api.polynode.dev/v3/tags?limit=3&key=YOUR_KEY"

{
  "tags": [
    { "tag": "Sports", "market_count": 575318 },
    { "tag": "Games", "market_count": 522716 },
    { "tag": "Hide From New", "market_count": 447811 }
  ],
  "rows_returned": 3,
  "has_more": true,
  "elapsed_ms": 1241
}

Response fields

Field	Type	Description
`tag`	string	Canonical tag label as stored in the database. Title Case, spaces preserved (e.g. `"US Election"`, `"Trump Presidency"`).
`market_count`	integer	Number of markets with this tag

Using tag values in URLs

The tag value above is the canonical (Title Case) form. When passing a tag in a URL path (e.g. /v3/tags/{slug} or /v3/tags/{slug}/leaderboard), use a lowercase, hyphen-separated form — the API resolves it back to the canonical tag:

URL form	Resolves to
`sports`	`Sports`
`us-election`	`US Election`
`primary-elections`	`primary elections`

The match is case-insensitive and converts hyphens to spaces. If no tag matches, you get 404 {"error":"tag not found","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

Example

Response fields

Using tag values in URLs

​Request

​Query parameters

​Example

​Response fields

​Using tag values in URLs

Request

Query parameters

Example

Response fields

Using tag values in URLs