Recorded full-game prop price changes for one fixture
using System.Net.Http.Headers;var client = new HttpClient();var request = new HttpRequestMessage{ Method = HttpMethod.Get, RequestUri = new Uri("https://oddslink.app/v1/historical/sports/nfl/events/nfl%3Aatlantafalcons-carolinapanthers%3A2026-09-20/props/movement?markets=player_anytime_td%2Cplayer_pass_yds&periods=full%2C1h&bookmakers=draftkings%2Cfanduel&oddsFormat=american&dateFormat=iso"), 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/historical/sports/nfl/events/nfl%3Aatlantafalcons-carolinapanthers%3A2026-09-20/props/movement?markets=player_anytime_td%2Cplayer_pass_yds&periods=full%2C1h&bookmakers=draftkings%2Cfanduel&oddsFormat=american&dateFormat=iso"
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/historical/sports/nfl/events/nfl%3Aatlantafalcons-carolinapanthers%3A2026-09-20/props/movement?markets=player_anytime_td%2Cplayer_pass_yds&periods=full%2C1h&bookmakers=draftkings%2Cfanduel&oddsFormat=american&dateFormat=iso") .get() .addHeader("X-API-Key", "<X-API-Key>") .build();
Response response = client.newCall(request).execute();const url = 'https://oddslink.app/v1/historical/sports/nfl/events/nfl%3Aatlantafalcons-carolinapanthers%3A2026-09-20/props/movement?markets=player_anytime_td%2Cplayer_pass_yds&periods=full%2C1h&bookmakers=draftkings%2Cfanduel&oddsFormat=american&dateFormat=iso';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/historical/sports/nfl/events/nfl%3Aatlantafalcons-carolinapanthers%3A2026-09-20/props/movement?markets=player_anytime_td%2Cplayer_pass_yds&periods=full%2C1h&bookmakers=draftkings%2Cfanduel&oddsFormat=american&dateFormat=iso' \ --header 'X-API-Key: <X-API-Key>'Every recorded pre-match price change of every full-game player prop, from capture activation onward. Requires Scale or Business. Scale covers fixtures starting in the last 2 years. Same shape as the checkpoint series; each point is one change instant (checkpoint move) and carries every side’s price at that instant plus whether the line was the book’s main line. A price is recorded only when it changes, so an unchanged price between two points held. No earlier prices are reconstructed. Halves and quarters are not archived.
Authorizations
Section titled “Authorizations”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters”A historical sport key: nfl, ncaaf, nba, wnba, mlb, nhl, mma, aggregate soccer or aggregate tennis. nhl and mlb serve the same franchise fixtures as their live routes. A soccer league key such as epl serves fixtures with a recorded league matching that key, including older fixtures. Fixtures without a recorded league are served by the aggregate soccer key only. An event outside the key’s league answers 404 UNKNOWN_EVENT, like an unknown ID. League and tournament query selectors are rejected with 400 BAD_REQUEST. Tournament-specific tennis_* keys are not supported by history. Esports history also accepts cs2, lol, dota2, valorant, from the start of recording; earlier esports prices are not backfilled.
Example
nflA fixture id, as returned by GET /v1/sports/{sport}/events. Treat as opaque.
Example
nfl:atlantafalcons-carolinapanthers:2026-09-20Query Parameters
Section titled “Query Parameters”Select an exact stored listed kickoff from error.stored_commence_times or historical discovery. ISO with timezone or Unix seconds. Required when multiple eligible stored kickoffs remain. Empty duplicate kickoffs are not choices when another kickoff has recorded prices; selecting one returns INVALID_STORED_COMMENCE_TIME. Entirely empty tracked fixtures remain selectable. No archival prices are rewritten.
Comma-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.
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.
Responses
Section titled “ Responses ”Recorded full-game prop price changes for one fixture.
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.
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.
object
Movement points only. Whether this line was the book’s main line for the player and stat at that instant.
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.
Examples
Illustrative recorded prop price changes, not proof of fixture coverage
{ "id": "nfl:atlantafalcons-carolinapanthers:2026-10-04", "sport_key": "nfl", "sport_title": "NFL", "commence_time": "2026-10-04T17:00:00.000Z", "is_live": false, "home_team": "Atlanta Falcons", "away_team": "Carolina Panthers", "capture_started_at": "2026-10-04T16:00:00.000Z", "status": "recorded", "props": [ { "bookmaker": { "key": "draftkings", "title": "DraftKings", "last_update": "2026-10-04T16:59:40.125Z" }, "player": "Example Quarterback", "stat": "player_pass_yds", "point": 249.5, "points": [ { "checkpoint": "move", "main": true, "status": "recorded", "recorded_at": "2026-10-04T16:59:41.250Z", "outcomes": [ { "name": "Over", "price": -110, "last_update": "2026-10-04T16:59:40.125Z" }, { "name": "Under", "price": -110, "last_update": "2026-10-04T16:59:40.125Z" } ] } ] } ], "coverage": [], "unmatched_bookmakers": []}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 history (Scale plan and up), or does not reach back to this fixture: Scale covers fixtures that started in the last 2 years, Business covers everything recorded.
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
History is not on this plan
{ "error": { "code": "PLAN_REQUIRED", "message": "History requires the Scale plan or above.", "docs_url": "https://oddslink.app/docs/errors/#plan-required", "request_id": "req_01hz8k4c4j6z0a5b", "current_plan": "growth", "required_plan": "scale" }}This fixture is older than the plan's 2-year window
{ "error": { "code": "PLAN_REQUIRED", "message": "The Scale plan covers fixtures that started in the last 2 years. This one started 2024-09-02; the Business plan covers everything recorded.", "docs_url": "https://oddslink.app/docs/errors/#plan-required", "request_id": "req_01hz8k4c5k7a1b6c", "current_plan": "scale", "required_plan": "business" }}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, or the fixture id within it, 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.
Examples
No fixture with this id under this sport key
{ "error": { "code": "UNKNOWN_EVENT", "message": "Unknown fixture id for nfl: nfl:atlantafalcons-carolinapanthers:2026-09-27", "docs_url": "https://oddslink.app/docs/errors/#unknown-event", "request_id": "req_01hz8k4d6m8b2c7d" }}Sport key does not exist
{ "error": { "code": "UNKNOWN_SPORT", "message": "Unknown sport key: basketbal_nba", "docs_url": "https://oddslink.app/docs/errors/#unknown-sport", "request_id": "req_01hz8k4d7n9c3d8e" }}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.