Outrights

What are outrights?

An outright is a bet on how a whole tournament ends rather than on a single match: who wins, who finishes in the top 5, 10 or 20, and who makes the cut. Outrights are a paid add-on. Golf is the first sport: PGA Tour, DP World Tour and LIV Golf individual tournaments and the four majors. More sports will follow on the same endpoints. Three endpoints:

Endpoint	Returns
`GET /v3/outrights`	Tournaments for a sport, with how many bookmakers currently price each one
`GET /v3/outrights/odds`	Prices for one tournament from the bookmakers you choose
`GET /v3/outrights/results`	Final positions and the winners of each market after the tournament

Every golfer carries a participantId from /v3/participants. It is the same id for every bookmaker and in the results, so you can join prices and results without matching names.

Markets

Market	Runner fields	Wins when the golfer
`Winner`	`odds` (and `layOdds` on exchanges and prediction markets)	finishes first
`Top 5`, `Top 10`, `Top 20`	`odds` (and `layOdds`)	finishes in that many places. Ties at the boundary settle under the bookmaker’s dead-heat rules
`Top 5 (Incl. Ties)`, `Top 10 (Incl. Ties)`, `Top 20 (Incl. Ties)`	`odds` (and `layOdds`)	finishes in that many places. Ties at the boundary are paid in full
`Make Cut`	`yes`, `no` (and `layYes`, `layNo` on exchanges)	makes the cut. Only offered for events with a cut

Top 5 and Top 5 (Incl. Ties) are different bets and are never merged: the Incl. Ties price is shorter because ties are paid in full. Each bookmaker’s market is filed under the tie rule that bookmaker states. A bookmaker that does not offer a market leaves it out. Odds are decimal strings, like /v3/odds.

Query Parameters

GET /v3/outrights

Parameter	Required	Description
`apiKey`	Yes	Your API key
`sport`	Yes	Sport name or slug. `golf`
`league`	No	League slug: `pga-tour`, `dp-world-tour`, `liv-golf` or `majors`
`status`	No	Comma-separated: `pending`, `live`, `settled`, `cancelled`. Default `pending,live`

The list holds the whole season, sorted by start date. bookmakerCount is how many bookmakers you can request in /v3/outrights/odds currently price the tournament. A market that lists only a small part of the field (fewer than a quarter as many golfers as the typical bookmaker for that tournament) does not count, but /v3/outrights/odds still returns those prices when you request that bookmaker. Tournaments that bookmakers do not price yet show bookmakerCount: 0, so filter by league to keep the list short.

GET /v3/outrights/odds

Parameter	Required	Description
`apiKey`	Yes	Your API key
`id`	Yes	Outright id from `/v3/outrights`
`bookmakers`	Yes	Comma-separated bookmaker names, max 30. Same rules as `/v3/odds`: the bookmakers come from your plan’s selection

GET /v3/outrights/results

Parameter	Required	Description
`apiKey`	Yes	Your API key
`id`	Yes	Outright id from `/v3/outrights`

Fetching Outrights

List the PGA Tour tournaments, then fetch prices for the next one that bookmakers price:

const apiKey = process.env.ODDS_API_KEY;
const base = 'https://api.odds-api.io/v3';

const tournaments = await fetch(
  `${base}/outrights?apiKey=${apiKey}&sport=golf&league=pga-tour`
).then((r) => r.json());

const next = tournaments.find((t) => t.bookmakerCount > 0);

const odds = await fetch(
  `${base}/outrights/odds?apiKey=${apiKey}&id=${next.id}&bookmakers=DraftKings,Kalshi,Betfair%20Exchange`
).then((r) => r.json());

console.log(odds.bookmakers.DraftKings);

import os
import requests

api_key = os.environ['ODDS_API_KEY']
base = 'https://api.odds-api.io/v3'

tournaments = requests.get(
    f'{base}/outrights',
    params={'apiKey': api_key, 'sport': 'golf', 'league': 'pga-tour'},
).json()

next_event = next(t for t in tournaments if t['bookmakerCount'] > 0)

odds = requests.get(
    f'{base}/outrights/odds',
    params={'apiKey': api_key, 'id': next_event['id'], 'bookmakers': 'DraftKings,Kalshi,Betfair Exchange'},
).json()

print(odds['bookmakers'].get('DraftKings'))

curl "https://api.odds-api.io/v3/outrights?apiKey=YOUR_API_KEY&sport=golf&league=pga-tour"
curl "https://api.odds-api.io/v3/outrights/odds?apiKey=YOUR_API_KEY&id=1001&bookmakers=DraftKings,Kalshi,Betfair%20Exchange"

Response Format

GET /v3/outrights:

[
  {
    "id": 1001,
    "name": "World Wide Technology Championship 2026",
    "date": "2026-11-05T13:30:00Z",
    "status": "pending",
    "sport": { "name": "Golf", "slug": "golf" },
    "league": { "name": "PGA Tour", "slug": "pga-tour" },
    "bookmakerCount": 40
  }
]

GET /v3/outrights/odds (two golfers per market and some markets shown):

{
  "id": 1001,
  "name": "World Wide Technology Championship 2026",
  "date": "2026-11-05T13:30:00Z",
  "status": "pending",
  "sport": { "name": "Golf", "slug": "golf" },
  "league": { "name": "PGA Tour", "slug": "pga-tour" },
  "bookmakers": {
    "DraftKings": [
      {
        "name": "Winner",
        "updatedAt": "2026-11-04T17:01:15.428Z",
        "odds": [
          { "label": "Ben Griffin", "participantId": 991291386379, "odds": "14.25" },
          { "label": "Ryan Gerard", "participantId": 991890826517, "odds": "14.75" }
        ]
      },
      {
        "name": "Top 5",
        "updatedAt": "2026-11-04T17:01:15.869Z",
        "odds": [
          { "label": "Ben Griffin", "participantId": 991291386379, "odds": "4.25" },
          { "label": "Ryan Gerard", "participantId": 991890826517, "odds": "4.35" }
        ]
      },
      {
        "name": "Top 5 (Incl. Ties)",
        "updatedAt": "2026-11-04T17:01:15.428Z",
        "odds": [
          { "label": "Ben Griffin", "participantId": 991291386379, "odds": "3.70" },
          { "label": "Ryan Gerard", "participantId": 991890826517, "odds": "3.70" }
        ]
      }
    ],
    "Kalshi": [
      {
        "name": "Winner",
        "updatedAt": "2026-11-04T18:18:33.665Z",
        "odds": [
          { "label": "Ben Griffin", "participantId": 991291386379, "odds": "16.129", "layOdds": "18.182" },
          { "label": "Ryan Gerard", "participantId": 991890826517, "odds": "16.667", "layOdds": "18.182" }
        ]
      },
      {
        "name": "Make Cut",
        "updatedAt": "2026-11-04T18:18:35.594Z",
        "odds": [
          { "label": "Ben Griffin", "participantId": 991291386379, "yes": "1.149", "no": "6.667" },
          { "label": "Ryan Gerard", "participantId": 991890826517, "yes": "1.163", "no": "5.882" }
        ]
      }
    ],
    "Betfair Exchange": [
      {
        "name": "Winner",
        "updatedAt": "2026-11-05T12:00:18.63Z",
        "odds": [
          { "label": "Ben Griffin", "participantId": 991291386379, "odds": "18.50", "layOdds": "19.00" },
          { "label": "Ryan Gerard", "participantId": 991890826517, "odds": "18.50", "layOdds": "19.50" }
        ]
      },
      {
        "name": "Top 5",
        "updatedAt": "2026-11-05T12:00:18.63Z",
        "odds": [
          { "label": "Ben Griffin", "participantId": 991291386379, "odds": "4.40", "layOdds": "4.70" },
          { "label": "Ryan Gerard", "participantId": 991890826517, "odds": "4.70", "layOdds": "4.90" }
        ]
      }
    ]
  }
}

label is the golfer’s name as listed in /v3/participants, whatever spelling the bookmaker uses.
updatedAt is when a price in that market last changed, the same meaning as on /v3/odds.
Markets come in a fixed order: Winner, Top 5, Top 5 (Incl. Ties), Top 10, Top 10 (Incl. Ties), Top 20, Top 20 (Incl. Ties), Make Cut.
Runners are sorted by odds (Make Cut by yes), shortest first; equal prices sort by name.
A market is served only while its prices are current: confirmed within the last 10 minutes while the tournament is in play, 30 minutes during the week before it starts, and 6 hours further out. A bookmaker with no current market is left out of bookmakers and is not counted in bookmakerCount.
Settled and cancelled tournaments return "bookmakers": {}.

Results and Ties

GET /v3/outrights/results returns final positions once the result is confirmed, usually several hours after the final round. While status is pending, live or cancelled, the response is still 200 with empty results and winners. Shortened example (six of 120 golfers; the longer winners lists are cut short the same way):

{
  "id": 1000,
  "name": "Mexico Open 2026",
  "status": "settled",
  "results": [
    { "label": "Andrew Novak", "participantId": 991570904131, "position": 1, "tied": false, "madeCut": true, "status": "finished" },
    { "label": "Kristoffer Ventura", "participantId": 993035649881, "position": 2, "tied": true, "madeCut": true, "status": "finished" },
    { "label": "Steven Fisk", "participantId": 993893124464, "position": 2, "tied": true, "madeCut": true, "status": "finished" },
    { "label": "Ben Griffin", "participantId": 991291386379, "position": 4, "tied": true, "madeCut": true, "status": "finished" },
    { "label": "Mackenzie Hughes", "participantId": 990349596473, "position": 4, "tied": true, "madeCut": true, "status": "finished" },
    { "label": "Davis Riley", "participantId": 991030050812, "position": null, "tied": false, "madeCut": false, "status": "cut" }
  ],
  "winners": {
    "Winner": [991570904131],
    "Top 5": [991570904131, 993035649881, 993893124464, 991291386379, 990349596473],
    "Top 5 (Incl. Ties)": [991570904131, 993035649881, 993893124464, 991291386379, 990349596473],
    "Top 10": [991570904131, 993035649881, 993893124464, 991291386379, 990349596473],
    "Top 10 (Incl. Ties)": [991570904131, 993035649881, 993893124464, 991291386379, 990349596473],
    "Top 20": [991570904131, 993035649881, 993893124464, 991291386379, 990349596473],
    "Top 20 (Incl. Ties)": [991570904131, 993035649881, 993893124464, 991291386379, 990349596473],
    "Make Cut": [991570904131, 993035649881, 993893124464, 991291386379, 990349596473]
  }
}

status per golfer: finished, cut, withdrawn or disqualified.
position is the final position. Tied golfers share it and have tied: true. It is null for cut, withdrawn and disqualified.
madeCut is true or false when the event has a cut, and null on every row for events without one (LIV Golf, no-cut signature events, the Tour Championship). A golfer who withdrew before the first round has madeCut: null.
winners["Top N"] and winners["Top N (Incl. Ties)"] both list every golfer with position N or better, so ties at the boundary can make them longer than N. The two markets differ only in how a boundary tie is paid: dead heat for Top N, in full for Top N (Incl. Ties).
winners["Winner"] is everyone at position 1: normally one golfer (a playoff winner is first, not tied), or several co-winners with tied: true.
winners["Make Cut"] lists every golfer who made the cut. It is absent for events without a cut.
Dead-heat reductions and each-way terms are set by each bookmaker. Apply your bookmaker’s rules to these results.

Plan Access

Outrights are an add-on for paid plans and are not available on the free plan. Add it under Billing > Add-ons in the dashboard on a monthly card-paid plan; for annual or crypto plans, contact support and we’ll add it. Without the add-on, all three endpoints return 403:

{ "error": "Outrights are a paid add-on. Add it in your dashboard: https://odds-api.io/dashboard/billing#outrights" }

Errors: 400 for missing or invalid parameters, 401 for a missing or invalid API key, 403 without the add-on, 404 for an unknown or malformed id, 429 when you exceed the rate limit, 500 on a server error, 503 when the service is temporarily busy. Each call counts as one request against your normal quota. /v3/outrights/odds uses the bookmakers in your plan’s selection, exactly like /v3/odds: the add-on unlocks the endpoints, not extra bookmakers.

Limitations & Considerations

Golf is the only sport so far, individual stroke-play tournaments. Team events are not covered.
No WebSocket stream, historical outright odds or odds movements for outrights yet.
Results appear only after the final result is confirmed, which can take several hours after the last round.
Not every bookmaker offers every market, and coverage can differ by tour.

Getting Started

Guides

Examples

What are outrights?

Markets

Query Parameters

GET /v3/outrights

GET /v3/outrights/odds

GET /v3/outrights/results

Fetching Outrights

Response Format

Results and Ties

Plan Access

Limitations & Considerations

Next Steps

Fetching Odds

Bet Settlement

​What are outrights?

​Markets

​Query Parameters

​GET /v3/outrights

​GET /v3/outrights/odds

​GET /v3/outrights/results

​Fetching Outrights

​Response Format

​Results and Ties

​Plan Access

​Limitations & Considerations

​Next Steps

Fetching Odds

Bet Settlement

What are outrights?

Markets

Query Parameters

GET /v3/outrights

GET /v3/outrights/odds

GET /v3/outrights/results

Fetching Outrights

Response Format

Results and Ties

Plan Access

Limitations & Considerations

Next Steps