Create a real-time event subscription
Available for: Concierge API, Enterprise API.
Create a filtered SSE subscription and receive data.subscriptionId and a signed data.streamUrl. Authenticate the creation request with an X-Api-Key header or apiKey in the JSON body, then open the returned URL without adding an API-key header. Empty eventTypes defaults to market_line_update; includeSnapshot requests an initial market-line snapshot when snapshot serving is enabled.
Real-time market data is available through Concierge API and Enterprise API. Free API does not include streaming. NFL model events are available through Enterprise API.
Create the subscription using apiKey in the JSON body, an authenticated X-Api-Key header, or an interactive JWT. Read data.subscriptionId and data.streamUrl from the response. Resolve the relative stream URL against the same API origin and open it as SSE. The signed token expires after 24 hours at most; create a new subscription when it expires. An empty eventTypes array defaults to market_line_update. Store the initial REST snapshot's deep links: market-line update messages do not carry deep links.
Body·
- Type: stringapi
Key write-onlyAPI key for subscription creation. Alternatively use an authenticated X-Api-Key header or interactive JWT. Never put the key in a stream URL.
- Type: array of integerFormat: int64bet
Type Ids Bet type IDs discovered from GET /bettype. Empty selects all matching bet types.
- Type: array of integerFormat: int64event
Ids Positive event IDs discovered from the events or odds response. Filters market_line_update messages and market-line snapshots only; event_update and model messages are not narrowed by this field. Empty selects all matching market lines within your data scope.
- Type: array of stringevent
Types Event names to subscribe to. Empty or omitted defaults to market_line_update. in_game_fair_price_update is available through Enterprise API. Results stay within your API tier and data scope.
- Type: booleaninclude
Snapshot When true and snapshot serving is enabled, sends market_line_snapshot chunks before live updates. Defaults to false.
- Type: array of integerFormat: int32league
Ids League IDs discovered from GET /league. Concierge subscriptions are limited to NFL, NBA, MLB, NHL, and WNBA. Empty selects the leagues included in your API tier and data scope.
- Type: array of integerFormat: int64market
Source Ids Sportsbook IDs discovered from GET /market/{league}/{marketType}/sources. Empty selects the sportsbooks included in your data scope.
- Type: array of integerFormat: int32market
Type Ids Market type IDs discovered from GET /market-type. Empty selects all matching market types within your data scope.
Responses
- application/json
- application/json
- application/json
- application/json
- 404
Real-time subscription creation is unavailable.
- application/json
curl https://data.unabated.com/subscriptions \
--request POST \
--header 'Content-Type: application/json' \
--data '{
"apiKey": "YOUR_API_KEY",
"eventTypes": [
"market_line_update"
],
"includeSnapshot": true
}'
{
"data": {
"subscriptionId": "string",
"streamUrl": "string"
},
"success": true,
"messages": [
"string"
],
"pagination": {
"nextCursor": null,
"previousCursor": null
}
}