Skip to content

get_odds

5 creditsStats + aggregationPOST /v1/get_odds

Opening, closing and current moneylines by sportsbook for a fight (5) or a card (10)

Use it when you need opening and closing moneylines by sportsbook for a fight or a card, with implied probabilities, to backtest against results.

Parameters

bout_idstringoptional
One fight.
event_idstringoptional
A whole card.

Notes

  • Over MCP, ask for it in plain English and the client calls get_odds itself. Point any MCP client at https://mcp.fighterapi.com/mcp?key=YOUR_API_KEY.
  • Each call costs 5 credits, taken before it runs and refunded if the server errors.
  • Not the call you need? Find the right call by what you are trying to answer.

Request

curl -X POST https://mcp.fighterapi.com/v1/get_odds \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "bout_id": "401612970"
}'

Response

json
{
  "bouts": [
    {
      "bout_id": "401612970",
      "event_id": "600039753",
      "event_name": "UFC 298: Volkanovski vs. Topuria",
      "event_date": "2024-02-17",
      "starts_at": "2024-02-18T03:00:00.000Z",
      "weight_class": "Featherweight",
      "card_segment": "main",
      "match_number": 1,
      "title_fight": true,
      "scheduled_rounds": 5,
      "status": "final",
      "fighter_a": "3949584",
      "fighter_a_name": "Alexander Volkanovski",
      "fighter_b": "4350812",
      "fighter_b_name": "Ilia Topuria",
      "winner": "4350812",
      "method": "kotko",
      "method_display": "KO/TKO",
      "end_round": 2,
      "end_clock": "3:32",
      "duration_seconds": 512,
      "judges_scores": null,
      "referee": "Jason Herzog",
      "books": [
        {
          "provider": "Bet365",
          "a_open": -170,
          "a_close": -130,
          "a_current": -130,
          "b_open": 140,
          "b_close": 110,
          "b_current": 110,
          "a_close_prob": 0.5652173913043478,
          "b_close_prob": 0.47619047619047616,
          "total_rounds": 3.5,
          "over_odds": -120,
          "under_odds": -120,
          "captured_at": "2026-10-05T22:13:27.749Z"
        },
        {
          "provider": "BetfairSportsbook",
          "a_open": -188,
          "a_close": -138,
          "a_current": -138,
          "b_open": 150,
          "b_close": 110,
          "b_current": 110,
          "a_close_prob": 0.5798319327731093,
          "b_close_prob": 0.47619047619047616,
          "total_rounds": null,
          "over_odds": null,
          "under_odds": null,
          "captured_at": "2026-10-05T22:13:27.749Z"
        },
        {
          "provider": "Caesars Sportsbook (CO)",
          "a_open": -175,
          "a_close": -135,
          "a_current": -135,
          "b_open": 150,
          "b_close": 115,
          "b_current": 115,
          "a_close_prob": 0.574468085106383,
          "b_close_prob": 0.46511627906976744,
          "total_rounds": null,
          "over_odds": null,
          "under_odds": null,
          "captured_at": "2026-10-05T22:13:27.749Z"
        }
      ]
    }
  ],
  "count": 10
}

Response fields

bouts[]array
List of objects
bouts[].bout_idstring
bouts[].event_idstring
bouts[].event_namestring
bouts[].event_datestring
bouts[].starts_atstring
bouts[].weight_classstring
bouts[].card_segmentstring
bouts[].match_numbernumber
bouts[].title_fightboolean
bouts[].scheduled_roundsnumber
bouts[].statusstring
bouts[].fighter_astring
bouts[].fighter_a_namestring
bouts[].fighter_bstring
bouts[].fighter_b_namestring
bouts[].winnerstring
bouts[].methodstring
bouts[].method_displaystring
bouts[].end_roundnumber
bouts[].end_clockstring
bouts[].duration_secondsnumber
bouts[].judges_scoresnull
bouts[].refereestring
bouts[].books[]array
List of objects
bouts[].books[].providerstring
bouts[].books[].a_opennumber
bouts[].books[].a_closenumber
bouts[].books[].a_currentnumber
bouts[].books[].b_opennumber
bouts[].books[].b_closenumber
bouts[].books[].b_currentnumber
bouts[].books[].a_close_probnumber
bouts[].books[].b_close_probnumber
bouts[].books[].total_roundsnumber
bouts[].books[].over_oddsnumber
bouts[].books[].under_oddsnumber
bouts[].books[].captured_atstring
countnumber

Related endpoints

Try it

500 credits free on signup: 100 calls to get_odds, and no card.