Discovery

Get market details

Get detailed information about a specific market by ID or slug.

Returns full market information, including tokens, description, and resolution status.

get/v1/markets/{id_or_slug}

Request

Base URL: https://api.polymarketdata.co
URL: https://api.polymarketdata.co/v1/markets/{id_or_slug}
Auth: API key in header X-API-Key

Path parameters

id_or_slugstring required

Market ID or market slug.

Example:618831

Response

Detailed market object with tokens and resolution metadata.

idstring required

Unique market identifier.

slugstring required

Stable URL-friendly market slug.

questionstring nullable

Human-readable market question.

descriptionstring nullable

Long-form market description, if available.

statusstring required

Current market status.

start_datestring date-time nullable

Market start timestamp in ISO 8601 format.

end_datestring date-time nullable

Market end timestamp in ISO 8601 format.

closed_atstring date-time nullable

Timestamp when the market was closed.

resolved_token_idstring nullable

Winning token identifier when market is resolved.

resolved_token_labelstring nullable

Winning token label when market is resolved.

Example response

{
  "description": "Resolves to YES if Candidate X wins the 2025 election.",
  "end_date": "2025-11-05T23:59:59Z",
  "id": "618831",
  "question": "Will Candidate X win the 2025 election?",
  "slug": "will-candidate-x-win-2025",
  "start_date": "2025-09-01T00:00:00Z",
  "status": "open",
  "tokens": [
    {
      "id": "12345",
      "label": "Yes"
    },
    {
      "id": "12346",
      "label": "No"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.