Back to Main Page
API Online Admin Login

API v1 Service

Base URL: /api/v1  ·  Real-time horse racing, live odds, and AI performance metrics engine

Cloud Native CORS Enabled JSON Format Public · No Auth Required Sub-50ms Response
Domain
caydas.cloud
API Version
1.0.0
Server Timestamp
2026-09-05 08:41:57
Ingestion Engine
TJK Sync Active
Available Endpoints
11 Endpoints
Next / Upcoming Races
GET /api/v1/nextrace

Next upcoming race across Turkish tracks with complete horse detail (weight, jockey, last-6, live odds).

No params · Auto-resolved from current time · Returns null when day's races finish
GET /api/v1/nextrace/performance

Next race runners ranked by algorithm performance points (rank · no · horse · jockey · points).

Query: ?refresh=1 to recompute cache
GET /api/v1/nextrace/15min

Like /nextrace, but only if a Turkish race starts within 15 minutes (otherwise returns null).

Query: ?within=MINUTES (default: 15)
GET /api/v1/nextrace/15min/performance

Ranked field only when the next race is within 15 minutes.

Query: ?within=MINUTES · ?refresh=1
Programs & Entries
GET /api/v1/races

All hippodromes, track conditions, and race summaries for a date.

Query: ?date=YYYYMMDD (defaults to today)
GET /api/v1/races/{date}/{hippodrome}

All races and summary information for a single hippodrome on a date.

Params: date (YYYYMMDD), hippodrome (e.g. Istanbul, Ankara)
GET /api/v1/races/{date}/{hippodrome}/{race_no}

Single race with all horses, jockeys, weights, past forms, and live odds.

Params: date, hippodrome, race_no (e.g. 1, 2)
Results & Odds
GET /api/v1/results/{date}/{hippodrome}

All finished race results for a specified hippodrome.

Params: date (YYYYMMDD), hippodrome
GET /api/v1/results/{date}/{hippodrome}/{race_no}

Single race result with finish rankings, split times, margins, and payouts.

Params: date, hippodrome, race_no
GET /api/v1/odds/{date}/{hippodrome}/{race_no}

Full odds timeline per runner — ready for trend charts and fluctuation analysis.

Params: date, hippodrome, race_no
Performance & Search
GET /api/v1/performance/{race_code}/{horse_code}

Horse performance rating score (0–100) computed from track history, weight, jockey stats, and class group.

Params: race_code, horse_code · Optional: ?refresh=1
GET /api/v1/search/horses?q=...

Search horses by name substring across the historical racing database.

Query: ?q=NAME (min 2 chars)
Live API Console

Select a preset or enter any endpoint path to test live responses.

GET
Response Output 
// Click "Send" or choose an endpoint to view live output
API Traffic & Volume
2
Today
10,902
365 Days
10,902
All Time
Last 7 Days Requests
Sun
Mon
Tue
Wed
Thu
Fri
Sat
Auto-Broadcasts · @ikili1970
Live X Bot
0
Today
334
Total Posts
8
Tracks
Integration Quickstart
curl -s "https://gununteki.com/api/v1/nextrace"
const res = await fetch('https://gununteki.com/api/v1/nextrace'); const data = await res.json(); console.log(data.next_race);
import requests r = requests.get('https://gununteki.com/api/v1/nextrace') data = r.json() print(data.get('next_race'))
let url = URL(string: "https://gununteki.com/api/v1/nextrace")! let (data, _) = try await URLSession.shared.data(from: url) // Parse JSON with Decodable