Condition Detail

Returns full condition data for a market, including payout structure, outcomes, and enriched market metadata.

Request

GET /v3/conditions/{condition_id}

Path parameters

Parameter	Type	Description
`condition_id`	string	Market condition ID (0x-prefixed)

Example

curl "https://api.polynode.dev/v3/conditions/0x6c4d221b3cf2c8d17467c70a8aa3c714e30299b6e57cd3e4269dc8a41d2b0cd8?key=YOUR_KEY"

{
  "id": "0x6c4d221b3cf2c8d17467c70a8aa3c714e30299b6e57cd3e4269dc8a41d2b0cd8",
  "position_ids": [
    "30698649476690694814108493145041085718609914990967907518412053225237708492787",
    "43362318061877762261164265810725209343672429810065542703856317173848260953021"
  ],
  "payout_numerators": [0, 1],
  "payout_denominator": "1",
  "question": "Will Trump pardon Joe Exotic \"The Tiger King\" in 2025?",
  "slug": "will-trump-pardon-joe-exotic-the-tiger-king-in-2025-784-928-365",
  "outcomes": ["Yes", "No"],
  "end_date": "2025-12-31 12:00:00+00",
  "active": true,
  "closed": true,
  "neg_risk": false,
  "event_slug": "who-will-trump-pardon-in-2025",
  "event_title": "Who will Trump pardon in 2025?",
  "category": null,
  "liquidity": "0",
  "volume": "99993.937724000003072433173656463623046875",
  "tags": ["Politics", "Trump", "SBF", "cz", "Trump Presidency", "Ghislaine Maxwell"],
  "winning_outcome_index": 1,
  "elapsed_ms": 6
}

position_ids are decimal strings, not JSON numbers. Polymarket token IDs are 78-digit values that exceed IEEE 754 float precision — any JSON parser that decodes them as floats will corrupt the lower digits. Always treat them as strings. volume and liquidity are returned at full database precision (up to ~50 digits after the decimal). Round them on the client; do not store as a JS Number.

Response fields

Field	Type	Nullable	Description
`id`	string	no	Condition ID
`position_ids`	array<string>	no	Outcome token IDs (decimal-string-encoded — see note above)
`payout_numerators`	array<integer>	no	Payout numerators per outcome (non-zero after resolution)
`payout_denominator`	string	no	Payout denominator
`question`	string	no	Market question
`slug`	string	no	Market URL slug
`outcomes`	array<string>	no	Outcome labels
`end_date`	string	yes	Market end date (Postgres timestamp with offset)
`active`	boolean	no	Currently active
`closed`	boolean	no	No longer accepting orders
`neg_risk`	boolean	no	Multi-outcome (neg-risk) market
`event_slug`	string	yes	Parent event slug
`event_title`	string	yes	Parent event title
`category`	string	yes	Optional category label
`liquidity`	string (decimal)	no	Current liquidity, full-precision string
`volume`	string (decimal)	no	All-time volume, full-precision string
`tags`	array<string>	yes	Category tags in their canonical (Title Case) form
`winning_outcome_index`	integer	yes	Winning outcome (null if unresolved)

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

Example

Response fields

​Request

​Path parameters

​Example

​Response fields

Request

Path parameters

Example

Response fields