Matchbook Odds API

Matchbook winners, handicaps and totals across 270 leagues, with 250+ bookmakers in the same API. Streaming and REST included.

GET /v1/events/{event_id}/exchange/orderbook/snapshot?exchanges=matchbook&depth=2
{
  "event_id": "2780053462",
  "items": [
    {
      "exchange": "matchbook",
      "exchange_market_id": "34800021083400023",
      "market_key": "moneyline",
      "period_str": "full time",
      "total_matched": 0.0,
      "selections": [
        {
          "selection_key": "34800021084101023",
          "selection_name": "Skyliners Frankfurt",
          "last_traded_price": null,
          "available_to_back": [
            { "price": 2.3, "size": 7.43868 },
            { "price": 2.28, "size": 7.49447 }
            
          ],
          "available_to_lay": [
            { "price": 2.68, "size": 15.7917 },
            { "price": 2.74, "size": 22.98592 }
            
          ],
          "best_back_price": 2.3,
          "best_back_size": 7.43868,
          "best_lay_price": 2.68,
          "best_lay_size": 15.7917
        }
      ]
    }
  ],
  "resume": "1794449464217-0"
}
10 Matchbook markets
  • Football odds
  • Tennis totals
  • Basketball spreads
  • American football totals
  • Baseball run lines
  • Ice hockey lines
  • Cricket winners
  • MMA winners
  • Rugby league odds
  • Rugby union lines
Sports
11
Leagues
270
  • Football
  • Tennis
  • Basketball
  • American football
  • Baseball
  • Ice hockey
  • Cricket
  • MMA
  • Rugby league
  • Rugby union
  • Aussie rules
Streaming + REST included
  • REST snapshots
  • SSE streams
  • WebSocket streams

Compare the price and the stake.

Keep Matchbook's back and lay prices beside the liquidity available at each level.

Best back and lay

Both sides

Display the best price on each side of a selection, with the available stake attached.

Order-book depth

Price + size

Read the ladder behind the headline price and choose how many levels your comparison displays.

Cross-book comparison

One event ID

Join Matchbook to other bookmaker prices using the same event, market, period, line and selection.

Build a Matchbook liquidity comparison

Pull both price ladders and prepare a comparison that keeps back prices, lay prices and stakes separate.

Authentication
X-API-Key
Exchange
matchbook
GET /v1/events/{event_id}/exchange/orderbook/snapshot?exchanges=matchbook&depth=2
Build a Matchbook price and liquidity comparison using https://api.odds-api.net/v1.

Read ODDS_API_KEY from a server-side environment variable and authenticate with X-API-Key. Find an upcoming NBA fixture at /events?league=NBA&not_started_only=true&limit=50 whose bookmakers list or mapping contains matchbook. Keep its canonical event_id.

Request /events/{event_id}/exchange/orderbook/snapshot?exchanges=matchbook&depth=2. Follow next_cursor with the same filters until there is no next page. For every selection, keep market_key, exchange_market_id, period_str, metric, side and line, plus available_to_back and available_to_lay with each price and size. Preserve currency, source_ts, freshness and the resume token.

Create one row per exact market and selection. Show best back price, back size, best lay price, lay size and currency, with expandable ladders. Keep missing prices empty rather than replacing them with zero.

Let me choose other bookmakers and request their normalized odds for the same event. Join only matching outcomes, periods, metrics and lines. Keep back comparisons and lay comparisons in separate columns. Do not assume an exchange selection_key is shared with a bookmaker selection_key.

Load a complete snapshot before connecting to the matching exchange order-book SSE or WebSocket stream. Reconnect with the latest resume token and reload the snapshot on resync. Export the comparison as JSON and CSV. Handle an empty event list, empty ladders and API errors without inventing prices.

Matchbook markets beyond football

Tennis, basketball, American football and more, with winners, handicaps, totals and team totals in one format.

  • Football match odds

    Home, draw and away prices across 151 football leagues, with each outcome kept separate.

    moneyline 3w
  • Tennis winners

    Player winner prices across 89 tournaments, including ATP, WTA and Challenger competitions.

    moneyline
  • Basketball spreads

    NBA, WNBA and European basketball handicap prices with the signed line attached to each team.

    handicap
  • NFL totals

    Over and under points prices for American football, with the total and period kept together.

    total
  • Baseball run lines

    MLB handicap prices with the team and run line preserved for an exact comparison.

    handicap
  • Ice hockey puck lines

    NHL puck-line prices kept separate from winner markets and goal totals.

    handicap
  • Cricket winners

    Two-way and three-way cricket results, with the draw retained as its own outcome.

    moneylinemoneyline 3w
  • MMA winners

    Fight winner prices with separate fighter selections for your exchange comparison.

    moneyline
  • Rugby union lines

    Handicaps and match totals alongside three-way match odds for rugby union.

    handicaptotal
  • Tennis totals and handicaps

    Over/under and handicap markets with each player, line and period retained.

    totalhandicap
  • Team goal totals

    Football goal totals for one team, matched by team, line and period rather than the match total.

    team total
  • First-half totals

    First-half totals for football, basketball and American football, separate from full-match markets.

    total1st half

Built for agents and humans

MCP server

Tools for events, odds, line movement, streams, and paid-plan positive EV or arbitrage feeds.

Agent skill

Agent-ready instructions.

SDKs and examples

TypeScript, Python, Postman and example builds.

Sports and racing

Sports and racing odds coverage for agent workflows.

SSE odds stream

Lightweight streaming updates for dashboards and alerts.

WebSocket feeds

Price updates for sportsbook and exchange products.

How to pull Matchbook exchange data

Find the fixture once, load both ladders and keep the matching market in view.

  1. 1

    Connect your API key

    Create an odds-api.net key, store it on your server and send it in the X-API-Key header.

  2. 2

    Find the fixture

    Request the event list and choose an event containing matchbook in its bookmakers field. Keep the event_id.

  3. 3

    Read price and liquidity

    Request the exchange order-book snapshot with exchanges=matchbook and your ladder depth. Keep each price with its available size.

  4. 4

    Follow market updates

    Connect to the matching pre-match SSE or WebSocket stream with the snapshot's resume token. Reload the snapshot on resync.

Odds API Pricing

Choose a monthly plan based on request volume, rate limits, and support.

Best for first builds

Starter

50K
$30 USD / month

Odds

Requests
50K / month
Streams
150 stream-hours / month
Stream connections
1 concurrent
  • All Bookmakers
  • All Markets
  • Pre-match odds
  • 60 requests/min

Racing Odds

  • Greyhounds
  • Horse
  • Harness

Bets

  • Positive EV and arbitrage bets
  • Up to 2 bookmakers
Room to grow

Growth

250K
$50 USD / month

Odds

Requests
250K / month
Streams
500 stream-hours / month
Stream connections
3 concurrent
  • All Bookmakers
  • All Markets
  • Pre-match odds
  • 120 requests/min

Racing Odds

  • Greyhounds
  • Horse
  • Harness

Bets

  • Positive EV and arbitrage bets
  • Up to 4 bookmakers
Best value

Builder

2M
$90 USD / month

Odds

Requests
2M / month
Streams
1,500 stream-hours / month
Stream connections
8 concurrent
  • All Bookmakers
  • All Markets
  • Pre-match odds
  • 300 requests/min
Betfair in-play odds included

Racing Odds

  • Greyhounds
  • Horse
  • Harness

Bets

  • Positive EV and arbitrage bets
  • Up to 6 bookmakers

Live

20M
$250 USD / month

Odds

Requests
20M / month
Streams
6,000 stream-hours / month
Stream connections
25 concurrent
  • All Bookmakers
  • All Markets
  • Pre-match odds
  • 600 requests/min
Betfair in-play odds included

Racing Odds

  • Greyhounds
  • Horse
  • Harness

Bets

  • Positive EV and arbitrage bets
  • Up to 15 bookmakers

Pro

75M
$500 USD / month

Odds

Requests
75M / month
Streams
20,000 stream-hours / month
Stream connections
75 concurrent
  • All Bookmakers
  • All Markets
  • Pre-match odds
  • 1,200 requests/min
Betfair in-play odds included

Racing Odds

  • Greyhounds
  • Horse
  • Harness

Bets

  • Positive EV and arbitrage bets
  • Up to 50 bookmakers

Enterprise grade

Custom feeds and models

Custom projects, scoped with your team.

Models and configurations

  • Custom fair-price models
  • Private +EV and arbitrage feeds
  • Separate brand configurations

Delivery and data

  • Managed feed delivery
  • Custom schemas and ID mapping
  • Research datasets and exports
  • Bookmaker and market coverage projects

Racing Odds

  • Greyhounds
  • Horse
  • Harness

Matchbook API FAQs

Matchbook filters, market depth, streaming and comparison data.

What does the Matchbook API include?

odds-api.net provides Matchbook pre-match odds across 11 sports and 270 leagues. Read five market types: two-way winners, three-way match odds, handicaps, totals and team totals. Exchange order books add back and lay ladders with available stakes.

How do I request Matchbook back and lay prices?

Use GET /v1/events/{event_id}/exchange/orderbook/snapshot?exchanges=matchbook&depth=2. Each selection contains available_to_back and available_to_lay arrays, plus best-price and available-size fields.

Which Matchbook tennis markets can I read?

Match winners, handicaps and totals across 89 tennis tournaments. Keep the player selection, market type, line and period together when comparing prices.

Can I compare Matchbook with other bookmakers?

Yes. Use bookmakers=matchbook on the normalized odds snapshot for the same event_id, then request your comparison bookmakers. Match the outcome, market, period, metric and line before comparing prices. Use the separate exchange order book when your comparison also needs back and lay liquidity.

Does Matchbook streaming include REST access?

Yes. REST snapshots, SSE streams and WebSocket streams are included. Load the exchange order-book snapshot first, retain its resume token and use the matching pre-match stream for updates.

Do I use a Matchbook account key?

Use an odds-api.net API key in the X-API-Key header. These endpoints supply odds and exchange market data; Matchbook account balances and bet placement belong to Matchbook's own account API.

Exchange API guides

Connect the other side of your comparison

Keep event and market fields consistent across your exchange integrations.

Explore the exchange API

Add Matchbook to your odds comparison

One key for bookmaker prices, exchange ladders and the liquidity behind each quote.