Skip to main content
GET
/
guest
/
odds
/
stream
Get a real-time Server-Sent Events stream of free odds
curl --request GET \
  --url https://api.example.com/guest/odds/stream
{
  "FixtureId": {},
  "MessageId": "<string>",
  "Ts": {},
  "Bookmaker": "<string>",
  "BookmakerId": {},
  "SuperOddsType": "<string>",
  "InRunning": true,
  "PriceNames": [
    "<string>"
  ],
  "Prices": [
    {}
  ]
}

Documentation Index

Fetch the complete documentation index at: https://txline-docs.txodds.com/llms.txt

Use this file to discover all available pages before exploring further.

A long-lived, public stream of odds updates delayed by 60 seconds for freely available competitions. The stream consists of data messages with:
  • An id in the format timestamp:index.
  • data containing a JSON object for a single Odds record.
This endpoint is intended for guest users and only includes odds from competitions marked as free by the system.

​
Query Parameters

​
fixtureId
int64
Optional. Filter the event stream for a single fixture ID.

​
Headers

​
Last-Event-ID
string
Optional. The ID of the last event received, in ‘timestamp:index’ format. If provided, the server will attempt to send historical data since this event before joining the live stream.

​
Response

Returns a Server-Sent Events (SSE) stream with content type text/event-stream. Each event contains:
  • id: Event identifier in format timestamp:index
  • data: JSON object containing an Odds record

​
Odds Object Structure

​
FixtureId
int64
required
Fixture identifier
​
MessageId
string
required
Unique message identifier for the odds update
​
Ts
int64
required
Timestamp of the odds update
​
Bookmaker
string
required
Bookmaker name
​
BookmakerId
int32
required
Bookmaker identifier
​
SuperOddsType
string
required
Type of odds market
​
InRunning
boolean
required
Indicates if the fixture is currently in play
​
PriceNames
array<string>
Names of the prices/outcomes
​
Prices
array<int32>
Odds values for each outcome
id: 1704067200000:0
data: {"FixtureId":1001,"MessageId":"msg_12345","Ts":1704067200000,"Bookmaker":"BetMGM","BookmakerId":5,"SuperOddsType":"Moneyline","InRunning":false,"PriceNames":["Alabama","Georgia"],"Prices":[150,200]}