Schema API

Provides information about internal Odds88 entities

Schema API endpoints allow to get internal entities which exist in Odds88.

All endpoints in the API are rate-limited.

Gets all existing leagues for a specific sport.

get

Authorizations

Bearer

HTTPRequired

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

Path parameters

sportIdinteger · int64Required

TradeArt sport id.

Responses

200

OK

text/plainapplication/jsontext/json

401

Unauthorized

403

Forbidden

429

Too many requests

500

Internal Server Error

get

/api/schema/leagues/{sportId}

HTTPcURLJavaScriptPython

GET /api/schema/leagues/{sportId} HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": 1,
    "name": "text",
    "sportId": 1,
    "locationId": 1
  }
]

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

Gets all existing locations for a specific sport.

get

Authorizations

Bearer

HTTPRequired

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

Query parameters

sportIdinteger · int64Optional

TradeArt sport id. Will return all locations if not specified.

Responses

200

OK

text/plainapplication/jsontext/json

401

Unauthorized

403

Forbidden

429

Too many requests

500

Internal Server Error

get

/api/schema/locations

HTTPcURLJavaScriptPython

GET /api/schema/locations HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": 1,
    "name": "text"
  }
]

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

Gets all existing market types for a specific sport.

get

Authorizations

Bearer

HTTPRequired

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

Query parameters

sportIdinteger · int64Optional

TradeArt sport id. Will return all market types if not specified.

includeFreeTextbooleanOptional

A flag indicating whether the response should include free text types or not.

Default: true

Responses

200

OK

text/plainapplication/jsontext/json

401

Unauthorized

403

Forbidden

429

Too many requests

500

Internal Server Error

get

/api/schema/market-types

HTTPcURLJavaScriptPython

GET /api/schema/market-types HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": 1,
    "name": "text",
    "groups": [
      {
        "id": 1,
        "name": "text",
        "order": 1,
        "sportId": 1
      }
    ],
    "isMultilineMarket": true,
    "isFreeText": true
  }
]

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

Gets all existing periods for a specific sport.

get

Authorizations

Bearer

HTTPRequired

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

Query parameters

sportIdinteger · int64Optional

TradeArt sport id. Will return all periods if not specified.

Responses

200

OK

text/plainapplication/jsontext/json

401

Unauthorized

403

Forbidden

429

Too many requests

500

Internal Server Error

get

/api/schema/periods

HTTPcURLJavaScriptPython

GET /api/schema/periods HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": 1,
    "name": "text",
    "sportId": 1
  }
]

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

Gets all existing sports.

get

Authorizations

Bearer

HTTPRequired

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

Responses

200

OK

text/plainapplication/jsontext/json

401

Unauthorized

403

Forbidden

429

Too many requests

500

Internal Server Error

get

/api/schema/sports

HTTPcURLJavaScriptPython

GET /api/schema/sports HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": 1,
    "name": "text"
  }
]

This endpoint is rate-limited to 1 request per minute.