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

Rate Limits (per account):

• 10 req/1s

Authorizations

Bearer

HTTPRequired

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

Body

application/jsontext/jsonapplication/*+json

startDatestring · nullableOptional

Starting date of event. If null returns Events with StartTime=null or from tomorrow

sportIdsinteger · int64[] · nullableOptional

If not null filters by SportIds

locationIdsinteger · int64[] · nullableOptional

If not null filters by LocationIds

Responses

200

OK

text/plainapplication/jsontext/json

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

idinteger · int64Optional

TradeArt event id.

namestring · nullableOptional

Event name.

statusinteger · enumOptional

Status of event

• 0 - Unknown
• 1 - Planned
• 2 - SoonInPlay
• 3 - Live
• 4 - Completed
• 5 - Cancelled
• 6 - CoverageLost
• 7 - Closed
• 8 - Suspended
• 9 - Postponed
• 10 - Abandoned

Possible values:

tradingStatusinteger · enumOptional

Status of trading

• 0 - Open
• 1 - Suspended
• 2 - Closed
• 3 - Inactive

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

text/plainapplication/jsontext/json

401

Unauthorized

403

Forbidden

429

Too many requests

500

Internal Server Error

post

/api/events/schedule/v2

HTTPcURLJavaScriptPython

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
  ]
}

application/jsontext/jsonapplication/*+json

[
  {
    "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-05-14T03:42:13.394Z",
    "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

Rate Limits (per account):

• 10 req/1s

Authorizations

Bearer

HTTPRequired

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

Body

application/jsontext/jsonapplication/*+json

sportIdsinteger · int64[] · nullableOptional

If not null filters by SportIds

locationIdsinteger · int64[] · nullableOptional

If not null filters by LocationIds

Responses

200

OK

text/plainapplication/jsontext/json

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

idinteger · int64Optional

TradeArt event id.

namestring · nullableOptional

Event name.

statusinteger · enumOptional

Status of event

• 0 - Unknown
• 1 - Planned
• 2 - SoonInPlay
• 3 - Live
• 4 - Completed
• 5 - Cancelled
• 6 - CoverageLost
• 7 - Closed
• 8 - Suspended
• 9 - Postponed
• 10 - Abandoned

Possible values:

tradingStatusinteger · enumOptional

Status of trading

• 0 - Open
• 1 - Suspended
• 2 - Closed
• 3 - Inactive

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

text/plainapplication/jsontext/json

401

Unauthorized

403

Forbidden

429

Too many requests

500

Internal Server Error

post

/api/events/outrights

HTTPcURLJavaScriptPython

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

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

application/jsontext/jsonapplication/*+json

[
  {
    "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-05-14T03:42:13.394Z",
    "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

Rate Limits (per account):

• 10 req/1s

Authorizations

Bearer

HTTPRequired

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

Path parameters

eventIdinteger · int64Required

TradeArt event id.

Responses

200

OK

text/plainapplication/jsontext/json

Full snapshot of event data

typeinteger · enumOptional

Known types of deltas

• 0 - None
• 1 - EventStatusChanged
• 2 - EventChanged
• 3 - MarketChanged
• 4 - ScoreboardChanged
• 5 - BetCancel
• 6 - EventSnapshot
• 7 - MarketsChanged

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

text/plainapplication/jsontext/json

410

Gone

text/plainapplication/jsontext/json

429

Too many requests

500

Internal Server Error

get

/api/events/v2/{eventId}

HTTPcURLJavaScriptPython

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

{
  "type": 0,
  "eventId": 1,
  "version": 1,
  "correlationId": "text",
  "creationTime": "2026-05-14T03:42:13.394Z",
  "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-05-14T03:42:13.394Z",
    "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-05-14T03:42:13.394Z",
    "homeGameScore": "text",
    "awayGameScore": "text",
    "extraData": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    }
  },
  "betCancellations": [
    {
      "marketId": 1,
      "from": "2026-05-14T03:42:13.394Z",
      "to": "2026-05-14T03:42:13.394Z",
      "isRolledBack": true
    }
  ]
}