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:
| Field | Type | Description |
|---|---|---|
id | string | Platform-native market ID |
platform | string | Source platform |
title | string | Market question |
description | string? | Optional longer description |
outcomes | Outcome[] | Array of possible outcomes |
outcomes[].id | string | Outcome identifier |
outcomes[].label | string | Human-readable label |
outcomes[].probability | number | Current implied probability (0–1) |
outcomes[].price | number | Current price per share (0–1) |
volume | number | Total trading volume in platform currency |
liquidity | number? | Available liquidity (if provided by platform) |
status | open | closed | resolved | Market state |
resolution | string? | Resolution value if resolved |
closeTime | string? | ISO 8601 close datetime |
url | string | Canonical link to the market |