Tag Markets

Returns every market tagged with the given slug. Useful for building category landing pages or filtering search results.

Request

GET /v3/tags/{slug}

Path parameters

Parameter	Type	Description
`slug`	string	Tag slug. Matched case-insensitively. URL-style hyphens are converted to spaces, so `us-election` resolves to the stored tag `US Election`.

Query parameters

Parameter	Type	Default	Description
`sort`	string	`volume_all_time`	Sort by `volume_all_time`, `liquidity`, or `created_at`.
`limit`	integer	100	Max 300
`offset`	integer	0	Pagination offset

Example

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

{
  "data": [
    {
      "condition_id": "0x61ef853c0ecc72a583da722cf6434681f9b92d10652cded44d8f889beb923418",
      "question": "Dvalishvili vs. Sandhagen",
      "slug": "ufc-dvalishvili-vs-sandhagen-2025-10-04",
      "outcomes": ["Dvalishvili", "Sandhagen"],
      "category": null,
      "active": true,
      "closed": true,
      "neg_risk": false,
      "volume_all_time": "999731.6550259999930858612060546875",
      "liquidity": "0",
      "end_date": "2025-10-11 18:00:00+00",
      "event_slug": "ufc-320-ankalaev-vs-pereira-2",
      "event_title": "UFC 320: Ankalaev vs. Pereira 2",
      "winning_outcome_index": 0
    }
  ],
  "rows_returned": 1,
  "has_more": true,
  "offset": 0,
  "limit": 1,
  "elapsed_ms": 42
}

Response fields (per row in `data`)

Field	Type	Description
`condition_id`	string	Market condition ID
`question`	string	Market question text
`slug`	string	Market URL slug
`outcomes`	array<string>	Outcome labels
`category`	string \| null	Optional category label
`active`	boolean	Market is currently active
`closed`	boolean	Market is closed (no longer accepting orders)
`neg_risk`	boolean	Neg-risk (multi-outcome) market
`volume_all_time`	string (decimal)	All-time USD volume
`liquidity`	string (decimal)	Current liquidity in USD
`end_date`	string \| null	Market resolution deadline (ISO timestamp with offset)
`event_slug`	string \| null	Parent event slug
`event_title`	string \| null	Parent event title
`winning_outcome_index`	integer \| null	Winning outcome (null if unresolved)

Errors

If no tag matches the slug (case-insensitive, hyphen-converted), the endpoint returns 404 with:

{"error": "tag not found", "tag": "notarealtag"}

For a wallet-level P&L leaderboard scoped to a tag, see Tag Leaderboard.

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

Path parameters

Query parameters

Example

Response fields (per row in `data`)

Errors

​Request

​Path parameters

​Query parameters

​Example

​Response fields (per row in data)

​Errors

Request

Path parameters

Query parameters

Example

Response fields (per row in `data`)

Errors