Odds337Docs
    Odds337BackGet API key
    Getting started
    • Introduction
    • Authentication
    • Quickstart
    • Tokens & pricing
    • Limits
    • Errors
    • Odds formats
    Reference
    • GET/sports
    • GET/books
    • GET/teams
    • GET/players
    • Logos & headshots
    • GET/events
    • GET/odds
    • GET/scores
    • GET/history
    • GET/clv
    • POST /clv
    • GET/usage
    • GET/_health
    • WebSocket
    • Specs & SDKs
    Racing
    • GET/racing/meetings
    • GET/racing/race
    • GET/racing/history
    • race_id and status
    Concepts
    • event_id
    • selection_key
    • team_id & player_id
    • Open & close prices
    • 337 model price
    • Event links
    • Statuses
    Getting started
    • Introduction
    • Authentication
    • Quickstart
    • Tokens & pricing
    • Limits
    • Errors
    • Odds formats
    Reference
    • GET/sports
    • GET/books
    • GET/teams
    • GET/players
    • Logos & headshots
    • GET/events
    • GET/odds
    • GET/scores
    • GET/history
    • GET/clv
    • POST /clv
    • GET/usage
    • GET/_health
    • WebSocket
    • Specs & SDKs
    Racing
    • GET/racing/meetings
    • GET/racing/race
    • GET/racing/history
    • race_id and status
    Concepts
    • event_id
    • selection_key
    • team_id & player_id
    • Open & close prices
    • 337 model price
    • Event links
    • Statuses

    API reference

    List books

    The bookmakers and exchanges the API carries.

    GET/odds/v1/books
    Cost
    0 tokens
    Authentication
    X-API-Key, demo key works

    Parameters

    This endpoint takes no parameters.

    Request

    curl -s "https://api.b337.ai/odds/v1/books" \
      -H "X-API-Key: demo"
    import requests
    
    resp = requests.get(
        "https://api.b337.ai/odds/v1/books",
        headers={"X-API-Key": "demo"},
        timeout=10,
    )
    resp.raise_for_status()
    print(resp.json())
    // Node 18+, saved as an .mjs file
    const res = await fetch("https://api.b337.ai/odds/v1/books", {
      headers: { "X-API-Key": "demo" },
    });
    console.log(await res.json());

    Response

    200 OK
    {
      "data": [{"book": "bet365"}, {"book": "betfair"}, {"book": "sportsbet"}, {"book": "tab"}],
      "count": 31
    }

    Fields

    book is the key used everywhere else: in an event's books list, as the key of prices, and in the books= filter on /odds and the WebSocket.

    PreviousGET /sportsNextGET /teams

    On this page

    • Parameters
    • Request
    • Response
    • Fields