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

​
Request

GET /v3/conditions/{condition_id}

​
Path parameters

ParameterTypeDescription
condition_idstringMarket 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

FieldTypeNullableDescription
idstringnoCondition ID
position_idsarray<string>noOutcome token IDs (decimal-string-encoded — see note above)
payout_numeratorsarray<integer>noPayout numerators per outcome (non-zero after resolution)
payout_denominatorstringnoPayout denominator
questionstringnoMarket question
slugstringnoMarket URL slug
outcomesarray<string>noOutcome labels
end_datestringyesMarket end date (Postgres timestamp with offset)
activebooleannoCurrently active
closedbooleannoNo longer accepting orders
neg_riskbooleannoMulti-outcome (neg-risk) market
event_slugstringyesParent event slug
event_titlestringyesParent event title
categorystringyesOptional category label
liquiditystring (decimal)noCurrent liquidity, full-precision string
volumestring (decimal)noAll-time volume, full-precision string
tagsarray<string>yesCategory tags in their canonical (Title Case) form
winning_outcome_indexintegeryesWinning outcome (null if unresolved)