Feed API

Getting sport events and their snapshots

Feed API endpoints can be used to get events schedule and particular event snapshot from Odds88.

Schedule Endpoints

Regular Events Schedule

The endpoint can be used to fetch events based on sports, locations and start date.

It returns the list of events with their details, but without markets.

The endpoint is rate-limited to 10 requests per second.

Gets list of non-outright event with specified UTC start date.

post

Authorizations

HTTPRequired

JWT Authorization header using the Bearer scheme. Example: "Authorization: Bearer {token}"

Body

Responses

200

Information about event (sport, country, statuses etc.)

idinteger · int64Optional

TradeArt event id.

namestring · nullableOptional

Event name.

statusall ofOptional

Event status representing current status of the match.

0 = Unknown (Event status is unknown)

1 = Planned (Event is planned)

2 = SoonInPlay (Event is almost started)

3 = Live (Event is in play)

4 = Completed (Event finished)

5 = Cancelled (Event is cancelled)

6 = CoverageLost (Lost updates from provider)

7 = Closed (Event closed end will not be reopened)

8 = Suspended (Event suspended and might be re opened)

9 = Postponed (Event postponed)

10 = Abandoned (Event abandoned)

Possible values:

integer · enumOptional

Status of event

0 = Unknown (Event status is unknown)

1 = Planned (Event is planned)

2 = SoonInPlay (Event is almost started)

3 = Live (Event is in play)

4 = Completed (Event finished)

5 = Cancelled (Event is cancelled)

6 = CoverageLost (Lost updates from provider)

7 = Closed (Event closed end will not be reopened)

8 = Suspended (Event suspended and might be re opened)

9 = Postponed (Event postponed)

10 = Abandoned (Event abandoned)

Possible values:

tradingStatusall ofOptional

Status of trading for the event showing how it should be processed.

0 = Open (Trading is active)

1 = Suspended (Trading is suspended)

2 = Closed (Trading is stopped)

3 = Inactive (Trading is not configured)

Possible values:

integer · enumOptional

Status of trading

0 = Open (Trading is active)

1 = Suspended (Trading is suspended)

2 = Closed (Trading is stopped)

3 = Inactive (Trading is not configured)

Possible values:

statusDescriptionstring · nullableOptional

Free text event status description (optional).

startTimestring · date-time · nullableOptional

Start time of the event. Can be null.

isOutrightbooleanOptional

Flag which indicates that event is outright.

isBetBuilderSupportedbooleanOptional

Indicates whether this selection can be used in Bet Builder

400

Bad Request

401

Unauthorized

403

Forbidden

429

Too many requests

500

Internal Server Error

post

/api/events/schedule/v2

POST /api/events/schedule/v2 HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 53

{
  "startDate": "text",
  "sportIds": [
    1
  ],
  "locationIds": [
    1
  ]
}

[
  {
    "id": 1,
    "name": "text",
    "status": 0,
    "tradingStatus": 0,
    "statusDescription": "text",
    "country": {
      "id": 1,
      "name": "text"
    },
    "sport": {
      "id": 1,
      "name": "text"
    },
    "competition": {
      "id": 1,
      "name": "text"
    },
    "season": {
      "id": 1,
      "name": "text"
    },
    "competitors": [
      {
        "id": 1,
        "name": "text"
      }
    ],
    "startTime": "2026-03-12T03:39:51.236Z",
    "isOutright": true,
    "customDisplayData": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "isBetBuilderSupported": true,
    "mappingInfo": [
      {
        "feedId": 1,
        "id": "text"
      }
    ]
  }
]

Outrights Endpoint

Can be used to fetch outright events based on sports and locations.

It returns the list of events with their details, but without markets.

The endpoint is rate-limited to 10 requests per second.

Fetch Outright Events

post

Authorizations

HTTPRequired

JWT Authorization header using the Bearer scheme. Example: "Authorization: Bearer {token}"

Body

Responses

200

Information about event (sport, country, statuses etc.)

idinteger · int64Optional

TradeArt event id.

namestring · nullableOptional

Event name.

statusall ofOptional

Event status representing current status of the match.

0 = Unknown (Event status is unknown)

1 = Planned (Event is planned)

2 = SoonInPlay (Event is almost started)

3 = Live (Event is in play)

4 = Completed (Event finished)

5 = Cancelled (Event is cancelled)

6 = CoverageLost (Lost updates from provider)

7 = Closed (Event closed end will not be reopened)

8 = Suspended (Event suspended and might be re opened)

9 = Postponed (Event postponed)

10 = Abandoned (Event abandoned)

Possible values:

integer · enumOptional

Status of event

0 = Unknown (Event status is unknown)

1 = Planned (Event is planned)

2 = SoonInPlay (Event is almost started)

3 = Live (Event is in play)

4 = Completed (Event finished)

5 = Cancelled (Event is cancelled)

6 = CoverageLost (Lost updates from provider)

7 = Closed (Event closed end will not be reopened)

8 = Suspended (Event suspended and might be re opened)

9 = Postponed (Event postponed)

10 = Abandoned (Event abandoned)

Possible values:

tradingStatusall ofOptional

Status of trading for the event showing how it should be processed.

0 = Open (Trading is active)

1 = Suspended (Trading is suspended)

2 = Closed (Trading is stopped)

3 = Inactive (Trading is not configured)

Possible values:

integer · enumOptional

Status of trading

0 = Open (Trading is active)

1 = Suspended (Trading is suspended)

2 = Closed (Trading is stopped)

3 = Inactive (Trading is not configured)

Possible values:

statusDescriptionstring · nullableOptional

Free text event status description (optional).

startTimestring · date-time · nullableOptional

Start time of the event. Can be null.

isOutrightbooleanOptional

Flag which indicates that event is outright.

isBetBuilderSupportedbooleanOptional

Indicates whether this selection can be used in Bet Builder

400

Bad Request

401

Unauthorized

403

Forbidden

429

Too many requests

500

Internal Server Error

post

/api/events/outrights

POST /api/events/outrights HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 34

{
  "sportIds": [
    1
  ],
  "locationIds": [
    1
  ]
}

[
  {
    "id": 1,
    "name": "text",
    "status": 0,
    "tradingStatus": 0,
    "statusDescription": "text",
    "country": {
      "id": 1,
      "name": "text"
    },
    "sport": {
      "id": 1,
      "name": "text"
    },
    "competition": {
      "id": 1,
      "name": "text"
    },
    "season": {
      "id": 1,
      "name": "text"
    },
    "competitors": [
      {
        "id": 1,
        "name": "text"
      }
    ],
    "startTime": "2026-03-12T03:39:51.236Z",
    "isOutright": true,
    "customDisplayData": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "isBetBuilderSupported": true,
    "mappingInfo": [
      {
        "feedId": 1,
        "id": "text"
      }
    ]
  }
]

Event snapshot endpoint

Can be used to fetch the latest snapshot of a specified event or outright fixture with all markets.

This endpoint can be used to recover events in case a message or messages were missed.

This endpoint is rate-limited to 10 requests per second.

Get snapshot of the specific event.

get

Authorizations

HTTPRequired

JWT Authorization header using the Bearer scheme. Example: "Authorization: Bearer {token}"

Path parameters

eventIdinteger · int64Required

TradeArt event id.

Responses

200

Full snapshot of event data

typeall ofOptional

Type of delta

0 = None (Delta type is invalid)

1 = EventStatusChanged (Event status or trading status changed)

2 = EventChanged (Event added / Event info changed)

3 = MarketChanged (Market added / Odds changed)

4 = ScoreboardChanged (Score changed)

5 = BetCancel (Bets canceled)

6 = EventSnapshot (Event snapshot delta)

7 = MarketsChanged (Markets added / Odds changed)

Possible values:

integer · enumOptional

Known types of deltas

0 = None (Delta type is invalid)

1 = EventStatusChanged (Event status or trading status changed)

2 = EventChanged (Event added / Event info changed)

3 = MarketChanged (Market added / Odds changed)

4 = ScoreboardChanged (Score changed)

5 = BetCancel (Bets canceled)

6 = EventSnapshot (Event snapshot delta)

7 = MarketsChanged (Markets added / Odds changed)

Possible values:

eventIdinteger · int64Optional

Id of changed event

versioninteger · int64Optional

Version of feed state

correlationIdstring · nullableOptional

Correlation id of the message to trace back.

creationTimestring · date-timeOptional

Captures the timestamp the dto was created.

sportIdinteger · int64Optional

Id of the Sport

locationIdinteger · int64Optional

Id of the Location

leagueIdinteger · int64Optional

Id of the League

updateSequenceinteger · int64Optional

Event delta sequence. Incremented with each sent delta.

lastUpdatedTimeinteger · int64Optional

Event update time. Incremented with each valuable update.

401

Unauthorized

403

Forbidden

404

Not Found

410

Gone

429

Too many requests

500

Internal Server Error

get

/api/events/v2/{eventId}

GET /api/events/v2/{eventId} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "type": 0,
  "eventId": 1,
  "version": 1,
  "correlationId": "text",
  "creationTime": "2026-03-12T03:39:51.236Z",
  "sportId": 1,
  "locationId": 1,
  "leagueId": 1,
  "updateSequence": 1,
  "lastUpdatedTime": 1,
  "eventInfo": {
    "id": 1,
    "name": "text",
    "status": 0,
    "tradingStatus": 0,
    "statusDescription": "text",
    "country": {
      "id": 1,
      "name": "text"
    },
    "sport": {
      "id": 1,
      "name": "text"
    },
    "competition": {
      "id": 1,
      "name": "text"
    },
    "season": {
      "id": 1,
      "name": "text"
    },
    "competitors": [
      {
        "id": 1,
        "name": "text"
      }
    ],
    "startTime": "2026-03-12T03:39:51.236Z",
    "isOutright": true,
    "customDisplayData": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "isBetBuilderSupported": true,
    "mappingInfo": [
      {
        "feedId": 1,
        "id": "text"
      }
    ]
  },
  "markets": [
    {
      "id": 1,
      "name": "text",
      "tradingStatus": 0,
      "selections": [
        {
          "id": 1,
          "name": "text",
          "probability": 1,
          "price": 1,
          "originalPrice": 1,
          "status": 0,
          "settlement": 0,
          "deadHeatFactor": 1,
          "extraParameters": {
            "ANY_ADDITIONAL_PROPERTY": "text"
          },
          "isBetBuilderSupported": true,
          "competitorId": 1
        }
      ],
      "type": 1,
      "isBestLine": true,
      "parameters": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "extraParameters": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "isBetBuilderSupported": true
    }
  ],
  "scoreboard": {
    "time": 1,
    "results": [
      {
        "competitorPosition": 1,
        "value": "text"
      }
    ],
    "periods": [
      {
        "id": 1,
        "isFinished": true,
        "incidents": [
          {
            "type": 1,
            "time": 1,
            "competitorPosition": 1
          }
        ],
        "results": [
          {
            "competitorPosition": 1,
            "value": "text"
          }
        ],
        "order": 1
      }
    ],
    "incidents": [
      {
        "type": 1,
        "competitorPosition": 1,
        "count": 1
      }
    ],
    "currentPeriodId": 1,
    "lastUpdateTime": "2026-03-12T03:39:51.236Z",
    "homeGameScore": "text",
    "awayGameScore": "text",
    "extraData": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    }
  },
  "betCancellations": [
    {
      "marketId": 1,
      "from": "2026-03-12T03:39:51.236Z",
      "to": "2026-03-12T03:39:51.236Z",
      "isRolledBack": true
    }
  ]
}

PreviousFixed Exotics API NextMetadata API

Last updated 5 months ago

Good night

hashtagSchedule Endpoints

hashtagRegular Events Schedule

hashtagGets list of non-outright event with specified UTC start date.

hashtagOutrights Endpoint

hashtagFetch Outright Events

hashtagEvent snapshot endpoint

hashtagGet snapshot of the specific event.

Schedule Endpoints

Regular Events Schedule

Gets list of non-outright event with specified UTC start date.

Outrights Endpoint

Fetch Outright Events

Event snapshot endpoint

Get snapshot of the specific event.