Sign in

v1

latestOpenAPI 3.1.02026-07-243035381.4 MB
Prediction API

Get a prediction-market event by ID

/v4/data/prediction/events/{id}

100 credits per API call

Retrieve a single prediction-market event by its platform-native identifier. Useful for hydrating event detail pages or following links from a listing.

Accepted id formats:

  • Polymarket — numeric event id (e.g. 12345).
  • Kalshi — event ticker (e.g. KXELONMARS). Tickers are uppercase alphanumeric with optional - and _ separators.

Other notes

  • Returns 404 when the event does not exist on either platform.
  • Returns 400 when the id does not match either accepted format.
  • markets is populated only when includeMarkets=true is passed; otherwise it is null.
  • volumeUnit and totalLiquidity follow the same per-platform rules as the listing endpoint.
get/v4/data/prediction/events/{id}

Path parameters

idstring required
Example:KXELONMARS

Platform-native event identifier. Polymarket numeric id or Kalshi event ticker.

Query parameters

includeMarketsboolean

When true, the event includes its full nested markets[] array. Defaults to false.

Response

OK

Example response

{
  "data": {
    "id": "KXELONMARS",
    "platform": "polymarket",
    "title": "Will Elon Musk land humans on Mars by 2030?",
    "description": "Outcome resolves on confirmation of a successful crewed Mars landing.",
    "category": "Science",
    "tags": [
      "space",
      "spacex"
    ],
    "imageUrl": "https://polymarket.com/images/elon-mars-event.png",
    "status": "active",
    "openTime": "2024-01-01T00:00:00Z",
    "closeTime": "2030-12-31T23:59:59Z",
    "marketCount": 3,
    "totalVolume": 4823100.5,
    "volumeUnit": "usd",
    "totalLiquidity": 271800.3,
    "markets": [
      "KXELONMARS-99"
    ],
    "source": {
      "platform": "polymarket",
      "platformId": "KXELONMARS-99",
      "url": "https://kalshi.com/markets/kxelonmars"
    }
  }
}