Judging a claimer
A claiming rider carries a weight allowance, so a positive A/E may be the allowance rather than the rider. by=year over the period the claim reduced shows which.
Documentation / Jockeys & owners
/v1/jockeys/{jockey_id}/stats
The standard block for a rider.
Send your key in the X-API-Key header, or as
?key= if your tool cannot set one. A date outside your plan's window returns
403 outside_window naming the window, never an empty array.
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| jockey_id | path | string | yes | Opaque jockey identifier. |
| by | query | string | no | A breakdown dimension: course, region, run_type, distance, going, surface, class, year, month, draw, field_size, layoff, sp_band, trainer, owner or sire. Omit for the overall block. |
| min_runs | query | integer | no | Drop breakdown rows with fewer rides than this. Defaults to 1; 30 is a more useful floor for anything you intend to act on. |
| date_from | query | string | no | YYYY-MM-DD. Clamped to your plan's window. |
| date_to | query | string | no | YYYY-MM-DD. Clamped to your plan's window. |
curl https://api.apihorseracing.com/v1/jockeys/jk_1ABH146/stats \ -H "X-API-Key: $AHR_KEY"
$ch = curl_init('https://api.apihorseracing.com/v1/jockeys/jk_1ABH146/stats'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ['X-API-Key: ' . getenv('AHR_KEY')], ]); $data = json_decode(curl_exec($ch), true)['data'];
const res = await fetch( 'https://api.apihorseracing.com/v1/jockeys/jk_1ABH146/stats', { headers: { 'X-API-Key': process.env.AHR_KEY } } ); const { meta, data } = await res.json();
import os, requests r = requests.get( "https://api.apihorseracing.com/v1/jockeys/jk_1ABH146/stats", headers={"X-API-Key": os.environ["AHR_KEY"]}, ).json()
curl https://api.apihorseracing.com/v1/jockeys/jk_1ABH146/stats?key=$AHR_KEY
$url = 'https://api.apihorseracing.com/v1/jockeys/jk_1ABH146/stats' . '?key=$AHR_KEY'; $data = json_decode(file_get_contents($url), true)['data'];
const res = await fetch( 'https://api.apihorseracing.com/v1/jockeys/jk_1ABH146/stats?key=$AHR_KEY' ); const { meta, data } = await res.json();
import os, requests r = requests.get( "https://api.apihorseracing.com/v1/jockeys/jk_1ABH146/stats?key=$AHR_KEY", ).json()
{ "meta": { "request_id": "c45b629a09627222", "data_as_of": "2026-09-12T05:10:27+00:00", "plan": "analyst", "window": "2017 → upcoming", "count": 3 }, "data": { "jockey_id": "jk_1ABH146", "jockey": "Millie Wonnacott", "window": { "from": null, "to": null, "note": "The whole archive. Your plan sets no date limit." }, "overall": { "runs": 449, "priced": 449, "first": 50, "second": 46, "third": 50, "fourth": 44, "win_pct": 0.1114, "top3_pct": 0.3252, "expected_wins": 39.02, "a_e": 1.281, "a_e_range": [ 0.926, 1.636 ], "a_e_beats_market": false, "significant": false, "low_sample": false, "pl_1pt": 15.89, "roi_pct": 3.54 }, "by": "course", "course": [ { "course": "Wolverhampton", "runs": 58, "priced": 58, "first": 6, "second": 2, "third": 5, "fourth": 7, "win_pct": 0.1034, "top3_pct": 0.2241, "expected_wins": 4.57, "a_e": 1.313, "a_e_range": [ 0.262, 2.363 ], "a_e_beats_market": false, "significant": false, "low_sample": true, "pl_1pt": 9, "roi_pct": 15.52 }, { "course": "Bath", "runs": 43, "priced": 43, "first": 5, "second": 8, "third": 3, "fourth": 1, "win_pct": 0.1163, "top3_pct": 0.3721, "expected_wins": 3.79, "a_e": 1.318, "a_e_range": [ 0.163, 2.473 ], "a_e_beats_market": false, "significant": false, "low_sample": true, "pl_1pt": 25, "roi_pct": 58.14 }, "… 1 more" ] } }
A real response from /v1/jockeys/jk_1ABH146/stats?by=course&limit=3,
captured by calling the live API rather than written by hand.
Each field is described once and rendered on every endpoint that returns it, so the wording cannot drift between pages.
| Field | Type | What it is |
|---|---|---|
| jockey_id | string | Opaque jockey identifier. |
| jockey | string | Rider name. |
| window | string | How far back and forward that plan can read. |
| runs | integer | Rides in the slice, priced or not. |
| priced | integer | Rides carrying a starting price. A/E and the profit figures use these; runs is the wider count. |
| first | integer | Wins. |
| second | integer | Seconds. Positions are returned separately so you apply your own place terms. |
| third | integer | Thirds. |
| fourth | integer | Fourths. |
| win_pct | number | Wins over runs. The number everyone quotes and the one that tells you least. |
| top3_pct | number | First, second or third over runs. Not a place strike rate; place terms vary. |
| expected_wins | number | Wins the market implied, summed over the slice. |
| a_e | number | Actual wins over expected. Above 1.00 means winning more often than the prices said. |
| a_e_range | array | Ninety five percent interval on A/E. If it spans 1.00 the figure is not evidence of anything. |
| a_e_beats_market | boolean | True only where the whole interval sits above 1.00. |
| significant | boolean | Whether the interval excludes 1.00 in either direction. |
| low_sample | boolean | Fewer than five expected wins. Treat A/E as noise. |
| pl_1pt | number | One point on every runner, settled at starting price. |
| roi_pct | number | Level stakes return. Backing everything loses more than the book margin, because equal stakes overweight the longshots. |
| course | string | Course name. |
| Code | Status | When |
|---|---|---|
| unauthorized | 401 | No key, or one we do not recognise. Check the header name and that the key has not been rotated from your account page. |
| upgrade_required | 403 | The endpoint returns computed statistics and your plan does not include them. The body names every plan that does reach it, so you never have to look it up. |
| not_found | 404 | The identifier is well formed but nothing has it. Distinct from invalid_id, which means the identifier itself is wrong. |
| invalid_id | 422 | The prefix does not match the kind of thing the path expects, or the identifier is malformed. A horse id passed where a race is wanted lands here rather than returning the wrong race. |
| invalid_param | 422 | A date that is not YYYY-MM-DD, a by= dimension we do not have, or a cursor that did not come from us. The message names the parameter. |
| rate_limited | 429 | Past your per-minute rate. Retry-After is set, and X-RateLimit-Remaining tells you where you stand on every successful response too. |
| server_error | 500 | Ours, not yours. Every response carries a request_id; quote it and we can find the exact request. |
A real request from your browser straight to
api.apihorseracing.com with
your own key. Nothing is proxied and nothing is logged by this page.
Remembered in this browser so you do not paste it on every page. Forget it
The standard statistics block for a rider, split any of sixteen ways, each row with a confidence interval.
A/E matters more for jockeys than for anyone else in this API, because a jockey's strike rate is almost entirely a function of the horses he is put on. A/E asks whether the rides beat their prices, which is the only version of the question that is about the rider at all.
Even then, be careful about what you conclude. A high A/E over a career is more likely to mean a rider is systematically underrated by the market than that he is better than everyone thinks. Those are different claims, and only the first is about prices.
The two dimensions worth reaching for first are by=course, because riders genuinely ride some tracks better, and by=run_type, because a flat jockey and a jumps jockey are different professions and a few people do both.
A claiming rider carries a weight allowance, so a positive A/E may be the allowance rather than the rider. by=year over the period the claim reduced shows which.
by=course with min_runs=30. Big galloping tracks and tight turning ones reward different riding.
by=trainer. If every good row is one yard, you are looking at the yard.
by=jockey is rejected with invalid_param here rather than silently ignored.