Guides
Start typing to search…

API FAQ

We understand that navigating a new API can be both exciting and challenging. Whether you're just starting your free trial or are already a valued client, this FAQ is designed to address your most common questions and ensure a seamless experience.

Here, you’ll find answers to questions about setting up your API integration, managing data requests, troubleshooting common issues, and understanding subscription and usage policies. Our goal is to provide you with all the information you need to make the most out of the OpticOdds API, empowering you to access real-time data for various leagues across basketball, football, baseball, tennis, soccer, and more.

If you don’t find what you’re looking for, our support team is always ready to assist you. Let’s get started!

What is the request limit around the API?

The following rate limits apply for every 15s window, the limit resets after the 15s are completed:

  • Historical Odds: 10 requests every 15 seconds.
  • Streaming endpoints (new connections): 250 requests every 15 seconds.
  • All other endpoints: 2500 requests every 15 seconds.

These will all reset after 15 seconds.

Does OpticOdds provide a webhook or WebSocket to notify us of odds changes for a specific fixture?

We do not offer webhooks or WebSockets. However, we provide a Server-Sent Events (SSE) streaming endpoint that you can subscribe to for real-time odds updates. For more information, refer to our documentation: Stream Odds Endpoint.

How can I find out which markets OpticOdds supports?

You can use the /markets endpoint to retrieve a list of all markets that are or have been supported by OpticOdds. If you're looking for markets that are currently active, the /markets/active endpoint will provide that information. However, it won't list inactive markets; it only displays the markets currently available for the specified fixtures and sportsbooks.

How can I contact the support team if I encounter an issue while pulling odds?

If you experience any issues while pulling odds, the best way to resolve them in real-time is by contacting our support team via your sales rep.

API Documentation: Check for troubleshooting tips and updates.

What’s the difference between GET /fixtures and GET /fixtures/active?

GET /fixtures returns all available fixtures, regardless of whether odds have been associated with them. GET /fixtures/active only includes fixtures that have ever had odds associated with them, even if no odds are currently available. Fixtures listed in /fixtures but not in /fixtures/active may still have odds added in the future. For example, NBA odds are often only posted a couple of days before a game.

How can I stay informed about API outages or service disruptions?

You can monitor the status of our API by visiting the Status page, located at the bottom of OpticOdds.com. This page provides real-time updates on any outages or service issues.

Which markets are supported by the Bet Grading endpoint?

You can find the entire list of markets that are compatible with the bet grading endpoint via this link

How many sports books can I retrieve odds from in a single request?

Each request can retrieve data from up to 5 sports books simultaneously. To access data from additional sportsbooks, we recommend making parallel requests.

Do you provide limit and liquidity information?

Yes, this information is available for certain sportsbooks and can be accessed through the /fixtures/odds endpoint.

What timestamp format is the data provided in?

All timestamps are in ISO 8601 format. The timezone may be UTC (±0) or UTC-5, but since ISO 8601 is a standardized format, it ensures consistency across all data points.

How can I know which golf fixtures are h2h and which are for props?

The way our golf fixtures work is a little different than the way our fixtures for soccer/basketball any of our other sports work. There are two types of fixtures:

  1. For h2h, they will be the same as a tennis fixture, nothing different there.
  2. For fixtures that relate to round props, the away_team_display will be one of Round 1, Round 2, Round 3, or Round 4, the home_team_display will be the name of the tournament. These fixtures will not have any home_competitors or away_competitors.

What is OpticOdds AI and how does it work?

OpticOdds AI is an intelligent odds aggregation service that delivers a single, optimized price for each betting market. Rather than forcing you to compare odds across dozens of sportsbooks manually, our AI analyzes comprehensive market data in real-time to provide one accurate, consensus-driven price through a simple API integration.

How OpticOdds AI Works:

  • Smart Aggregation - Our AI processes odds from multiple premium data sources simultaneously
  • Consensus Pricing - Advanced algorithms identify the most accurate market price based on volume, timing, and source reliability
  • Real-Time Updates - Prices adjust instantly as markets move, ensuring you always have current information
  • Single Integration - One API call replaces the need to manage multiple sportsbook connections

Perfect For:

  • Sportsbooks looking to streamline odds management
  • Betting platforms seeking competitive pricing without complexity
  • Trading operations requiring fast, accurate market data
  • Any operator wanting to eliminate the overhead of managing multiple odds feeds

Updated 24 days ago