01
Trigger on event
- Listen for a new event
- Parse and validate the payload
- Take an action with the linked tool
The Odds API
8 tools available
The Odds API provides real-time sports betting odds data from various bookmakers worldwide, covering multiple sports and betting markets.
Connect The Odds API to Definable to automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas call The Odds API's 8 tools directly from chat or scheduled flows. You can wire it into any persona to read, write, and react when an event fires.
Common workflows with The Odds API
02
Daily summary
- Pull yesterday's activity
- Summarise with the model of your choice
- Send the digest via email or Slack
03
Cross-tool sync
- Read records from one app
- Transform with a persona
- Write the result back via this integration
The Odds API actions 8
Every The Odds API action below is a callable tool any Definable persona can invoke.
Get Event Markets
Tool to retrieve available market keys for each bookmaker for a specific event. Returns only recently seen markets - not a comprehensive list. More markets become available as the event's commence time approaches.
Get Event Odds
Tool to retrieve odds for a specific event. Use after confirming sport key via THE_ODDS_API_GET_SPORTS and event ID via THE_ODDS_API_GET_EVENTS; mismatched values return empty payloads rather than errors.
Get Events
Tool to fetch live and upcoming events for a specified sport. Use when you need event listings including odds. All timestamps are UTC. Avoid high-frequency polling; batch requests and implement backoff to prevent throttling.
Get Odds
Tool to fetch live and upcoming event odds for a specified sport, including bookmakers, regions, and markets. Use after retrieving sports via GET_SPORTS; filter by region, market, or event IDs. Response is nested bookmakers → markets → outcomes; not all bookmakers expose every market for every event, so handle missing keys and empty arrays defensively. Combining multiple regions, markets, and eventIds produces large payloads — narrow to one region or specific eventIds where possible.
Get Participants
Tool to fetch list of participants (teams or players) for a specified sport. Use after confirming you have a valid sport key.
Get Scores
Tool to return live and recently completed event scores for a sport. Use after selecting a sport key to inspect current and recent game scores. Missing results may indicate unsupported competitions, not absent events. When identifying specific fixtures, match by both team names and date to avoid confusion with multi-leg ties or similarly named teams.
Get Sports
Tool to retrieve a list of in-season sports. Use when you need sports data; set 'all' to true to include out-of-season sports. Sport keys returned here must be passed to downstream tools like THE_ODDS_API_GET_EVENTS and THE_ODDS_API_GET_EVENT_ODDS — mismatched or guessed keys return empty payloads. Similarly named leagues and qualifier competitions appear as distinct entries with unique keys; verify the exact key before use.
Get Odds (V3 Legacy)
Tool to fetch odds using the legacy V3 API endpoint. Returns upcoming and live games with odds for a given sport, region, and market. Use for legacy integrations; V4 API is recommended for new implementations.
Dungeon Fighter Online
Dungeon Fighter Online (DFO) is an arcade-style, side-scrolling action game with RPG elements, offering players a dynamic combat experience.
Epic Games
Epic Games is a video game developer and publisher known for titles like Fortnite and the Unreal Engine, offering an online store and platform
Habitica
Habitica is an open-source task management application that gamifies productivity by turning tasks into role-playing game elements.
RAWG Video Games Database
The largest video game database and video game discovery service with comprehensive game information, ratings, platforms, and release dates.
Frequently asked questions
What can I automate with The Odds API on Definable?
Anything The Odds API exposes through its API. Common gaming workflows on Definable include automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas can call any of the 8 The Odds API tools directly, then chain the result into another integration without you writing code.
How does The Odds API authentication work?
The Odds API uses API_KEY on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.
Is the The Odds API integration included in my Definable plan?
Yes — every Definable plan, including Starter, includes access to all 8 The Odds API tools. You only need a separate The Odds API subscription if The Odds API itself charges per seat or per API call.
Is using The Odds API through Definable secure?
Every call from a persona to The Odds API is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.
How do I get started with The Odds API on Definable?
Sign up for Definable, open the integrations page, find The Odds API, and connect via OAuth or API key. You can immediately attach The Odds API to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.
What The Odds API actions does Definable expose?
Definable exposes all 8 The Odds API actions as callable tools — including `Get Event Markets`, `Get Event Odds`, `Get Events`, plus 5 more. Each tool gets a typed parameter schema so personas know exactly how to call it.
Ready to automate with The Odds API?
Wire it up in minutes. No coding required.