Sign in

v1

latestOpenAPI 3.1.02026-07-243035381.4 MB
Prediction API

Get a prediction market by ID

/v4/data/prediction/markets/{id}

100 credits per API call

Retrieve a single prediction market by its platform-native identifier.

Accepted id formats:

  • Polymarket — condition id (0x + 64 hex characters).
  • Kalshi — market ticker (e.g. KXELONMARS-99). Tickers are uppercase alphanumeric with optional - and _ separators.

Other notes

  • Returns 404 when the market does not exist on either platform.
  • Returns 400 when the id does not match either accepted format.
  • volumeUnit, liquidity and chain follow the same per-platform rules as the listing endpoint.
get/v4/data/prediction/markets/{id}

Path parameters

idstring required
Example:0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917

Platform-native market identifier. Polymarket condition id or Kalshi market ticker.

Response

OK

Example response

{
  "data": {
    "id": "KXELONMARS-99",
    "platform": "polymarket",
    "eventId": "KXELONMARS",
    "question": "Will Elon Musk land humans on Mars by 2030?",
    "description": "Resolves YES if SpaceX confirms a successful crewed Mars landing by 2030-12-31.",
    "category": "Science",
    "tags": [
      "space",
      "spacex"
    ],
    "imageUrl": "https://polymarket.com/images/elon-mars.png",
    "status": "active",
    "openTime": "2024-01-01T00:00:00Z",
    "closeTime": "2030-12-31T23:59:59Z",
    "settleTime": "2031-01-15T00:00:00Z",
    "outcomes": [
      {
        "name": "YES",
        "price": 0.42,
        "tokenId": "71321045679252212594626385532706912750332728571942612009397583165281712267356"
      }
    ],
    "volume": 1542300.12,
    "volumeUnit": "usd",
    "liquidity": 89400.5,
    "resolution": {
      "outcome": "YES",
      "resolvedAt": "2026-04-12T18:00:00Z",
      "txHash": "0x9c1f…",
      "source": "uma"
    },
    "createdAt": "2023-11-21T10:42:00Z",
    "source": {
      "platform": "polymarket",
      "platformId": "KXELONMARS-99",
      "url": "https://kalshi.com/markets/kxelonmars"
    },
    "chain": {
      "chainId": 137,
      "conditionId": "0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917",
      "tokenIds": {
        "yes": "7132104567925221259…",
        "no": "5239841276582930182…"
      },
      "resolutionSource": "https://uma.app/"
    }
  }
}