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.
JWT Authorization header using the Bearer scheme. Example: "Authorization: Bearer {token}"
OK
Bad Request
Unauthorized
Forbidden
Too many requests
Internal Server Error
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
]
}[
{
"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": "2025-12-05T16:59:17.879Z",
"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.
JWT Authorization header using the Bearer scheme. Example: "Authorization: Bearer {token}"
OK
Bad Request
Unauthorized
Forbidden
Too many requests
Internal Server Error
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
]
}[
{
"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": "2025-12-05T16:59:17.879Z",
"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.
JWT Authorization header using the Bearer scheme. Example: "Authorization: Bearer {token}"
TradeArt event id.
OK
Unauthorized
Forbidden
Not Found
Gone
Too many requests
Internal Server Error
GET /api/events/v2/{eventId} HTTP/1.1
Host:
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"type": 0,
"eventId": 1,
"version": 1,
"correlationId": "text",
"creationTime": "2025-12-05T16:59:17.879Z",
"sportId": 1,
"locationId": 1,
"leagueId": 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": "2025-12-05T16:59:17.879Z",
"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": "2025-12-05T16:59:17.879Z",
"homeGameScore": "text",
"awayGameScore": "text",
"extraData": {
"ANY_ADDITIONAL_PROPERTY": "text"
}
},
"betCancellations": [
{
"marketId": 1,
"from": "2025-12-05T16:59:17.879Z",
"to": "2025-12-05T16:59:17.879Z",
"isRolledBack": true
}
]
}Last updated