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

Bearer

HTTPRequired

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

Body

application/jsontext/jsonapplication/*+json

Responses

200

OK

text/plainapplication/jsontext/json

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
Host: 
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-01-25T07:12:48.479Z",
    "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

Bearer

HTTPRequired

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

Body

application/jsontext/jsonapplication/*+json

Responses

200

OK

text/plainapplication/jsontext/json

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
Host: 
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-01-25T07:12:48.479Z",
    "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

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

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
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "type": 0,
  "eventId": 1,
  "version": 1,
  "correlationId": "text",
  "creationTime": "2026-01-25T07:12:48.479Z",
  "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-01-25T07:12:48.479Z",
    "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"
          }
        ]
      }
    ],
    "incidents": [
      {
        "type": 1,
        "competitorPosition": 1,
        "count": 1
      }
    ],
    "currentPeriodId": 1,
    "lastUpdateTime": "2026-01-25T07:12:48.479Z",
    "homeGameScore": "text",
    "awayGameScore": "text",
    "extraData": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    }
  },
  "betCancellations": [
    {
      "marketId": 1,
      "from": "2026-01-25T07:12:48.479Z",
      "to": "2026-01-25T07:12:48.479Z",
      "isRolledBack": true
    }
  ]
}