Price Check — POST /v3/price_check

Racing

Fetch live odds for every runner in a race, fanned out across multiple bookie sessions in parallel. Same async contract as /v3/place_bet — returns 202 Accepted in ~100 ms with one correlation_id per queried session. Each session resolves independently as its bookie responds, so you start streaming results immediately instead of waiting on the slowest bookie.

Auth

X-API-Key: <your-api-key>
Content-Type: application/json

Request — all runners in a race

curl -X POST https://api.b337.ai/v3/price_check \
  -H "X-API-Key: <your-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "session_ids": ["11142", "14389"],
    "category": "racing",
    "track": "Flemington",
    "race_num": 4,
    "race_type": "(R)",
    "date": "2026-05-25"
  }'

Request — single runner (faster, smaller response)

{
  "session_ids": ["11142", "14389"],
  "category": "racing",
  "track": "Flemington",
  "race_num": 4,
  "race_type": "(R)",
  "date": "2026-05-25",
  "runner": "Verry Elleegant"
}

Response (202)

{
  "status": "pending",
  "category": "racing",
  "race": {
    "track": "Flemington",
    "race_num": 4,
    "race_type": "(R)",
    "date": "2026-05-25"
  },
  "queries": [
    { "session_id": "11142", "correlation_id": "a1b2…" },
    { "session_id": "14389", "correlation_id": "c3d4…" }
  ]
}

Poll each correlation_id via POST /api/bet_status until status flips from pending to success/failure (or supply callback_url to receive results via webhook). Sample resolved payload:

{
  "status": "success",
  "category": "racing",
  "session_id": "11142",
  "bookie": "tab",
  "selections": [
    {
      "runner": "Verry Elleegant",
      "prices": [
        { "market": "win",   "price": 4.20 },
        { "market": "place", "price": 1.65 }
      ]
    }
  ]
}

Field reference — Racing

Common errors