Sports Odds API for Developers & AI Agents

Pre-game & in-play odds

Fetch current lines for any Lumify event with GET /v1/events/{id}/odds — before kickoff and while the event is in progress. Default scope is Pinnacle (1 credit) — the sharp reference most agents compare against. Pass bookmaker=all (or a list) when you need a multi-book shop — still 1 credit.

Moneyline, spread, and totals keep refreshing on the same ~10-minute ingest cycle once the game goes live. Books that stop posting live prices (common for sharp books on most sports) are omitted from the in-play response rather than shown with a stale, frozen-at-kickoff number next to books that are actually quoting.

Final events grade result and close from the pre-kickoff closing line, not whatever the last in-play price happened to be — so CLV comparisons and settlement stay anchored to the number that was actually available before the game started. Player props, team totals (NFL/NCAAF/MLB/soccer), and period lines (1H / F5 / S1) are a separate persisted surface that freezes at kickoff rather than following the game live — see /docs/player-props.

Always returns 200 when the event exists. Check available before reading bookmakers[] — empty books mean odds have not been ingested yet (and you are not charged).

Sportsbooks

Supported bookmaker keys (availability varies by event and sport):

This is not an 85–200 book firehose. Lumify trades raw book count for normalized schemas, agent metering, MCP, and an intelligence layer on top of the same events.

Markets

Each bookmaker entry returns markets in a stable order:

• h2h / moneyline — two-way for most sports; three-way for soccer (home, away, Draw)
• spreads — handicap with point on each side
• totals — Over / Under with a shared point

Prices are American odds integers. point is null on moneyline. Each outcome includes is_main. Default is mains only — pass include_alts=true for alternate spread/total rungs.

On status=final, outcomes include result (won / lost / push / void) plus close on spread/total points. MLB, tennis, and soccer (MLS + big-five) mains also mirror fair_price and consensus from published assessments.

Player props are a separate surface — /docs/player-props. Futures are not on v1.

History & line movement

GET /v1/events/{id}/odds/history returns every recorded price or point change between ingest cycles — newest first. Same bookmaker credit rules as current odds (1 credit single book, 2 for multi-book). Use it to detect steam, open→current deltas, and sharp-led moves before you act on a soft-book price.

For push-style alerts, subscribe to webhook line_move events — see the odds movement guide.

Normalization

Every book uses the same market keys, outcome shape, and event IDs as the rest of Lumify (schedules, scores, intelligence). Agents do not re-map DraftKings vs FanDuel field names or reconcile team strings — you get one event graph and seventeen price attachments.

Compound fetches: GET /v1/events/{id}?include_odds=true embeds the odds payload on the same 1-credit event call so you can skip a second round trip.

Examples

Multi-book current odds (1 credit):

curl "https://lumify.ai/v1/events/4821/odds?bookmaker=all" \
  -H "Authorization: Bearer YOUR_API_KEY"

from lumify import Lumify

client = Lumify(api_key="YOUR_API_KEY")
odds = client.events.odds(4821, bookmaker="all")
for book in odds["bookmakers"]:
    print(book["bookmaker"], book["markets"][0]["outcomes"])

import { Lumify } from "@lumifyai/sdk";

const client = new Lumify({ apiKey: "YOUR_API_KEY" });
const odds = await client.events.odds(4821, { bookmaker: "all" });
odds.bookmakers.forEach(b => console.log(b.bookmaker, b.markets[0]?.outcomes));

Line-movement history (Pinnacle, 1 credit):

curl "https://lumify.ai/v1/events/4821/odds/history?limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

history = client.events.odds_history(4821, limit=20)
for m in history["movements"]:
    print(m["moved_at"], m["outcome"], m["price_from"], "→", m["price_to"])

const history = await client.events.oddsHistory(4821, { limit: 20 });
history.movements.forEach(m =>
  console.log(m.moved_at, m.outcome, m.price_from, "→", m.price_to)
);

Sample multi-book response shape (abridged):

{
  "event_id": 4821,
  "available": true,
  "bookmakers": [
    {
      "bookmaker": "pinnacle",
      "markets": [
        {
          "key": "h2h",
          "label": "moneyline",
          "outcomes": [
            { "outcome": "Boston Celtics", "price": -145, "point": null },
            { "outcome": "New York Knicks", "price": 125, "point": null }
          ]
        }
      ],
      "captured_at": "2026-05-13T18:32:00Z"
    }
  ],
  "last_updated": "2026-05-13T18:32:00Z"
}

Agents & MCP

Odds are first-class MCP tools on the hosted Streamable-HTTP server at https://lumify.ai/mcp — get_odds and get_odds_history, metered per call with _meta.credits_used.

When price alone is not enough, call get_intelligence / GET /v1/events/{id}/intelligence for probability, fair price, and Price overlay on the same event IDs — main-line ev (Beta) is on that payload. Scan a sport with GET /v1/intelligence/ev / list_ev. Free POST /v1/estimate lets agents budget before spending.

Pricing

Free Tier includes 1,000 credits that never expire (20 req/min). Instant trial keys (100 credits, 14 days) need no signup — use the banner above. Details: /pricing.