Documentation

Onyx Odds API Docs

Everything you need to pull matchup data, win probabilities, and pre-game talking points into your editorial workflow or fan product. REST API, JSON responses, under 200ms median latency.

Overview

The Onyx Odds API gives sports media teams and fan-platform developers programmatic access to pre-game matchup analysis, win-probability scores, upset-risk ratings, and structured talking points formatted for editorial use. No data science team required.

Base URL: https://api.onxyodds.com/v1

What you can build

The API is designed for two use cases that share the same data layer:

  • Sports media editorial tools that generate pre-game content angles, headlines, and confidence-band callouts for broadcast or digital properties.
  • Fan community features that surface prediction scores, upset alerts, and debate-starting stat comparisons to drive pre-game engagement.

Quick links

Quickstart

Make your first API call in under five minutes. Authenticate, fetch a matchup, and pull talking points.

API Reference

Full endpoint documentation with request parameters, response schemas, and inline code examples.

Authentication

API key setup, header format, and how to rotate keys from your dashboard.

Talking Points

Structured JSON objects with headline copy, confidence framing, and editorial tags ready for CMS injection.

Response format

All endpoints return JSON. Successful responses use HTTP 200 with a data envelope. Errors use standard HTTP status codes with a machine-readable error.code field and a human-readable error.message.

JSON 
{
  "data": { ... },
  "meta": {
    "request_id": "req_01j9k4x2m3",
    "generated_at": "2026-07-08T14:22:11Z",
    "model_version": "v4.1"
  }
}

Rate limits

Rate limits vary by plan. All plans return standard X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers on every response. Exceeding your limit returns a 429 Too Many Requests with a Retry-After header.

Plan Requests / minute Requests / month
Scout 60 50,000
Broadcast 300 500,000
Network Custom Custom

Support

For integration questions, reach out to [email protected] or book a short call with the team. Most questions get a response within one business day.