{"openapi":"3.1.0","info":{"title":"DARIMARKET public API","version":"1.0.0","summary":"DARIMARKET is a 21+ sports research app that shows player prop hit rates, matchups and research for FanDuel and DraftKings users.","description":"DARIMARKET is a 21+ sports research app that shows player prop hit rates, matchups and research for FanDuel and DraftKings users. Read-only and free: today's games, today's best hit rates (9 of 10 or better), player search, last-5 and last-10 player prop hit rates, and Academy articles. No key needed. Limit: 60 requests a minute per IP. Responses are cached for 5 minutes. Always show users the view_url and as_of time. 21+. Research only: DARIMARKET is not a sportsbook, does not take bets and guarantees nothing. Hit rates describe past games, not future results. Only lines FanDuel or DraftKings post are shown. Gambling problem? Call 1-800-MY-RESET.","contact":{"name":"DARIMARKET","email":"hello@darimarket.us","url":"https://darimarket.us/agents"},"termsOfService":"https://darimarket.us/terms"},"servers":[{"url":"https://darimarket.us/api/v1"}],"externalDocs":{"description":"MCP server and setup for ChatGPT and Claude","url":"https://darimarket.us/agents"},"paths":{"/games/today":{"get":{"operationId":"getTodaysGames","summary":"Today's games (Eastern date)","description":"Use when the user asks what NFL, college football, NBA, WNBA, MLB or NHL games are on today, with start times.","parameters":[{"name":"sport","in":"query","required":false,"schema":{"type":"string","enum":["NFL","CFB","NBA","WNBA","MLB","NHL"]}}],"responses":{"200":{"description":"Games","content":{"application/json":{"schema":{"type":"object","required":["as_of","disclaimer","view_url"],"properties":{"as_of":{"type":"string","description":"When the data was last updated, Eastern time, e.g. 'Oct 22, 2026, 7:40 PM ET'"},"disclaimer":{"type":"string"},"view_url":{"type":"string","format":"uri","description":"Page on darimarket.us to send the user to (tagged utm_source=agent&utm_medium=api)"},"date_et":{"type":"string"},"games":{"type":"array","items":{"type":"object","properties":{"sport":{"type":"string"},"away":{"type":"string"},"home":{"type":"string"},"away_team":{"type":"string"},"home_team":{"type":"string"},"starts_et":{"type":["string","null"]},"starts_at":{"type":["string","null"],"format":"date-time"},"status":{"type":"string","enum":["upcoming","live","final"],"description":"From the scheduled start and typical game length"},"view_url":{"type":"string"}}}}}}}}},"429":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"as_of":{"type":"string","description":"When the data was last updated, Eastern time, e.g. 'Oct 22, 2026, 7:40 PM ET'"},"disclaimer":{"type":"string"},"view_url":{"type":"string","format":"uri","description":"Page on darimarket.us to send the user to (tagged utm_source=agent&utm_medium=api)"}}}}}},"503":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"as_of":{"type":"string","description":"When the data was last updated, Eastern time, e.g. 'Oct 22, 2026, 7:40 PM ET'"},"disclaimer":{"type":"string"},"view_url":{"type":"string","format":"uri","description":"Page on darimarket.us to send the user to (tagged utm_source=agent&utm_medium=api)"}}}}}}}}},"/today/best":{"get":{"operationId":"getTodaysBestHitRates","summary":"Today's best player prop hit rates (9 of 10 or better)","description":"Use when the user asks for today's or tonight's best or most consistent player prop hit rates. Lines that cleared in 9 or more of the player's last 10 games, for games that haven't started (injured players left out), best line per player. Leave sport out for every sport with games today. Past results, not predictions.","parameters":[{"name":"sport","in":"query","required":false,"schema":{"type":"string","enum":["NFL","CFB","NBA","WNBA","MLB","NHL"]}}],"responses":{"200":{"description":"Today's best lines","content":{"application/json":{"schema":{"type":"object","required":["as_of","disclaimer","view_url"],"properties":{"as_of":{"type":"string","description":"When the data was last updated, Eastern time, e.g. 'Oct 22, 2026, 7:40 PM ET'"},"disclaimer":{"type":"string"},"view_url":{"type":"string","format":"uri","description":"Page on darimarket.us to send the user to (tagged utm_source=agent&utm_medium=api)"},"date_et":{"type":"string","example":"2026-10-28"},"sport":{"type":"string","description":"The sport asked for, or ALL"},"games_not_started":{"type":"integer"},"count":{"type":"integer","description":"Lines found (up to 50 are returned)"},"lines":{"type":"array","items":{"type":"object","properties":{"sport":{"type":"string"},"player":{"type":"string"},"team":{"type":"string"},"position":{"type":"string"},"game":{"oneOf":[{"type":"object","properties":{"opponent":{"type":"string"},"home":{"type":"boolean"},"starts_et":{"type":["string","null"]}}},{"type":"null"}]},"stat":{"type":"string"},"line":{"type":"string","example":"over 24.5 points"},"last10":{"type":"string","example":"9 of 10"},"last5":{"type":"string","example":"5 of 5"},"last10_pct":{"type":"integer"},"avg_last10":{"type":"number"},"posted_by":{"type":"array","items":{"type":"object","properties":{"book":{"type":"string","enum":["FanDuel","DraftKings"]},"line":{"type":"number"}}}},"player_view_url":{"type":"string","format":"uri"},"game_view_url":{"type":["string","null"],"format":"uri"}}}},"note":{"type":"string"}}}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"as_of":{"type":"string","description":"When the data was last updated, Eastern time, e.g. 'Oct 22, 2026, 7:40 PM ET'"},"disclaimer":{"type":"string"},"view_url":{"type":"string","format":"uri","description":"Page on darimarket.us to send the user to (tagged utm_source=agent&utm_medium=api)"}}}}}},"429":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"as_of":{"type":"string","description":"When the data was last updated, Eastern time, e.g. 'Oct 22, 2026, 7:40 PM ET'"},"disclaimer":{"type":"string"},"view_url":{"type":"string","format":"uri","description":"Page on darimarket.us to send the user to (tagged utm_source=agent&utm_medium=api)"}}}}}},"503":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"as_of":{"type":"string","description":"When the data was last updated, Eastern time, e.g. 'Oct 22, 2026, 7:40 PM ET'"},"disclaimer":{"type":"string"},"view_url":{"type":"string","format":"uri","description":"Page on darimarket.us to send the user to (tagged utm_source=agent&utm_medium=api)"}}}}}}}}},"/players/search":{"get":{"operationId":"searchPlayers","summary":"Find a player and get the slug for hit rates","description":"Use when the user names a player. Returns the slug the hit-rates endpoint takes.","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2},"example":"cade cunningham"},{"name":"sport","in":"query","required":false,"schema":{"type":"string","enum":["NFL","CFB","NBA","WNBA","MLB","NHL"]}}],"responses":{"200":{"description":"Matching players","content":{"application/json":{"schema":{"type":"object","required":["as_of","disclaimer","view_url"],"properties":{"as_of":{"type":"string","description":"When the data was last updated, Eastern time, e.g. 'Oct 22, 2026, 7:40 PM ET'"},"disclaimer":{"type":"string"},"view_url":{"type":"string","format":"uri","description":"Page on darimarket.us to send the user to (tagged utm_source=agent&utm_medium=api)"},"results":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"sport":{"type":"string"},"team":{"type":["string","null"]},"position":{"type":["string","null"]},"slug":{"type":"string","example":"nba-4432158-cade-cunningham"},"next_game":{"oneOf":[{"type":"object","properties":{"opponent":{"type":"string"},"home":{"type":"boolean"},"starts_et":{"type":["string","null"]}}},{"type":"null"}]},"view_url":{"type":"string"}}}}}}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"as_of":{"type":"string","description":"When the data was last updated, Eastern time, e.g. 'Oct 22, 2026, 7:40 PM ET'"},"disclaimer":{"type":"string"},"view_url":{"type":"string","format":"uri","description":"Page on darimarket.us to send the user to (tagged utm_source=agent&utm_medium=api)"}}}}}},"429":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"as_of":{"type":"string","description":"When the data was last updated, Eastern time, e.g. 'Oct 22, 2026, 7:40 PM ET'"},"disclaimer":{"type":"string"},"view_url":{"type":"string","format":"uri","description":"Page on darimarket.us to send the user to (tagged utm_source=agent&utm_medium=api)"}}}}}}}}},"/players/{slug}/hit-rates":{"get":{"operationId":"getPlayerHitRates","summary":"Last-5 and last-10 prop hit rates for one player","description":"Use when the user asks how often a player has gone over or under a line recently. Lines are listed only when FanDuel or DraftKings posts them for the next game; pass line to check any number against the last 10 games. Past results, not predictions.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"example":"nba-4432158-cade-cunningham"},{"name":"stat","in":"query","required":false,"schema":{"type":"string"},"description":"Stat key or words: pts, points, reb, ast, 3pm, rec_yds, receiving yards, sog, shots, hits, k, strikeouts…"},{"name":"line","in":"query","required":false,"schema":{"type":"number"},"example":24.5},{"name":"side","in":"query","required":false,"schema":{"type":"string","enum":["over","under"]}}],"responses":{"200":{"description":"Hit rates","content":{"application/json":{"schema":{"type":"object","required":["as_of","disclaimer","view_url"],"properties":{"as_of":{"type":"string","description":"When the data was last updated, Eastern time, e.g. 'Oct 22, 2026, 7:40 PM ET'"},"disclaimer":{"type":"string"},"view_url":{"type":"string","format":"uri","description":"Page on darimarket.us to send the user to (tagged utm_source=agent&utm_medium=api)"},"player":{"type":"object","properties":{"name":{"type":"string"},"sport":{"type":"string"},"team":{"type":["string","null"]},"position":{"type":["string","null"]},"slug":{"type":"string"}}},"next_game":{"oneOf":[{"type":"object","properties":{"opponent":{"type":"string"},"home":{"type":"boolean"},"starts_et":{"type":["string","null"]}}},{"type":"null"}]},"lines_note":{"type":"string"},"stats":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"stat":{"type":"string"},"avg_last10":{"type":"number"},"median_last10":{"type":"number"},"last10_values_oldest_to_newest":{"type":"array","items":{"type":"number"}},"lines_posted":{"type":"array","items":{"type":"object","properties":{"line":{"type":"string"},"book_line":{"type":["string","null"]},"last5":{"type":"string"},"last10":{"type":"string"},"last10_pct":{"type":["integer","null"]},"posted_by":{"type":"array","items":{"type":"string","enum":["fanduel","draftkings"]}}}}},"threshold":{"oneOf":[{"type":"object","properties":{"asked":{"type":"string"},"last5":{"type":"string"},"last10":{"type":"string"},"note":{"type":"string"}}},{"type":"null"}]}}}},"sniper_only":{"type":"array","items":{"type":"string"}}}}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"as_of":{"type":"string","description":"When the data was last updated, Eastern time, e.g. 'Oct 22, 2026, 7:40 PM ET'"},"disclaimer":{"type":"string"},"view_url":{"type":"string","format":"uri","description":"Page on darimarket.us to send the user to (tagged utm_source=agent&utm_medium=api)"}}}}}},"404":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"as_of":{"type":"string","description":"When the data was last updated, Eastern time, e.g. 'Oct 22, 2026, 7:40 PM ET'"},"disclaimer":{"type":"string"},"view_url":{"type":"string","format":"uri","description":"Page on darimarket.us to send the user to (tagged utm_source=agent&utm_medium=api)"}}}}}},"429":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"as_of":{"type":"string","description":"When the data was last updated, Eastern time, e.g. 'Oct 22, 2026, 7:40 PM ET'"},"disclaimer":{"type":"string"},"view_url":{"type":"string","format":"uri","description":"Page on darimarket.us to send the user to (tagged utm_source=agent&utm_medium=api)"}}}}}}}}},"/parlay/check":{"post":{"operationId":"checkParlay","summary":"Check every leg of a parlay against recent games","description":"Use when the user wants to check a parlay or several player props before placing it. Per leg: last-10 and last-5 counts on that exact number, last-10 average, home/road split (last 20), next opponent and start time, a verdict and the weakest-leg flag. all_legs_together appears only when the legs shared real games (same player, teammates or the same matchup); otherwise it is null and all_legs_together_note says why. Past results, not predictions. Up to 8 legs.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["legs"],"properties":{"legs":{"type":"array","minItems":1,"maxItems":8,"items":{"type":"object","required":["player","stat","line"],"properties":{"player":{"type":"string","description":"Slug from /players/search or a full name","example":"nba-4432158-cade-cunningham"},"stat":{"type":"string","example":"pts"},"line":{"type":"number","example":24.5},"side":{"type":"string","enum":["over","under"]}}}}}}}}},"responses":{"200":{"description":"Checked legs","content":{"application/json":{"schema":{"type":"object","required":["as_of","disclaimer","view_url"],"properties":{"as_of":{"type":"string","description":"When the data was last updated, Eastern time, e.g. 'Oct 22, 2026, 7:40 PM ET'"},"disclaimer":{"type":"string"},"view_url":{"type":"string","format":"uri","description":"Page on darimarket.us to send the user to (tagged utm_source=agent&utm_medium=api)"},"legs":{"type":"array","items":{"type":"object"}},"weakest_leg":{"type":["integer","null"]},"all_legs_together":{"oneOf":[{"type":"object","properties":{"legs":{"type":"integer"},"games":{"type":"integer"},"all_cleared":{"type":"integer"},"text":{"type":"string"}}},{"type":"null"}]},"all_legs_together_note":{"type":["string","null"]},"note":{"type":"string"}}}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"as_of":{"type":"string","description":"When the data was last updated, Eastern time, e.g. 'Oct 22, 2026, 7:40 PM ET'"},"disclaimer":{"type":"string"},"view_url":{"type":"string","format":"uri","description":"Page on darimarket.us to send the user to (tagged utm_source=agent&utm_medium=api)"}}}}}},"429":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"as_of":{"type":"string","description":"When the data was last updated, Eastern time, e.g. 'Oct 22, 2026, 7:40 PM ET'"},"disclaimer":{"type":"string"},"view_url":{"type":"string","format":"uri","description":"Page on darimarket.us to send the user to (tagged utm_source=agent&utm_medium=api)"}}}}}},"503":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"as_of":{"type":"string","description":"When the data was last updated, Eastern time, e.g. 'Oct 22, 2026, 7:40 PM ET'"},"disclaimer":{"type":"string"},"view_url":{"type":"string","format":"uri","description":"Page on darimarket.us to send the user to (tagged utm_source=agent&utm_medium=api)"}}}}}}}},"get":{"operationId":"checkParlayByCode","summary":"Same check, legs as a share code","description":"legs = comma-separated codes sport-id.stat.o|uLINE, e.g. nba-4432158.pts.o24.5 (the format darimarket.us/parlay-checker?legs= uses).","parameters":[{"name":"legs","in":"query","required":true,"schema":{"type":"string"},"example":"nba-4432158.pts.o24.5,nba-4432158.ast.o6.5"}],"responses":{"200":{"description":"Checked legs","content":{"application/json":{"schema":{"type":"object","required":["as_of","disclaimer","view_url"],"properties":{"as_of":{"type":"string","description":"When the data was last updated, Eastern time, e.g. 'Oct 22, 2026, 7:40 PM ET'"},"disclaimer":{"type":"string"},"view_url":{"type":"string","format":"uri","description":"Page on darimarket.us to send the user to (tagged utm_source=agent&utm_medium=api)"},"legs":{"type":"array","items":{"type":"object"}}}}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"as_of":{"type":"string","description":"When the data was last updated, Eastern time, e.g. 'Oct 22, 2026, 7:40 PM ET'"},"disclaimer":{"type":"string"},"view_url":{"type":"string","format":"uri","description":"Page on darimarket.us to send the user to (tagged utm_source=agent&utm_medium=api)"}}}}}},"429":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"as_of":{"type":"string","description":"When the data was last updated, Eastern time, e.g. 'Oct 22, 2026, 7:40 PM ET'"},"disclaimer":{"type":"string"},"view_url":{"type":"string","format":"uri","description":"Page on darimarket.us to send the user to (tagged utm_source=agent&utm_medium=api)"}}}}}}}}},"/learn":{"get":{"operationId":"getLearnArticles","summary":"Academy articles and glossary terms","description":"Use when the user asks what a betting term means (parlay, alt line, vig, implied probability, bankroll, closing line value) or wants an explainer.","parameters":[{"name":"topic","in":"query","required":false,"schema":{"type":"string"},"example":"parlay"}],"responses":{"200":{"description":"Articles","content":{"application/json":{"schema":{"type":"object","required":["as_of","disclaimer","view_url"],"properties":{"as_of":{"type":"string","description":"When the data was last updated, Eastern time, e.g. 'Oct 22, 2026, 7:40 PM ET'"},"disclaimer":{"type":"string"},"view_url":{"type":"string","format":"uri","description":"Page on darimarket.us to send the user to (tagged utm_source=agent&utm_medium=api)"},"topic":{"type":["string","null"]},"articles":{"type":"array","items":{"type":"object"}},"glossary":{"type":"array","items":{"type":"object"}}}}}}},"429":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"as_of":{"type":"string","description":"When the data was last updated, Eastern time, e.g. 'Oct 22, 2026, 7:40 PM ET'"},"disclaimer":{"type":"string"},"view_url":{"type":"string","format":"uri","description":"Page on darimarket.us to send the user to (tagged utm_source=agent&utm_medium=api)"}}}}}}}}}}}