---
title: "The Odds API integration for LuumenAI"
url: "https://www.luumen.ai/integrations/the-odds-api/"
entity: SoftwareIntegration
category: "Databases & data platforms"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# The Odds API integration for LuumenAI

Read live sports odds, scores, and events from the Odds API in your terminal

## What LuumenAI can do with The Odds API

LuumenAI connects to The Odds API with an API token and exposes 8 tools (8 read-only). Every tool is read-only, so it can answer questions from The Odds API but cannot change anything in it. Read actions still follow the configured access and approval policy.

## Key facts

- Authentication: API token
- Tools available: 8 tools (8 read-only)
- Deployment: scoped as part of your Pilot, Platform, or Managed rollout
- Category: Databases & data platforms

## About The Odds API with LuumenAI

Ask what is in season, which events are running, and what the bookmakers are quoting — without leaving the terminal. THE_ODDS_API_GET_SPORTS and THE_ODDS_API_GET_EVENTS frame the question; THE_ODDS_API_GET_ODDS and THE_ODDS_API_GET_EVENT_ODDS return prices by region and market. Scores, participants, and per-event market keys are there too. Read-only, authenticated with an API key.

## Example tools

Read-only (8 in total):

- `THE_ODDS_API_GET_EVENT_MARKETS` — Retrieve available market keys for each bookmaker for a specific event.
- `THE_ODDS_API_GET_EVENT_ODDS` — Retrieve odds for a specific event.
- `THE_ODDS_API_GET_EVENTS` — Fetch live and upcoming events for a specified sport.
- `THE_ODDS_API_GET_ODDS` — Fetch live and upcoming event odds for a specified sport, including bookmakers, regions, and markets.
- `THE_ODDS_API_GET_PARTICIPANTS` — Fetch list of participants (teams or players) for a specified sport.
- `THE_ODDS_API_GET_SCORES` — Return live and recently completed event scores for a sport.
- `THE_ODDS_API_GET_SPORTS` — Retrieve a list of in-season sports.
- `THE_ODDS_API_GET_V3_ODDS` — Fetch odds using the legacy V3 API endpoint.

## Frequently asked questions

### How does LuumenAI connect to The Odds API?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in The Odds API on its own?

No. Every one of the 8 tools is read-only, so LuumenAI can answer questions from The Odds API but cannot change anything in it. Read actions still follow the configured access and approval policy.

### Is there an audit trail?

Every call to The Odds API is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/the-odds-api/