First API Call in 5 Minutes

1. Get your API key

Click Get instant trial key in the banner above — no signup required. Keys look like lmfy-xxxxxx.yyyy… and are passed as a Bearer token on every request.

For a persistent account: sign up (Free Tier includes 1,000 credits that never expire — no credit card), then create a key in the API Keys dashboard. Dashboard keys are shown only once — copy immediately.

2. Make your first call

All /v1/* endpoints require the Authorization: Bearer header and return JSON. Fetch today's scheduled MLB games:

curl "https://lumify.ai/v1/events?sport=mlb&status=scheduled" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

resp = requests.get(
    "https://lumify.ai/v1/events",
    params={"sport": "mlb", "status": "scheduled"},
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
games = resp.json()["events"]
print(f"{len(games)} games today")

const { events } = await fetch(
  "https://lumify.ai/v1/events?sport=mlb&status=scheduled",
  { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
).then(r => r.json());
console.log(`${events.length} games today`);

Response

{
  "events": [
    {
      "id":         9199,
      "name":       "Atlanta Braves @ San Diego Padres",
      "sport":      "mlb",
      "league":     "mlb",
      "status":     "scheduled",
      "starts_at":  "2026-06-23T23:40:00Z",
      "venue":      { "id": 42, "name": "Petco Park", "city": "San Diego" }
    }
  ],
  "total":          1,
  "next_after_id":  null
}

That's a successful call — grab any id from events for the next request.

3. Next (2 minutes) — Get bet intelligence for a game

Take any id from the events response and fetch its intelligence payload. On MLB, tennis, soccer, NFL, and NCAAF that includes predictive bets[] (probability / fair_price). On NBA, NCAAB, and NHL, available is often false and bets[] is empty — still read forecasts[], or scan the daily board with GET /v1/intelligence/forecasts (MCP list_forecasts). How to read that payload: Understanding Odds.

curl "https://lumify.ai/v1/events/9199/intelligence" \
  -H "Authorization: Bearer YOUR_API_KEY"

event_id = games[0]["id"]
intel = requests.get(
    f"https://lumify.ai/v1/events/{event_id}/intelligence",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
).json()

for bet in intel["bets"]:
    print(bet["bet_type"], bet.get("probability"), bet.get("fair_price"))

const intel = await fetch(
  `https://lumify.ai/v1/events/${events[0].id}/intelligence`,
  { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
).then(r => r.json());
intel.bets.forEach(b => console.log(b.bet_type, b.probability, b.fair_price));

Response (abbreviated)

{
  "event_id":        9199,
  "available":       true,
  "has_recommend":   false,
  "match_overview":  "Padres host Braves with Eovaldi on the mound.",
  "rationale":       ["Eovaldi listed as SP", "Braves on back end of road trip"],
  "bets": [
    {
      "bet_type":     "ML_P1",
      "player_name":  "San Diego Padres",
      "probability":  0.548,
      "fair_price":   -121,
      "tier":         null
    }
  ]
}

One predictive surface: probability, interval, fair_price, market, edge / tier (null today), plus Price fair / edges_by_book / best. Framework plumbing like phase / blend_w / p_model is omitted. Full definitions: API reference.

4. Explore the endpoints

5. Credits & rate limits

• Each successful API call costs 1 credit. Compound calls (include_odds / include_intelligence) and multi-bookmaker odds (bookmaker=all) do not add extra.
• Failed requests (4xx / 5xx) do not consume credits.
• Rate limits are enforced per API key on a sliding 60-second window. Every response includes X-RateLimit-* headers so you can throttle proactively. Exceeding the limit returns 429 Too Many Requests with a retry_after value.

Next steps

• Understanding Odds — how to read a wager from an intelligence response
• API Reference — full endpoint documentation with curl, Python, and JavaScript examples
• Pricing — plans and credit allowances
• FAQ — data coverage, billing, and integration questions

Troubleshooting

Need help? Contact [email protected].