---
title: "Get Match Odds"
method: POST
path: "/v1/mcp/get_match_odds"
tags: ["mcp"]
---

# Get Match Odds

`POST /v1/mcp/get_match_odds`

## Request

- Base URL: `https://api.infersports.dev` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infersports.dev/v1/mcp/get_match_odds`
- Auth: none declared

## Request body

- GetMatchOddsRequest
  - `event_id` string, required: Event id from find_match / list_today_matches (evt_…).
  - `markets` string[], nullable: Filter to these market types: 1x2 | asian_handicap | totals.
  - `bookmakers` string[], nullable: Filter to these bookmaker keys, e.g. ['pinnacle','crown'].
  - `period` string, nullable: full_time | half_time (default: both).
  - `format` string: Odds format: decimal | hk | malay | american | indonesian | probability.

## Response `200`

Successful Response

- MatchOddsResult
  - `event_id` string, required
  - `home_team` string, required
  - `away_team` string, required
  - `league` string, required
  - `status` string, required
  - `as_of` string, required: Freshness stamp — last upstream update applied (ISO-8601 UTC).
  - `stale` boolean, required: True when as_of is older than the freshness window for the match state (live vs pre-match) — warn the user before quoting these as live.
  - `odds` OddsQuote[], required
    - `bookmaker` string, required
    - `market_type` string, required
    - `period` string, required
    - `line` number, nullable
    - `handicap_components` number[], nullable
    - `prices` object, required
    - `format` string
    - `status` string, required
    - `as_of` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/infersports/apis/infersports-api.md) · [All operations](https://skmtc.dev/infersports/apis/infersports-api/llms.txt) · [OpenAPI document](https://skmtc.dev/infersports/apis/infersports-api/revisions/1a1c3b357ea7?raw)