Get Polymarket Market Details

Retrieve comprehensive details about a specific Polymarket market.

What you get:

• Market title and description
• Resolution rules
• Current status (active/resolved)
• End date and settlement info
• Condition ID (needed for orderbook/trades)
• Category and event association

Use cases:

• Display market information
• Get condition_id for orderbook queries
• Check resolution criteria

Note: Polymarket uses poly_id for market lookup, but orderbook/trade endpoints require the condition_id (hex string starting with 0x).

GET /api/v1/poly/{poly_id}/market

200

{
  "condition_id": "<string>",
  "id": "<string>",
  "title": "<string>",
  "rules": "<string>",
  "closed": true,
  "closed_time": 123,
  "x": [
    "<string>"
  ],
  "y": [
    "<string>"
  ],
  "action": [
    "<string>"
  ],
  "inserted_at": "2023-11-07T05:31:56Z",
  "delphi_id": "<string>",
  "end_date": "2023-11-07T05:31:56Z",
  "category": "<string>",
  "event_id": "<string>",
  "resolution": "<string>",
  "winning_outcome": "<string>"
}

Authorizations

X-API-Key · string · header · required

Your API key (get one from the test-key endpoint above)

Path Parameters

poly_id · string · required

Polymarket market ID

Response

200

application/json

Market details

condition_id · string

id · string

title · string

rules · string

closed · boolean

closed_time · integer | null

x · (string | null)[]

y · (string | null)[]

action · (string | null)[]

inserted_at · string<date-time>

Timestamp when this record was ingested

delphi_id · string | null

end_date · string<date-time> | null

category · string | null

event_id · string

resolution · string

Market resolution status

winning_outcome · string

Winning outcome of the market