{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/0xinsider-com/json-schema/0xinsider-com-game-schema.json",
  "title": "Game",
  "description": "One sports or esports game: both sides, its schedule, provider status, linked Polymarket markets and their available provider moneyline price states. Assembled from the same provider-first live and upcoming projections the site's boards use, with no request-time provider fan-out.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/0xinsider-com-games-api-openapi.yml#/components/schemas/Game",
  "type": "object",
  "required": [
    "object",
    "event_slug",
    "status",
    "competitors",
    "draw_offered",
    "markets",
    "freshness",
    "coverage",
    "url"
  ],
  "properties": {
    "object": {
      "type": "string",
      "const": "game"
    },
    "event_slug": {
      "type": "string",
      "description": "The game's identity, for example mlb-mil-cin-2026-06-22. The same key the live_sports_updated webhook pulse carries and the same key /api/v1/games/{event_slug} takes."
    },
    "game_id": {
      "type": "string",
      "description": "The provider's Gamma gameId, as a string. Omitted when the canonical owner has no single value for this slug: the provider stamps one gameId across an event's derivative siblings, so an ambiguous read is reported as unknown rather than guessed."
    },
    "sport": {
      "type": "string",
      "description": "The canonical sport bucket, for example Soccer or Table Tennis. Omitted when neither the board scope nor the provider category names one."
    },
    "league": {
      "type": "string",
      "description": "The league tag, for example nfl or epl. Omitted for a sport served as one whole bucket with no league scope."
    },
    "title": {
      "type": "string",
      "description": "The provider's event title. Omitted when the provider sent none."
    },
    "scheduled_at": {
      "type": "string",
      "format": "date-time",
      "description": "Kickoff in UTC, as the provider supplied it. Omitted when the provider published none; coverage.schedule then reads unavailable."
    },
    "status": {
      "$ref": "#/$defs/GameStatus"
    },
    "competitors": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/GameCompetitor"
      },
      "description": "Both sides, in the provider's own order. For a team league the provider lists the home side first. Empty when the provider identified neither side."
    },
    "series_format": {
      "type": "string",
      "description": "The esports series length, for example Bo3. Omitted for everything else."
    },
    "draw_offered": {
      "type": "boolean",
      "description": "Whether this read includes a market classified as paying on a draw, including soccer's independent 1X2 draw leg. Read this instead of assuming a two-outcome moneyline."
    },
    "markets": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/GameMarket"
      },
      "description": "Every market this read linked to the game, ordered by condition_id."
    },
    "freshness": {
      "$ref": "#/$defs/GameFreshness"
    },
    "coverage": {
      "$ref": "#/$defs/GameCoverage"
    },
    "url": {
      "type": "string",
      "description": "The game's page on 0xinsider."
    }
  },
  "$defs": {
    "GameCompetitor": {
      "type": "object",
      "description": "One side of the game.",
      "required": [
        "name"
      ],
      "properties": {
        "name": {
          "type": "string",
          "description": "The competitor's name as the provider gives it."
        },
        "provider_id": {
          "type": "string",
          "description": "The provider's league-scoped competitor id, as a string. Omitted when the provider has not identified this side; coverage.competitors then reads labels."
        },
        "logo": {
          "type": "string",
          "description": "Provider crest or logo URL. Omitted when there is none."
        },
        "score": {
          "type": "string",
          "description": "The provider's score for this side, verbatim. A string because the provider sends one: a set score, a map score and a run total are not all integers. Omitted when no live-score frame carries a score."
        },
        "record": {
          "type": "string",
          "description": "The provider's season record for this side, for example 12-4. Omitted when the provider sent none."
        }
      }
    },
    "GameCoverage": {
      "type": "object",
      "description": "What this game's read actually supplied, so a client branches on coverage instead of on a missing key.",
      "required": [
        "scores",
        "competitors",
        "schedule"
      ],
      "properties": {
        "scores": {
          "type": "string",
          "enum": [
            "available",
            "unavailable"
          ],
          "description": "available when a live-score frame supplied this game's scores."
        },
        "competitors": {
          "type": "string",
          "enum": [
            "provider_ids",
            "labels",
            "unavailable"
          ],
          "description": "provider_ids when every side carries a provider id, labels when only the provider's names identify them, unavailable when neither exists. Do not join on names when this reads labels."
        },
        "schedule": {
          "type": "string",
          "enum": [
            "available",
            "unavailable"
          ],
          "description": "available when the provider supplied a kickoff."
        }
      }
    },
    "GameFreshness": {
      "type": "object",
      "description": "How current this game's facts are. Independent per source: the board half that produced the game, and the live-score frame that produced its scores.",
      "required": [
        "source",
        "source_status",
        "source_availability",
        "source_freshness",
        "delayed"
      ],
      "properties": {
        "source": {
          "type": "string",
          "enum": [
            "live",
            "upcoming"
          ],
          "description": "Which board half produced this game."
        },
        "source_status": {
          "type": "string",
          "enum": [
            "ok",
            "unavailable"
          ],
          "description": "Whether that half returned a truthful source body for this read."
        },
        "source_availability": {
          "type": "string",
          "enum": [
            "available",
            "unavailable",
            "not_applicable"
          ],
          "description": "Whether that half had a source body at all. not_applicable means the sport has no configured source for that half."
        },
        "source_freshness": {
          "type": "string",
          "enum": [
            "fresh",
            "stale",
            "unknown",
            "not_applicable"
          ],
          "description": "Freshness of the cached source body, never inferred from the response clock or the row count."
        },
        "source_observed_at": {
          "type": "string",
          "format": "date-time",
          "description": "The source body's data vintage. Omitted when the read has no vintage anchor, which is not age zero."
        },
        "source_age_seconds": {
          "type": "integer",
          "description": "Age of source_observed_at in seconds, capped at 600. Omitted past the cap or with no anchor."
        },
        "delayed": {
          "type": "boolean",
          "description": "Whether a reader should be told these rows are behind. This applies the half's own servable-age bar (15 s live, 120 s upcoming), which is not the same as source_freshness: a live board whose scores are seconds old reads stale for about half of every publish cycle and is not delayed."
        },
        "scores_observed_at": {
          "type": "string",
          "format": "date-time",
          "description": "When this game's live-score frame was observed. Omitted when there is no frame."
        },
        "scores_source_at": {
          "type": "string",
          "format": "date-time",
          "description": "The provider's own frame clock. Omitted when the frame carries none."
        }
      }
    },
    "GameMarket": {
      "type": "object",
      "description": "One Polymarket market linked to this game.",
      "required": [
        "id",
        "condition_id",
        "platform"
      ],
      "properties": {
        "id": {
          "type": "string",
          "description": "The mkt_-prefixed market id every other V1 response uses."
        },
        "condition_id": {
          "type": "string",
          "description": "The raw provider condition id."
        },
        "platform": {
          "type": "string",
          "enum": [
            "polymarket"
          ],
          "description": "Always polymarket."
        },
        "slug": {
          "type": "string",
          "description": "The provider's market slug. Omitted when the provider sent none."
        },
        "sports_market_type": {
          "type": "string",
          "description": "The provider's own market type, for example moneyline or spread. Omitted when the provider sent none. Not an enum: the provider owns this vocabulary and adds to it."
        },
        "side": {
          "type": "string",
          "enum": [
            "home",
            "away",
            "draw",
            "other"
          ],
          "description": "Which side of the game this market's YES leg pays. Soccer 1X2 legs are explicitly classified as home, draw or away by the provider projection. draw is a real value, not a competitor. Omitted when the provider projection cannot classify the leg, which is not the same as other."
        },
        "outcome_yes": {
          "type": "string",
          "description": "The provider's label for the YES outcome. Omitted when the provider sent none."
        },
        "outcome_no": {
          "type": "string",
          "description": "The provider's label for the NO outcome. Omitted when the provider sent none."
        },
        "outcome_token_ids": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Polymarket CLOB token ids in the provider's own outcome-index order. Omitted when the provider has published none for this market."
        },
        "prices": {
          "$ref": "#/$defs/GameMarketPrices",
          "description": "Default provider moneyline state. Omitted when this market has no classified moneyline projection; incomplete and invalid projections remain explicit."
        }
      }
    },
    "GameMarketPriceBindingProvenance": {
      "type": "string",
      "enum": [
        "provider_ids",
        "exact_labels",
        "containment_labels",
        "elimination"
      ],
      "description": "How the existing sports-board writer bound prices to competitors."
    },
    "GameMarketPriceCompetitor": {
      "type": "object",
      "description": "One competitor-bound provider moneyline price. No YES/NO inference is required.",
      "required": [
        "label",
        "price",
        "price_provenance"
      ],
      "properties": {
        "provider_id": {
          "type": "integer",
          "format": "int64",
          "description": "The provider competitor id when identity is available."
        },
        "label": {
          "type": "string",
          "description": "The provider competitor label."
        },
        "price": {
          "type": "number",
          "minimum": 0,
          "maximum": 1,
          "description": "Unrounded provider price in [0, 1]."
        },
        "price_provenance": {
          "type": "string",
          "enum": [
            "gamma_outcome_prices",
            "clob_display"
          ],
          "description": "Which provider price observation supplies this leg."
        }
      }
    },
    "GameMarketPriceIncomplete": {
      "type": "object",
      "description": "The provider moneyline pair is incomplete; no numeric pair is invented.",
      "required": [
        "state",
        "reason"
      ],
      "properties": {
        "state": {
          "type": "string",
          "const": "incomplete"
        },
        "reason": {
          "type": "string",
          "enum": [
            "outcome_prices_missing",
            "outcome_price_leg_missing",
            "zero_price_sentinel",
            "display_price_pair_unavailable",
            "outcome_identity_unavailable",
            "final_score_unavailable"
          ]
        },
        "competitor_a_is_yes": {
          "type": "boolean",
          "description": "Whether competitor A is the provider YES leg."
        },
        "competitor_a_provider_id": {
          "type": "integer",
          "format": "int64",
          "description": "The provider competitor id when identity is available."
        },
        "competitor_b_provider_id": {
          "type": "integer",
          "format": "int64",
          "description": "The provider competitor id when identity is available."
        },
        "binding_provenance": {
          "$ref": "#/$defs/GameMarketPriceBindingProvenance"
        }
      }
    },
    "GameMarketPriceInvalid": {
      "type": "object",
      "description": "The provider moneyline pair is invalid; no numeric pair is invented.",
      "required": [
        "state",
        "reason"
      ],
      "properties": {
        "state": {
          "type": "string",
          "const": "invalid"
        },
        "reason": {
          "type": "string",
          "enum": [
            "team_cardinality",
            "outcome_cardinality",
            "price_cardinality",
            "non_finite_price",
            "out_of_range_price",
            "non_complementary_prices",
            "ambiguous_identity",
            "final_identity_mismatch"
          ]
        },
        "competitor_a_is_yes": {
          "type": "boolean",
          "description": "Whether competitor A is the provider YES leg."
        },
        "competitor_a_provider_id": {
          "type": "integer",
          "format": "int64",
          "description": "The provider competitor id when identity is available."
        },
        "competitor_b_provider_id": {
          "type": "integer",
          "format": "int64",
          "description": "The provider competitor id when identity is available."
        },
        "binding_provenance": {
          "$ref": "#/$defs/GameMarketPriceBindingProvenance"
        }
      }
    },
    "GameMarketPricePaired": {
      "type": "object",
      "description": "A validated provider moneyline pair bound to the two competitors.",
      "required": [
        "state",
        "competitor_a",
        "competitor_b",
        "competitor_a_is_yes",
        "binding_provenance"
      ],
      "properties": {
        "state": {
          "type": "string",
          "const": "paired"
        },
        "competitor_a": {
          "$ref": "#/$defs/GameMarketPriceCompetitor"
        },
        "competitor_b": {
          "$ref": "#/$defs/GameMarketPriceCompetitor"
        },
        "competitor_a_is_yes": {
          "type": "boolean",
          "description": "Whether competitor A is the provider YES leg."
        },
        "binding_provenance": {
          "$ref": "#/$defs/GameMarketPriceBindingProvenance"
        }
      }
    },
    "GameMarketPrices": {
      "type": "object",
      "description": "Provider-owned moneyline state with the observation clock that can be compared with game freshness.",
      "required": [
        "provider",
        "observed_at",
        "observation_source"
      ],
      "properties": {
        "provider": {
          "$ref": "#/$defs/GameMarketProviderPrices"
        },
        "observed_at": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time",
          "description": "Board cache vintage for Gamma or the older CLOB leg clock. Null when no reliable clock is available; never a Gamma-authored timestamp."
        },
        "observation_source": {
          "type": "string",
          "enum": [
            "board_snapshot",
            "clob_display"
          ],
          "description": "The clock used for observed_at. board_snapshot is this service’s cache observation, not a provider source timestamp."
        }
      }
    },
    "GameMarketProviderPrices": {
      "oneOf": [
        {
          "$ref": "#/$defs/GameMarketPricePaired"
        },
        {
          "$ref": "#/$defs/GameMarketPriceIncomplete"
        },
        {
          "$ref": "#/$defs/GameMarketPriceInvalid"
        }
      ]
    },
    "GameStatus": {
      "type": "object",
      "description": "Where the game is in its own life, as the provider reports it. A postponement, a cancellation and a suspension each keep their own state, so a client can tell a game that will be played later from one that never will be.",
      "required": [
        "state",
        "ended"
      ],
      "properties": {
        "state": {
          "type": "string",
          "enum": [
            "scheduled",
            "live",
            "paused",
            "ended",
            "postponed",
            "cancelled",
            "suspended",
            "delayed",
            "unknown"
          ],
          "description": "scheduled: kickoff is ahead or the provider still calls it scheduled. live: the provider reports it in play. paused: halftime or a provider-reported break. ended: the provider reported a final, an award or a forfeit. postponed, cancelled, suspended, delayed: the provider's own verdict, kept distinct. A tennis match that the provider still lists in play, with no live score feed and no change of period or score for 3 hours, also reads suspended. unknown: no provider state reached this read. A kickoff in the past is never read as live on its own."
        },
        "match_status": {
          "type": "string",
          "enum": [
            "scheduled",
            "in_progress",
            "halftime",
            "penalty_shootout",
            "delayed",
            "suspended",
            "final",
            "final_overtime",
            "final_shootout",
            "awarded",
            "forfeit",
            "not_necessary",
            "postponed",
            "cancelled",
            "unknown"
          ],
          "description": "The provider status folded onto one vocabulary across leagues. unknown means the provider sent a value this API has no meaning for; provider_status keeps that value verbatim. Omitted when no live-score frame carries a status."
        },
        "provider_status": {
          "type": "string",
          "description": "The provider's status string, verbatim. Omitted when the provider sent none."
        },
        "period": {
          "type": "string",
          "description": "The provider's period label, for example Q3, End Q2 or T5. Omitted when the provider sent none."
        },
        "clock": {
          "type": "string",
          "description": "The game clock as the provider spells it, never reformatted. Omitted when the provider sent none."
        },
        "live": {
          "type": "boolean",
          "description": "Whether the game is in play. It is the provider's own in-play flag, except that three cases read false: a game the provider reports suspended (period SUS), a game rescheduled to a later kickoff, and a tennis match that the provider still lists in play with no live score feed and no change of period or score for 3 hours. Omitted when no live-score frame exists, which is not the same as false."
        },
        "ended": {
          "type": "boolean",
          "description": "Whether the game is over. Always present."
        }
      }
    }
  }
}