Skip to main content
GET
/
games
/
{id}
Get game by ID
curl --request GET \
  --url https://api-v2.polyrouter.io/games/{id} \
  --header 'X-API-Key: <api-key>'
{
  "data": {
    "id": "KCvSF20250209@NFL",
    "title": "Chiefs vs 49ers",
    "teams": [
      "Kansas City Chiefs",
      "San Francisco 49ers"
    ],
    "sport": "Football",
    "league": "NFL",
    "description": "Super Bowl LVIII",
    "scheduled_at": "2025-02-09T23:30:00.000Z",
    "status": "not_started",
    "category": "sports",
    "tags": [
      "nfl",
      "super-bowl",
      "championship"
    ],
    "markets": [
      {
        "platform": "polymarket",
        "event_id": "evt_123",
        "outcomes": [
          {
            "outcome_id": "outcome_123",
            "platform_id": "pm_456",
            "name": "Kansas City Chiefs",
            "price": 0.65,
            "volume": 50000,
            "status": "active",
            "liquidity": 25000,
            "order_book": {
              "yes": [
                {
                  "price": 0.65,
                  "qty": 100,
                  "status": "active",
                  "side": "yes",
                  "timestamp": "2025-01-01T00:00:00.000Z"
                }
              ],
              "no": [
                {
                  "price": 0.65,
                  "qty": 100,
                  "status": "active",
                  "side": "yes",
                  "timestamp": "2025-01-01T00:00:00.000Z"
                }
              ]
            },
            "metadata": {}
          }
        ],
        "metadata": {},
        "event_name": "Super Bowl LVIII",
        "event_slug": "super-bowl-lviii"
      }
    ],
    "metadata": {},
    "image_url": "<string>"
  },
  "meta": {
    "platforms_queried": [
      "polymarket",
      "kalshi",
      "prophetx"
    ],
    "request_time": 250,
    "data_freshness": "2025-01-01T00:00:00.000Z",
    "platform_errors": {}
  }
}

Authorizations

X-API-Key
string
header
required

API key for authentication

Path Parameters

id
string
required

Game ID (format: {Away}v{Home}{YYYYMMDD}@{LEAGUE})

Example:

"KCvSF20250209@NFL"

Query Parameters

platform
enum<string>

Filter by platform

Available options:
polymarket,
kalshi,
prophetx,
novig,
sxbet
market_type
enum<string>

Filter by market type

Available options:
moneyline,
spread,
total,
prop
odds_format
enum<string>

Odds format for market odds (american, decimal, fractional)

Available options:
american,
decimal,
probability
Example:

"american"

Response

Game details

data
object
required
meta
object
required