Player props for fixtures in play
using System.Net.Http.Headers;var client = new HttpClient();var request = new HttpRequestMessage{ Method = HttpMethod.Get, RequestUri = new Uri("https://oddslink.app/v1/sports/nfl/props/live?league=epl&tournament=atp_beijing&markets=player_anytime_td%2Cplayer_pass_yds&periods=full%2C1h&bookmakers=draftkings%2Cfanduel&oddsFormat=american&devig=true&fees=taker&dateFormat=iso&eventIds=nfl%3Aatlantafalcons-carolinapanthers%3A2026-09-20%2Cnfl%3Abaltimoreravens-neworleanssaints%3A2026-09-20"), Headers = { { "X-API-Key", "<X-API-Key>" }, },};using (var response = await client.SendAsync(request)){ response.EnsureSuccessStatusCode(); var body = await response.Content.ReadAsStringAsync(); Console.WriteLine(body);}package main
import ( "fmt" "net/http" "io")
func main() {
url := "https://oddslink.app/v1/sports/nfl/props/live?league=epl&tournament=atp_beijing&markets=player_anytime_td%2Cplayer_pass_yds&periods=full%2C1h&bookmakers=draftkings%2Cfanduel&oddsFormat=american&devig=true&fees=taker&dateFormat=iso&eventIds=nfl%3Aatlantafalcons-carolinapanthers%3A2026-09-20%2Cnfl%3Abaltimoreravens-neworleanssaints%3A2026-09-20"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<X-API-Key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close() body, _ := io.ReadAll(res.Body)
fmt.Println(res) fmt.Println(string(body))
}OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder() .url("https://oddslink.app/v1/sports/nfl/props/live?league=epl&tournament=atp_beijing&markets=player_anytime_td%2Cplayer_pass_yds&periods=full%2C1h&bookmakers=draftkings%2Cfanduel&oddsFormat=american&devig=true&fees=taker&dateFormat=iso&eventIds=nfl%3Aatlantafalcons-carolinapanthers%3A2026-09-20%2Cnfl%3Abaltimoreravens-neworleanssaints%3A2026-09-20") .get() .addHeader("X-API-Key", "<X-API-Key>") .build();
Response response = client.newCall(request).execute();const url = 'https://oddslink.app/v1/sports/nfl/props/live?league=epl&tournament=atp_beijing&markets=player_anytime_td%2Cplayer_pass_yds&periods=full%2C1h&bookmakers=draftkings%2Cfanduel&oddsFormat=american&devig=true&fees=taker&dateFormat=iso&eventIds=nfl%3Aatlantafalcons-carolinapanthers%3A2026-09-20%2Cnfl%3Abaltimoreravens-neworleanssaints%3A2026-09-20';const options = {method: 'GET', headers: {'X-API-Key': '<X-API-Key>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://oddslink.app/v1/sports/nfl/props/live?league=epl&tournament=atp_beijing&markets=player_anytime_td%2Cplayer_pass_yds&periods=full%2C1h&bookmakers=draftkings%2Cfanduel&oddsFormat=american&devig=true&fees=taker&dateFormat=iso&eventIds=nfl%3Aatlantafalcons-carolinapanthers%3A2026-09-20%2Cnfl%3Abaltimoreravens-neworleanssaints%3A2026-09-20' \ --header 'X-API-Key: <X-API-Key>'/live = fixtures in play now: started and not finished, using public is_live. Needs in-play odds (Growth and up), NOT the live feed add-on. The same selectors and formats as the upcoming list apply.
Authorizations
Section titled “Authorizations”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters”A sport key, for example nfl, soccer, tennis, epl or tennis_atp_hangzhou. soccer and tennis are aggregate keys with optional competition selectors; their legacy per-competition keys remain aliases. A well-formed tennis tournament key is accepted; one we carry no fixtures for this week returns an empty list. Esports uses one key per game: cs2, lol, dota2, valorant; use tournament= to select a tournament within that game.
Example
nflQuery Parameters
Section titled “Query Parameters”Optional soccer competition selector, using its existing public alias key (epl, not an internal provider slug). Only valid with the aggregate soccer sport key. Omitting it returns every currently available soccer competition in one response, which may be larger.
Example
eplOptional tennis competition selector, without the legacy tennis_ path prefix (atp_beijing). The tournament.key a response carries (tennis_atp_beijing) is accepted too. Valid with aggregate tennis or an esports game key (cs2, lol, dota2, valorant). For esports, pass the fixture’s tournament.key unchanged. Omitting it returns every currently available tennis competition in one response, which may be larger.
Example
atp_beijingComma-separated player-prop market keys, with no period in them, for example player_pass_yds or player_anytime_td; choose periods with periods. Required: there is no default set of props. Discover the full catalogue via /v1/markets. Tennis includes player_aces, player_break_points_won, player_games_won, player_total_games, player_total_sets, player_total_tiebreaks and player_fantasy_points. MMA includes player_significant_strikes, player_takedowns, player_fight_time_minutes (decimal minutes), player_knockdowns, player_control_time_minutes (decimal minutes), player_submission_attempts, player_significant_body_strikes, player_significant_leg_strikes and player_fantasy_points. Fantasy scoring follows the offering book’s rules. These tennis/MMA props use full-game periods.
Example
player_anytime_td,player_pass_ydsComma-separated periods for the requested markets: 1h, 2h (halves), 1q..4q (quarters), 1p..3p (hockey periods), f5 (baseball first 5 innings), 1i (baseball first inning), 1s..5s (tennis sets), reg (hockey regulation time). Omitting it returns the full game only. full asks for the full game beside other periods (periods=full,1h); it is accepted here only, since a full-game market carries no period. all returns the full game and every period. An unknown period is 422 INVALID_MARKET. There are no F3 or F7 markets. Esports also accepts map1, map2, map3, map4, map5; use periods=full,map1 for full-match and first-map prices.
Example
full,1hComma-separated, case-sensitive book keys from /v1/bookmakers. A typo or wrong case returns 422 INVALID_BOOKMAKER with a suggested key and valid_bookmakers; it does not count against your allowance. Defaults to every book when omitted. On the odds and props routes, any book you name that returns no markets for a fixture is listed in that fixture’s unmatched_bookmakers.
Example
draftkings,fanduelOne number per price.
Adds fair_prob and fair_price to every outcome that has its complete set of sides: the price with the bookmaker’s margin removed. devig=true uses power. Methods: power (the margin comes off in proportion to each price raised to a power; keeps the favourite-longshot shape), multiplicative (the margin comes off in proportion to each implied probability; what a basic no-vig calculator shows), shin, additive (for a two-way market shin and additive give the same numbers). On a lopsided market power and multiplicative differ by a point or more (1.20/5.00: 82.2 % vs 80.7 %). The method used comes back in the X-Devig-Method header. An outcome whose partner side is missing, or whose set is crossed or an exchange stub, carries no fair_* fields. Exchange and prediction-market prices are asks, so the gap between the two sides is the spread, not a margin; fair_prob is then the middle of the spread. Requires the Starter plan or above (403 PLAN_REQUIRED on Free).
fees=taker adds net_price to the outcomes of exchanges and prediction markets that charge a fee, and a fees object to each such market describing the published schedule used. net_price is the price after the taker fee, in the same oddsFormat as price (decimal to 3 places). Per-contract venues (Polymarket, Kalshi, Novig): the fee grows with price x (1 - price) and the figure is for a large order (Kalshi and Fanatics round each order up to the cent). Commission venues (SX Bet, ProphetX, Betfair, 4Casters): commission on winnings, so net_price is the price if the bet wins. Fanatics Markets prices already include its fee (fees.model is included, no net_price). Account tiers, discounts and promotions change what you pay; the published rate is shown. A venue or date with no published schedule carries neither field. Requires the Starter plan or above.
How commence_time, every last_update and recorded_at, and archive_from are written: ISO-8601 UTC strings with exactly three fractional digits and trailing Z (iso, e.g. 2026-10-11T13:00:00.000Z) or unix seconds (unix). ISO sub-millisecond digits are truncated. Unix price clocks may be fractional; fixture and gameline archive times use whole seconds.
Comma-separated fixture ids, to narrow a list call to specific fixtures.
Example
nfl:atlantafalcons-carolinapanthers:2026-09-20,nfl:baltimoreravens-neworleanssaints:2026-09-20Responses
Section titled “ Responses ”Props for the matching fixtures.
object
A readable, constructible fixture id. Treat as opaque.
true from scheduled commence_time until the sport-specific live-window cutoff; false outside that window. Inferred from time, not a confirmed match-status or final-result feed, except reliable source terminal evidence makes it false. See the additive status and status_evidence fields. A delayed start, early finish or unusually long fixture can disagree with this flag. Evaluated when the response is served, so it can flip without a price change. On the WebSocket feed a flip arrives as a status upsert. Historical routes apply the same time-derived rule.
On current fixture routes, scheduled means the fixture has not started, including a delayed start. Live requires is_live to be true and a fresh observation of a linked book’s own in-play state, identified by status_evidence. Unknown means neither live play nor finish is confirmed. Finished requires retained explicit terminal evidence. These values are additive; clients must accept new values. Historical props use their separately documented recording status. Archive presence and absent prices alone never prove finish.
Present only for covered live soccer and tennis fixtures with a fresh observation. All sides follow home_team and away_team. Soccer clocks are cumulative observed match time, without extrapolation. Tennis totals count completed sets; ambiguous totals are omitted. Uncovered or stale scores are absent.
object
object
object
The book, its observed state and observation time supporting live or finished status. Absent when no supporting observation is available.
Soccer fixtures only: the league a fixture belongs to. key is the public sport key when the league has one (epl; pass it as soccer?league= or as the sport key), else a stable key for that league; title is its display name. null when the league is not known for the fixture. Historical bodies carry the same object; a fixture archived before its league was recorded has league: null unless the sport key you asked with names one (epl). Other sports carry no league (tennis and esports carry tournament; every other sport key is one league).
object
Tennis and esports fixtures: the tournament a match belongs to. key is the tournament’s public sport key (tennis_atp_hangzhou; pass it as tennis?tournament= or as the sport key); title is its display name. null when the tournament is not known. Historical bodies carry the same object. For esports, key identifies the tournament within the requested game and is accepted by tournament= on events and odds lists.
object
Esports series format. Present only when known and the books agree; absent when unknown. A BO2 Draw is represented by h2h_3_way independently of this field.
object
object
A link to this fixture on the bookmaker’s own website. Present only when the bookmaker gives one; the field is absent otherwise, never empty or null. Some bookmakers link to the competition page rather than the single event. This is an event-page link; it does not select an outcome or populate a bet slip.
The player’s name, spelled the same way on every row of the fixture whatever the book calls them. A team defense is a player too, for example “SEA D/ST”.
A fixed id for the player, the same on every book and every day: join on it, not on the name. Never changed once served.
A player-prop market key, with no period in it, for example player_pass_yds.
The slice of the game a market settles on: 1h/2h halves, 1q..4q quarters, 1p..3p hockey periods, f5 baseball’s first 5 innings, 1i baseball’s first inning, 1s..5s tennis sets, reg hockey regulation time. Absent on a full-game market; never full. More periods may be added. There are no F3 or F7 markets. Esports map periods are map1 through map5; full-match markets omit the period field.
The line for this stat. Absent for a binary (Yes/No) prop.
One side of a prop line. price is absent only on a pick’em book (prizepicks), which posts a line and the sides you may pick (More/Less, served as Over/Under, or Yes on a line-less prop) and never a price. Every other book always carries price.
object
Over, Under, Yes or No today. More sides may be added.
Underdog’s published multiplier for this exact pick, passed through as a number. Optional and omitted when unavailable; never null or inferred from an entry payout. Independent of oddsFormat. Available only on Underdog outcomes.
object
posted_limit: one number that applies to both legs, a sportsbook’s maximum bet. resting_depth: a separate number per leg, an exchange’s live order book. contracts: a contract count; no bookmaker uses it today (Kalshi and Polymarket report resting_depth in dollars at the best price). More kinds may be added. The kind is fixed per bookmaker (GET /v1/bookmakers size_kind).
Always a positive number. A posted_limit or resting_depth amount is in the bookmaker’s own currency; a contracts amount is a count. The same object appears on every line the bookmaker states a size for, including alternate lines and periods.
With devig: the probability of this outcome after the margin is removed from its complete set of sides (see the devig parameter for the method). Absent, never null or 0, when the set is incomplete, crossed or a stub.
With devig: fair_prob as a price, in the request’s oddsFormat (an integer in American, three decimals in decimal).
With fees: the price after the venue’s taker fee, in the request’s oddsFormat (an integer in American, three decimals in decimal). Present only on a venue and date with a published schedule; see the market’s fees object. A commission venue’s figure is the price if the bet wins.
True on exactly one row per bookmaker, player and stat: that book’s main line, which comes first among its lines. It is the line priced on both sides with the most even prices; a line priced on one side only (a milestone such as “250+ yards”) is main only when the book prices no line on both sides. A Yes/No prop is always main. On a pick’em book, which posts no prices, the main line is the book’s standard line; its other lines for that player and stat are alternates.
With fees: the published fee schedule behind this market’s net_price values. included means the venue’s price already contains the fee and no net_price is added.
object
per_contract: a fee per contract that grows with price x (1 - price) (Polymarket, Kalshi, Novig). on_winnings: commission on winnings (SX Bet, ProphetX, Betfair, 4Casters). included: already in price (Fanatics Markets).
The rate net_price uses. Absent when model is included. Where the venue’s rate depends on the customer’s country (Betfair, Matchbook) this is the rate for its home countries (UK and Ireland) and rate_elsewhere is the rate for everyone else.
Present only where the rate depends on the customer’s country.
published: the venue’s published rate for this book. schedule: a sport-level schedule (Polymarket sets its rate per market, and we apply the rate that sport’s markets carry); a market created before the sport’s last rate change can differ.
The day this rate took effect.
Sorted book keys with no returned props for this fixture and the selected markets. With bookmakers=, covers the named books; without it, covers all props-capable catalogue books. Does not diagnose the reason for absence.
Example
[ { "id": "nfl:atlantafalcons-carolinapanthers:2026-09-20", "sport_key": "nfl", "sport_title": "NFL", "commence_time": "2026-09-20T17:00:00.000Z", "is_live": false, "score": { "clock": "67:12", "updated_at": "2026-09-20T17:00:00.000Z" }, "status_evidence": { "observed_at": "2026-09-20T17:00:00.000Z" }, "league": { "key": "epl", "title": "EPL" }, "tournament": { "key": "tennis_atp_hangzhou", "title": "ATP Hangzhou" }, "best_of": 1, "props": [ { "bookmaker": { "key": "draftkings", "title": "DraftKings", "link": "https://sports.nj.betmgm.com/en/sports/events/carolina-panthers-at-atlanta-falcons-17042931", "last_update": "2026-09-20T17:00:00.000Z" }, "player": "Bijan Robinson", "player_id": "nfl:bijanrobinson", "stat": "player_anytime_td", "period": "1h", "outcomes": [ { "payout_multiplier": 3.34, "price": -110, "fair_prob": 0.5214, "fair_price": 1.918, "net_price": 1.951 } ], "fees": { "rate": 0.05, "rate_elsewhere": 0.065, "effective": "2026-07-10" } } ] }]Headers
Section titled “Headers”Requests used this billing period.
Requests remaining this billing period.
What this one call cost against the allowance (0 for a free call).
This plan’s speed limit, in requests per second.
Requests left in the current one-second window.
Seconds until the speed-limit window resets.
This request’s id, for support and for matching against error.request_id.
A parameter was malformed.
object
object
Stored Unix-second choices on AMBIGUOUS_EVENT or INVALID_STORED_COMMENCE_TIME; independent of dateFormat.
Valid case-sensitive book keys on INVALID_BOOKMAKER.
403 only: the plan on the presented key.
403 only: the lowest plan that includes this request. For history, that depends on how long ago the fixture started as well as on the endpoint.
Example
{ "error": { "code": "BAD_REQUEST", "message": "commenceTimeFrom is not a valid ISO-8601 timestamp.", "docs_url": "https://oddslink.app/docs/errors/#bad-request", "request_id": "req_01hz8k3z9e2v6w1x" }}Headers
Section titled “Headers”Requests used this billing period.
Requests remaining this billing period.
What this one call cost against the allowance (0 for a free call).
This plan’s speed limit, in requests per second.
Requests left in the current one-second window.
Seconds until the speed-limit window resets.
This request’s id, for support and for matching against error.request_id.
The X-API-Key header is missing or invalid.
object
object
Stored Unix-second choices on AMBIGUOUS_EVENT or INVALID_STORED_COMMENCE_TIME; independent of dateFormat.
Valid case-sensitive book keys on INVALID_BOOKMAKER.
403 only: the plan on the presented key.
403 only: the lowest plan that includes this request. For history, that depends on how long ago the fixture started as well as on the endpoint.
Examples
No X-API-Key header sent
{ "error": { "code": "MISSING_KEY", "message": "X-API-Key header is missing.", "docs_url": "https://oddslink.app/docs/errors/#missing-key", "request_id": "req_01hz8k4a1f3w7x2y" }}Key does not exist or was revoked
{ "error": { "code": "INVALID_KEY", "message": "API key is not valid.", "docs_url": "https://oddslink.app/docs/errors/#invalid-key", "request_id": "req_01hz8k4b2g4x8y3z" }}Headers
Section titled “Headers”Requests used this billing period.
Requests remaining this billing period.
What this one call cost against the allowance (0 for a free call).
This plan’s speed limit, in requests per second.
Requests left in the current one-second window.
Seconds until the speed-limit window resets.
This request’s id, for support and for matching against error.request_id.
The key’s plan does not include in-play odds (Growth plan and up). A started fixture asked for by id and every /live list are refused. Upcoming lists exclude started fixtures for every plan.
object
object
Stored Unix-second choices on AMBIGUOUS_EVENT or INVALID_STORED_COMMENCE_TIME; independent of dateFormat.
Valid case-sensitive book keys on INVALID_BOOKMAKER.
403 only: the plan on the presented key.
403 only: the lowest plan that includes this request. For history, that depends on how long ago the fixture started as well as on the endpoint.
Example
{ "error": { "code": "PLAN_REQUIRED", "message": "In-play odds require the Growth plan or above.", "docs_url": "https://oddslink.app/docs/errors/#plan-required", "request_id": "req_01hz8k4c6l8b2c7d", "current_plan": "starter", "required_plan": "growth" }}Headers
Section titled “Headers”Requests used this billing period.
Requests remaining this billing period.
What this one call cost against the allowance (0 for a free call).
This plan’s speed limit, in requests per second.
Requests left in the current one-second window.
Seconds until the speed-limit window resets.
This request’s id, for support and for matching against error.request_id.
The sport key does not exist.
object
object
Stored Unix-second choices on AMBIGUOUS_EVENT or INVALID_STORED_COMMENCE_TIME; independent of dateFormat.
Valid case-sensitive book keys on INVALID_BOOKMAKER.
403 only: the plan on the presented key.
403 only: the lowest plan that includes this request. For history, that depends on how long ago the fixture started as well as on the endpoint.
Example
{ "error": { "code": "UNKNOWN_SPORT", "message": "Unknown sport key: basketbal_nba", "docs_url": "https://oddslink.app/docs/errors/#unknown-sport", "request_id": "req_01hz8k4d4j6z0a5b" }}Headers
Section titled “Headers”Requests used this billing period.
Requests remaining this billing period.
What this one call cost against the allowance (0 for a free call).
This plan’s speed limit, in requests per second.
Requests left in the current one-second window.
Seconds until the speed-limit window resets.
This request’s id, for support and for matching against error.request_id.
A parameter was well-formed but not valid (an unknown market or bookmaker key, for example).
object
object
Stored Unix-second choices on AMBIGUOUS_EVENT or INVALID_STORED_COMMENCE_TIME; independent of dateFormat.
Valid case-sensitive book keys on INVALID_BOOKMAKER.
403 only: the plan on the presented key.
403 only: the lowest plan that includes this request. For history, that depends on how long ago the fixture started as well as on the endpoint.
Example
{ "error": { "code": "INVALID_MARKET", "message": "Invalid markets: not_a_market", "docs_url": "https://oddslink.app/docs/errors/#invalid-market", "request_id": "req_01hz8k4e5k7a1b6c" }}Headers
Section titled “Headers”Requests used this billing period.
Requests remaining this billing period.
What this one call cost against the allowance (0 for a free call).
This plan’s speed limit, in requests per second.
Requests left in the current one-second window.
Seconds until the speed-limit window resets.
This request’s id, for support and for matching against error.request_id.
Either the plan’s speed limit or its monthly allowance was exceeded. error.code tells you which. Only the calls that count against the allowance can answer ALLOWANCE_SPENT.
object
object
Stored Unix-second choices on AMBIGUOUS_EVENT or INVALID_STORED_COMMENCE_TIME; independent of dateFormat.
Valid case-sensitive book keys on INVALID_BOOKMAKER.
403 only: the plan on the presented key.
403 only: the lowest plan that includes this request. For history, that depends on how long ago the fixture started as well as on the endpoint.
Examples
Too many requests this second (Retry-After is set)
{ "error": { "code": "SPEED_LIMIT", "message": "Speed limit exceeded: 10 requests/second on the Growth plan.", "docs_url": "https://oddslink.app/docs/errors/#speed-limit", "request_id": "req_01hz8k4f6l8b2c7d" }}The month's allowance is used up
{ "error": { "code": "ALLOWANCE_SPENT", "message": "Monthly allowance of 100000 requests used. Resets 2026-10-01.", "docs_url": "https://oddslink.app/docs/errors/#allowance-spent", "request_id": "req_01hz8k4g7m9c3d8e" }}Headers
Section titled “Headers”Requests used this billing period.
Requests remaining this billing period.
What this one call cost against the allowance (0 for a free call).
This plan’s speed limit, in requests per second.
Requests left in the current one-second window.
Seconds until the speed-limit window resets.
This request’s id, for support and for matching against error.request_id.
Seconds to wait before retrying on 429 SPEED_LIMIT or 503 ODDS_UNAVAILABLE.
No built prices are available yet. Retry after the indicated number of seconds.
object
object
Stored Unix-second choices on AMBIGUOUS_EVENT or INVALID_STORED_COMMENCE_TIME; independent of dateFormat.
Valid case-sensitive book keys on INVALID_BOOKMAKER.
403 only: the plan on the presented key.
403 only: the lowest plan that includes this request. For history, that depends on how long ago the fixture started as well as on the endpoint.
Example
{ "error": { "code": "ODDS_UNAVAILABLE", "message": "No built prices are available yet.", "docs_url": "https://oddslink.app/docs/errors/#odds-unavailable", "request_id": "req_example" }}Headers
Section titled “Headers”Seconds to wait before retrying on 429 SPEED_LIMIT or 503 ODDS_UNAVAILABLE.
Something failed on our side.
object
object
Stored Unix-second choices on AMBIGUOUS_EVENT or INVALID_STORED_COMMENCE_TIME; independent of dateFormat.
Valid case-sensitive book keys on INVALID_BOOKMAKER.
403 only: the plan on the presented key.
403 only: the lowest plan that includes this request. For history, that depends on how long ago the fixture started as well as on the endpoint.
Example
{ "error": { "code": "INTERNAL_ERROR", "message": "Something went wrong on our side. It has been logged.", "docs_url": "https://oddslink.app/docs/errors/#internal-error", "request_id": "req_01hz8k4h8n0d4e9f" }}Headers
Section titled “Headers”Requests used this billing period.
Requests remaining this billing period.
What this one call cost against the allowance (0 for a free call).
This plan’s speed limit, in requests per second.
Requests left in the current one-second window.
Seconds until the speed-limit window resets.
This request’s id, for support and for matching against error.request_id.