tkTickOdds

API Documentation

TickOdds gives you programmatic access to prematch odds and live in-play data, sourced from bet365. Authenticate with your API key, then call REST endpoints or connect to our WebSocket.

Base URL

https://api.tickodds.com

Quick start

  1. Subscribe to a plan to get your API key.
  2. Send your key in the X-API-Key header on every request.
  3. Call /api/v1/sports, /api/v1/matches, or connect to the WebSocket at /ws/live.

Response envelope

All REST responses follow a consistent JSON shape:

{
  "ok": true,
  "data": [ ... ],
  "meta": { "timestamp": "2026-04-17T12:34:56Z" },
  "pagination": { "page": 1, "pageSize": 50, "total": 538 }
}

Errors use the same envelope with ok: false:

{
  "ok": false,
  "error": { "code": "FORBIDDEN", "message": "Live feed requires 'live' plan" }
}

Endpoints at a glance

GET/api/v1/sportsList all sports with counts
GET/api/v1/sports/{id}/competitionsCompetitions for a sport
GET/api/v1/competitions/{sportId}/{id}/matchesMatches for a competition
GET/api/v1/matches/{fixtureId}Single match with full odds
GET/api/v1/matchesAll matches (filterable + paginated)
GET/api/v1/live/eventsSnapshot of live events (live plan)
WS/ws/liveLive event stream (live plan)
GET/icons/{sub}/{file}Sport / competition / team SVG icons (no auth)

Icons

Sport, competition, and team icons (SVG) are bundled with every response as relative URL paths on the icon fields (icon, sportIcon, competitionIcon, homeIcon, awayIcon). Prepend your API base URL to fetch the file.

// Response
{ "home": "Crystal Palace", "homeIcon": "/icons/silks/CrystalPalace_Home_Front_25_26.svg" }

// Fetch the SVG (no auth required on /icons/*)
<img src="https://api.tickodds.com/icons/silks/CrystalPalace_Home_Front_25_26.svg" />
  • /icons/sports/<id>.svg — sport classification icons
  • /icons/flags/<file>.svg — competition country flags / trophies
  • /icons/silks/<file>.svg — team kit silks
  • Icon paths may be null when the scraper hasn't captured that asset yet. Team silks are populated after the match's full-odds page is first scraped.
  • Icon responses return Content-Type: image/svg+xml with a 24h cache header.