Events and filters

Available for: Concierge API · Enterprise API

Specify the event families your application actually consumes. Omitted or empty eventTypes currently defaults to market_line_update only; it does not subscribe you to every event family.

Subscription request

{
  "eventTypes": ["market_line_update", "event_update"],
  "leagueIds": [5],
  "eventIds": [],
  "marketTypeIds": [1],
  "marketSourceIds": [7],
  "betTypeIds": [1, 2, 3],
  "includeSnapshot": false
}

These are sample IDs, not a current list of available leagues or books. Use GET /league, GET /market-type, GET /bettype, GET /event/{league}/upcoming, and GET /market/{league}/{marketType}/sources to discover the data you need.

Omitted or empty dimension arrays request no additional client filter within your API tier's data coverage. The server can narrow requested filters to that coverage. An empty resulting set is not an all-data wildcard.

Unknown league, market type, market source, or bet type values can return 400. A valid subscription can also receive no messages when no available data matches. Check your API tier after a 403; widening filters or repeating requests does not change the tier's coverage.

Event names and JSON roots

Data event payloads use a data envelope with a camel-case root. Snapshot completion and gap notices use the smaller control shapes shown below.

The control event names cannot be used as ordinary subscription event types. Request includeSnapshot to ask for snapshots; listen for gap on every connection. Do not infer commercial feature availability just because an event name exists in the protocol.

Filter applicability

Your API tier's data coverage applies even to event families without a user-specified filter dimension. A metadata notification does not expand that coverage.

Market-line updates

One frame can contain multiple lines:

{
  "data": {
    "marketLineUpdate": {
      "marketSourceGroup": "STANDARD",
      "leagueId": 5,
      "marketTypeId": 1,
      "correlationId": null,
      "messageId": "33a224985bed44849a4641ba9fdba59b0",
      "marketLines": [
        {
          "marketId": 308238780,
          "marketLineId": 17971985415,
          "marketSourceId": 7,
          "points": null,
          "price": 135,
          "sourcePrice": 135.0,
          "sourceFormat": 1,
          "liquidity": null,
          "statusId": 1,
          "disabled": false,
          "sequenceNumber": 1788207551574,
          "freshnessExpiresAt": null,
          "modifiedOn": "2026-10-01T15:00:00Z",
          "bestAltPrice": null,
          "bestAltPoints": null,
          "alternateLines": [],
          "marketLineKey": "illustrative.path.to.a.line",
          "market": {
            "eventId": 110845,
            "marketTypeId": 1,
            "betTypeId": 1,
            "teamId": 56,
            "sideIndex": 0,
            "periodTypeId": 20,
            "personId": null,
            "live": false,
            "modifiedOn": "2026-10-01T15:00:00Z"
          }
        }
      ]
    }
  }
}

This is illustrative sample output. Fields depend on the line and your API tier's datasets; additional fields may appear.

• Identify a source line by marketLineId. Use marketSourceId and market metadata to associate it with the correct book and selection.
• Use marketLineKey as a location hint into the REST hierarchy; do not parse its segments to derive league, book, or betting semantics.
• Reject stale line updates using sequenceNumber and/or modifiedOn. Neither the SSE frame id nor messageId is a numeric ordering value.
• Apply disabled, statusId, freshnessExpiresAt, liquidity, and alternate-line changes even when price and points remain unchanged.
• A streaming null can explicitly clear a field. Do not drop all null-valued fields while merging.
• Preserve unrelated REST-only metadata. Retain a deepLink for price or status changes only when the selection's points remain unchanged. If points change, invalidate and refetch its link; apply this rule to each alternate too. The stream does not resend deep links with updates.

Market-line status is a protocol enum: 1 Available, 2 Unavailable, 3 PriceUnknown. disabled: true also means the line should not be offered as an available wager. freshnessExpiresAt, when present, is a UTC freshness boundary for the line; stop presenting an expired quote as current. This is separate from NFL model state transitions.

Alternate lines and liquidity

An update may carry alternate or milestone values while the top-level points and price are null. Inspect alternateLines before deciding that no actionable values exist.

{
  "marketLineId": 17971985469,
  "marketSourceId": 7,
  "points": null,
  "price": null,
  "alternateLines": [
    {
      "marketLineId": 17971985470,
      "marketSourceId": 7,
      "points": -1.0,
      "price": 119,
      "sourcePrice": 119.0,
      "sourceFormat": 1,
      "liquidity": 5000.0,
      "alternateNumber": 1,
      "statusId": 1,
      "disabled": false,
      "sequenceNumber": 1788207551574,
      "freshnessExpiresAt": null,
      "modifiedOn": "2026-10-01T15:00:00Z"
    }
  ]
}

Match alternates by marketLineId, retain their own ordering fields, and process liquidity independently of prices. Do not assume the outer line is always the line currently displayed to your users.

Event and metadata updates

{
  "data": {
    "eventUpdate": {
      "leagueId": 5,
      "change": "updated",
      "event": {
        "eventId": 110845,
        "leagueId": 5,
        "statusId": 2,
        "statusName": "Live",
        "eventStart": "2026-10-01T14:00:00Z",
        "gameClock": "05:32",
        "eventTeams": [
          {"teamId": 56, "score": 3, "sideIndex": 0},
          {"teamId": 34, "score": 4, "sideIndex": 1}
        ],
        "modifiedOn": "2026-10-01T15:00:00Z"
      },
      "correlationId": null,
      "messageId": "33a224985bed44849a4641ba9fdba59b0"
    }
  }
}

Next: Connect with a complete sample or handle snapshots and reconnects.