Tags

List all market tags with the number of markets in each category.

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":...}.