Prediction Router
API Reference

Sample Responses

Real API responses from each supported prediction market platform

All responses below are live examples captured from the prediction router API.

Base URL: https://prediction-router-api.kalashshah47.workers.dev


Polymarket

Polymarket markets are sourced from the Gamma API and include binary Yes/No outcomes with real-money prices in USD.

curl "https://prediction-router-api.kalashshah47.workers.dev/v1/markets?platform=polymarket&q=election&limit=2" \
  -H "Authorization: Bearer pr_..."
{
  "markets": [
    {
      "id": "540817",
      "platform": "polymarket",
      "title": "New Rihanna Album before GTA VI?",
      "outcomes": [
        { "id": "0", "label": "Yes", "probability": 0.51, "price": 0.51 },
        { "id": "1", "label": "No",  "probability": 0.49, "price": 0.49 }
      ],
      "volume": 832995.13,
      "liquidity": 14091.03,
      "status": "open",
      "resolution": null,
      "closeTime": "2026-07-31",
      "url": "https://polymarket.com/event/new-rhianna-album-before-gta-vi-926"
    }
  ]
}

Kalshi

Kalshi markets are US-regulated event contracts. The ticker is the native Kalshi market ID. Outcomes are always YES and NO.

curl "https://prediction-router-api.kalashshah47.workers.dev/v1/markets?platform=kalshi&limit=2" \
  -H "Authorization: Bearer pr_..."
{
  "markets": [
    {
      "id": "KXFED-0625",
      "platform": "kalshi",
      "title": "Fed rate cut in June 2025?",
      "outcomes": [
        { "id": "yes", "label": "Yes", "probability": 0.28, "price": 0.28 },
        { "id": "no",  "label": "No",  "probability": 0.72, "price": 0.72 }
      ],
      "volume": 312000,
      "liquidity": 48000,
      "status": "open",
      "resolution": null,
      "closeTime": "2025-06-18T18:00:00.000Z",
      "url": "https://kalshi.com/markets/kxfed-0625"
    }
  ]
}

Market schema reference

Every market returned by the router conforms to this shape:

FieldTypeDescription
idstringPlatform-native market ID
platformstringSource platform
titlestringMarket question
descriptionstring?Optional longer description
outcomesOutcome[]Array of possible outcomes
outcomes[].idstringOutcome identifier
outcomes[].labelstringHuman-readable label
outcomes[].probabilitynumberCurrent implied probability (0–1)
outcomes[].pricenumberCurrent price per share (0–1)
volumenumberTotal trading volume in platform currency
liquiditynumber?Available liquidity (if provided by platform)
statusopen | closed | resolvedMarket state
resolutionstring?Resolution value if resolved
closeTimestring?ISO 8601 close datetime
urlstringCanonical link to the market