odds

Cross-provider odds divergences (two-source verification)

Per (match, market, canonical book) disagreements between our two odds providers, as detected by the divergence worker. Categories: PRICE_DIFF (same line, juice differs > threshold), LINE_DIFF (different line value), MISSING_FROM_ONE (a book one provider doesn't carry), STALE (one feed lagging). Requires an Edge plan or higher (Free / Solo / Trio receive 403). Provide match_id, or else date_from + date_to to bound the kickoff window. Response: { data: [{ match_id, sport_type, league, kickoff_utc, market, canonical_id, book_display_name, category, secondary_categories, magnitude, detected_at }], meta: { total, limit, offset, categories_present, generated_at } }. magnitude is category-specific (price_diff_pct for PRICE_DIFF, line_diff for LINE_DIFF, else null) and is an ABSOLUTE difference; it carries no direction and cannot be used to reconstruct either provider's line. The per-provider line and price values are deliberately not returned: the product here is the computed disagreement, not the upstream feeds. Returns 503 while the divergence worker is still provisioning (its table not yet created).

get/v1/odds/divergences

Request

  • Base URL: https://api.bigballsdata.com
  • URL: https://api.bigballsdata.com/v1/odds/divergences
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Query parameters

match_idstring uuid

Filter to one match. If omitted, date_from + date_to are required.

sport'football' | 'basketball' | 'baseball' | 'ice_hockey' | 'cricket' | 'mma' | 'boxing' | 'formula1' | 'american_football'

Canonical sport slug, e.g. football or basketball. Common aliases are accepted and normalized (soccer to football).

category'PRICE_DIFF' | 'LINE_DIFF' | 'MISSING_FROM_ONE' | 'STALE'

Filter to one divergence category.

canonical_idstring

Filter to one canonical book, e.g. betmgm, draftkings.

date_fromstring date

Inclusive kickoff lower bound (required if no match_id).

date_tostring date

Inclusive kickoff upper bound (required if no match_id).

limitinteger
offsetinteger

Response

ok

object required

Changes

No recorded changes to this operation across all 3 revisions of this API.