Live Australian racing and sports odds for AI agents, hosted or local. Read-only tools.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
PuntersEdge API key (Authorization: Bearer <key> also works). Free tier is 3,000 credits/month with no card required: https://puntersedge.online/api
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Accepted fields for upcoming Australian meetings: runners, barriers, jockeys, trainers and weights, before the markets open. Costs 2 credits. Every plan.
Meeting day, YYYY-MM-DD, Australian Eastern time.
Venue name as the feeds spell it, case-insensitive, e.g. Randwick or Sandown Hillside.
Accepted fields for upcoming Australian meetings: runners, barriers, jockeys, trainers and weights, before the markets open. Costs 2 credits. Every plan.
| Argument | Type | Description |
|---|---|---|
| date | string | Meeting day, YYYY-MM-DD, Australian Eastern time. |
| venue | string | Venue name as the feeds spell it, case-insensitive, e.g. Randwick or Sandown Hillside. |
{
"type": "object",
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Meeting day, YYYY-MM-DD, Australian Eastern time."
},
"venue": {
"type": "string",
"maxLength": 80,
"minLength": 2,
"description": "Venue name as the feeds spell it, case-insensitive, e.g. Randwick or Sandown Hillside."
}
},
"additionalProperties": false
}This API key's plan, credits used and remaining this month, burn rate, projected run-out date, requests-per-minute limit and the endpoints using the most credits. Call it before a large job. Free. Every plan.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}The best available win and place price for every runner in upcoming races and which bookmaker has it, after PuntersEdge's guards (books pricing under 100%, quotes read before a scratching and placeholder prices never win). Also how many books quote each runner, the best-vs-worst spread, and each race's market percentage on best prices. Costs 3 credits. Every plan.
| Argument | Type | Description |
|---|---|---|
| date | string | Meeting day, YYYY-MM-DD, Australian Eastern time. |
| venue | string | Venue name as the feeds spell it, case-insensitive, e.g. Randwick or Sandown Hillside. |
| country | string | ISO country code(s), comma-separated: AU, NZ, GB (Britain, not UK), IE, ZA, e.g. 'AU' or 'GB,IE'. Without country or venue this covers AU, NZ, GB, IE and ZA. |
| num_races | integer | |
| bookmakers | array | Only these bookmaker keys, e.g. ["tab", "sportsbet", "ladbrokes_au"]. Default: every book. An unknown key is refused free of charge with the list of valid keys. |
| categories | array | Racing codes to include. horse = thoroughbreds. Default: all three. |
| hours_ahead | integer | Scan window from now; default 6. Plan ceiling 24 / 48 / 168 as race_card. |
The downloadable Parquet/CSV datasets (closing lines, price paths, results) and which days and months exist. Files are downloaded over REST with your key, never through MCP: GET https://api.puntersedge.online/v1/bulk/{dataset}/{period} (20 credits per day file, 100 per month file). Free. Plan: Business and above.
| Argument | Type | Description |
|---|---|---|
| dataset | string |
{
"type": "object",
"properties": {
"dataset": {
"type": "string",
"pattern": "^[a-z0-9_]{2,60}$"
}
},
"additionalProperties": false
}Each bookmaker's closing price per runner from the archive, for model building, CLV and settlement checks. Closing-only rows by default (last quote within 5 minutes of the jump). Costs 5 credits. Plan: Standard and above (last 90 days); Plus and above for the full archive.
| Argument | Type | Description |
|---|---|---|
| date | string | Meeting day, YYYY-MM-DD, Australian Eastern time. |
| limit | integer | |
| venue | string | Venue name as the feeds spell it, case-insensitive, e.g. Randwick or Sandown Hillside. |
| offset | integer | |
| country | string | ISO country code(s), comma-separated: AU, NZ, GB (Britain, not UK), IE, ZA, e.g. 'AU' or 'GB,IE'. |
| race_id | string | race_id from odds_board, race_card, race_results or the archive. The most reliable way to name a race. |
| to_date | string | |
| from_date | string | |
| bookmakers | array |
Each runner's consensus probability and fair price for one race, built by removing every bookmaker's margin and combining the books, with the books included and excluded and why. Costs 3 credits. Every plan.
| Argument | Type | Description |
|---|---|---|
| venue | string | Venue name as the feeds spell it, case-insensitive, e.g. Randwick or Sandown Hillside. |
| country | string | Two-letter country of the meeting. Only needed when two meetings share a venue name on one day (Ascot in Perth and in Berkshire). |
| race_id | string | race_id from odds_board, race_card, race_results or the archive. The most reliable way to name a race. |
| min_books | integer | |
| bookmakers | array | Only these bookmaker keys, e.g. ["tab", "sportsbet", "ladbrokes_au"]. Default: every book. An unknown key is refused free of charge with the list of valid keys. |
| race_number | integer | |
| meeting_date | string | Meeting day, YYYY-MM-DD, Australian Eastern time. |
| include_stale | boolean |
Grade up to 200 bets against the closing line: for each bet, the closing price (that book's, or the market best/median), CLV percent and P&L line. Name each race by race_id or venue + meeting_date + race_number, and each runner by runner_number or runner_name. Costs 5 credits per request. Plan: Plus and above.
| Argument | Type | Description |
|---|---|---|
| bets* | array | |
| reference | string |
{
"type": "object",
"required": [
"bets"
],
"properties": {
"bets": {
"type": "array",
"items": {
"type": "object",
"required": [
"price"
],
"properties": {
"ref": {
"type": "string",
"maxLength": 80
},
"price": {
"type": "number",
"maximum": 1000,
"exclusiveMinimum": 1
},
"stake": {
"type": "number",
"maximum": 1000000,
"exclusiveMinimum": 0
},
"venue": {
"type": "string",
"maxLength": 80,
"minLength": 2,
"description": "Venue name as the feeds spell it, case-insensitive, e.g. Randwick or Sandown Hillside."
},
"race_id": {
"type": "string",
"maxLength": 120,
"minLength": 4,
"description": "race_id from odds_board, race_card, race_results or the archive. The most reliable way to name a race."
},
"bookmaker": {
"type": "string",
"maxLength": 40
},
"runner_ref": {
"type": "string",
"maxLength": 60
},
"race_number": {
"type": "integer",
"maximum": 20,
"minimum": 1
},
"runner_name": {
"type": "string",
"maxLength": 80
},
"meeting_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Meeting day, YYYY-MM-DD, Australian Eastern time."
},
"runner_number": {
"type": "integer",
"maximum": 30,
"minimum": 1
}
},
"additionalProperties": false
},
"maxItems": 200,
"minItems": 1
},
"reference": {
"enum": [
"best",
"median"
],
"type": "string",
"default": "best"
}
},
"additionalProperties": false
}Live health of every bookmaker feed: seconds since its last good poll, whether it is stale or degraded. For operations teams deciding whether to trust a price right now. Costs 1 credit. Every plan.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}A thoroughbred's recent starts and statistics, by name or the pe:/ra: reference other tools return. Costs 3 credits. Every plan.
| Argument | Type | Description |
|---|---|---|
| horse* | string |
{
"type": "object",
"required": [
"horse"
],
"properties": {
"horse": {
"type": "string",
"maxLength": 80,
"minLength": 2
}
},
"additionalProperties": false
}Runners whose price has moved across several bookmakers since they opened (steam and drift), with the consensus open and current price and how many books confirm the move. Costs 3 credits. Every plan.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| country | string | ISO country code(s), comma-separated: AU, NZ, GB (Britain, not UK), IE, ZA, e.g. 'AU' or 'GB,IE'. |
| direction | string | Omit for both. |
| min_books | integer | |
| categories | array | Racing codes to include. horse = thoroughbreds. Default: all three. |
| min_move_pct | number | |
| max_mins_to_jump | integer |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 50,
"minimum": 1
},
"country": {
"type": "string",
"pattern": "^[A-Za-z]{2}(,[A-Za-z]{2}){0,9}$",
"description": "ISO country code(s), comma-separated: AU, NZ, GB (Britain, not UK), IE, ZA, e.g. 'AU' or 'GB,IE'."
},
"direction": {
"enum": [
"firming",
"drifting"
],
"type": "string",
"description": "Omit for both."
},
"min_books": {
"type": "integer",
"default": 3,
"maximum": 12,
"minimum": 1
},
"categories": {
"type": "array",
"items": {
"enum": [
"horse",
"greyhound",
"harness"
],
"type": "string"
},
"maxItems": 3,
"description": "Racing codes to include. horse = thoroughbreds. Default: all three."
},
"min_move_pct": {
"type": "number",
"default": 10,
"maximum": 90,
"minimum": 1
},
"max_mins_to_jump": {
"type": "integer",
"default": 360,
"maximum": 360,
"minimum": 5
}
},
"additionalProperties": false
}Per-runner market summary for past races: opening and closing consensus, the move between them and its signal class (strong_firm, firm, steady, drift, strong_drift). Costs 5 credits. Plan: Standard and above (last 90 days); Plus and above for the full archive.
| Argument | Type | Description |
|---|---|---|
| date | string | Meeting day, YYYY-MM-DD, Australian Eastern time. |
| limit | integer | |
| venue | string | Venue name as the feeds spell it, case-insensitive, e.g. Randwick or Sandown Hillside. |
| offset | integer | |
| signal | array | |
| country | string | Two-letter country of the meeting. Only needed when two meetings share a venue name on one day (Ascot in Perth and in Berkshire). |
| race_id | string | race_id from odds_board, race_card, race_results or the archive. The most reliable way to name a race. |
| to_date | string | |
| from_date | string |
The next races to run with EVERY bookmaker's current win and place price for every runner, as a compact matrix: each race lists its bookmakers (with the age of each book's quote) and each runner carries price arrays in that order. The fastest way to see the whole live market. For the best price per runner use best_odds; for one race in depth use race_odds. Costs 2 credits. Every plan.
| Argument | Type | Description |
|---|---|---|
| venue | string | Venue name as the feeds spell it, case-insensitive, e.g. Randwick or Sandown Hillside. |
| country | string | ISO country code(s), comma-separated: AU, NZ, GB (Britain, not UK), IE, ZA, e.g. 'AU' or 'GB,IE'. Without country or venue this covers AU, NZ, GB, IE and ZA. |
| num_races | integer | How many upcoming races, soonest first. Default 5. |
| bookmakers | array | Only these bookmaker keys, e.g. ["tab", "sportsbet", "ladbrokes_au"]. Default: every book. An unknown key is refused free of charge with the list of valid keys. |
| categories | array | Racing codes to include. horse = thoroughbreds. Default: all three. |
{
"type": "object",
"properties": {
"venue": {
"type": "string",
"maxLength": 80,
"minLength": 2,
"description": "Venue name as the feeds spell it, case-insensitive, e.g. Randwick or Sandown Hillside."
},
"country": {
"type": "string",
"pattern": "^[A-Za-z]{2}(,[A-Za-z]{2}){0,9}$",
"description": "ISO country code(s), comma-separated: AU, NZ, GB (Britain, not UK), IE, ZA, e.g. 'AU' or 'GB,IE'. Without country or venue this covers AU, NZ, GB, IE and ZA."
},
"num_races": {
"type": "integer",
"default": 5,
"maximum": 20,
"minimum": 1,
"description": "How many upcoming races, soonest first. Default 5."
},
"bookmakers": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9_]{2,40}$"
},
"maxItems": 30,
"description": "Only these bookmaker keys, e.g. [\"tab\", \"sportsbet\", \"ladbrokes_au\"]. Default: every book. An unknown key is refused free of charge with the list of valid keys."
},
"categories": {
"type": "array",
"items": {
"enum": [
"horse",
"greyhound",
"harness"
],
"type": "string"
},
"maxItems": 3,
"description": "Racing codes to include. horse = thoroughbreds. Default: all three."
}
},
"additionalProperties": false
}Only the racing prices that moved since your last call, so an agent or pipeline can follow the whole market cheaply. First call: omit cursor (covers the last 60 seconds). Every reply has next_cursor; pass it back as cursor on the next call, within 30 minutes. Delivery is at-least-once: de-duplicate on (race_id, runner number, bookmaker, updated_at). Costs 2 credits. Every plan.
| Argument | Type | Description |
|---|---|---|
| cursor | string | next_cursor from the previous odds_changes reply (ISO 8601 UTC). Older than 30 minutes is refused free of charge. |
| country | string | ISO country code(s), comma-separated: AU, NZ, GB (Britain, not UK), IE, ZA, e.g. 'AU' or 'GB,IE'. |
| categories | array | Racing codes to include. horse = thoroughbreds. Default: all three. |
{
"type": "object",
"properties": {
"cursor": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:?\\d{2})?)?$",
"maxLength": 40,
"description": "next_cursor from the previous odds_changes reply (ISO 8601 UTC). Older than 30 minutes is refused free of charge."
},
"country": {
"type": "string",
"pattern": "^[A-Za-z]{2}(,[A-Za-z]{2}){0,9}$",
"description": "ISO country code(s), comma-separated: AU, NZ, GB (Britain, not UK), IE, ZA, e.g. 'AU' or 'GB,IE'."
},
"categories": {
"type": "array",
"items": {
"enum": [
"horse",
"greyhound",
"harness"
],
"type": "string"
},
"maxItems": 3,
"description": "Racing codes to include. horse = thoroughbreds. Default: all three."
}
},
"additionalProperties": false
}Every bookmaker's price path for each runner in one race: open, close, high and low, and optionally the time series. Give race_id, or venue + race_number + date. Costs 5 credits. Plan: Every plan for races in the last 24 hours; Standard and above for older races.
| Argument | Type | Description |
|---|---|---|
| date | string | Race date, YYYY-MM-DD. |
| venue | string | Venue name as the feeds spell it, case-insensitive, e.g. Randwick or Sandown Hillside. |
| race_id | string | race_id from odds_board, race_card, race_results or the archive. The most reliable way to name a race. |
| bookmakers | array | Only these bookmaker keys, e.g. ["tab", "sportsbet", "ladbrokes_au"]. Default: every book. An unknown key is refused free of charge with the list of valid keys. |
| max_points | integer | |
| race_number | integer | |
| include_points | boolean | true adds every captured price point (larger reply). |
{
"type": "object",
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Race date, YYYY-MM-DD."
},
"venue": {
"type": "string",
"maxLength": 80,
"minLength": 2,
"description": "Venue name as the feeds spell it, case-insensitive, e.g. Randwick or Sandown Hillside."
},
"race_id": {
"type": "string",
"maxLength": 120,
"minLength": 4,
"description": "race_id from odds_board, race_card, race_results or the archive. The most reliable way to name a race."
},
"bookmakers": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9_]{2,40}$"
},
"maxItems": 30,
"description": "Only these bookmaker keys, e.g. [\"tab\", \"sportsbet\", \"ladbrokes_au\"]. Default: every book. An unknown key is refused free of charge with the list of valid keys."
},
"max_points": {
"type": "integer",
"default": 500,
"maximum": 2000,
"minimum": 100
},
"race_number": {
"type": "integer",
"maximum": 20,
"minimum": 1
},
"include_points": {
"type": "boolean",
"default": false,
"description": "true adds every captured price point (larger reply)."
}
},
"additionalProperties": false
}Upcoming races without prices: race_id, venue, race number, start time, distance, track condition, status, runners and scratchings. The cheapest way to find race_ids for the other tools. Costs 1 credit. Every plan.
| Argument | Type | Description |
|---|---|---|
| date | string | A single Australian Eastern meeting day instead of hours_ahead. |
| country | string | ISO country code(s), comma-separated: AU, NZ, GB (Britain, not UK), IE, ZA, e.g. 'AU' or 'GB,IE'. Without country or venue this covers AU, NZ, GB, IE and ZA. |
| categories | array | Racing codes to include. horse = thoroughbreds. Default: all three. |
| hours_ahead | integer | Hours ahead from now. The plan ceiling is 24 on Free and Hobby, 48 on Standard, 168 on Plus and above. |
{
"type": "object",
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "A single Australian Eastern meeting day instead of hours_ahead."
},
"country": {
"type": "string",
"pattern": "^[A-Za-z]{2}(,[A-Za-z]{2}){0,9}$",
"description": "ISO country code(s), comma-separated: AU, NZ, GB (Britain, not UK), IE, ZA, e.g. 'AU' or 'GB,IE'. Without country or venue this covers AU, NZ, GB, IE and ZA."
},
"categories": {
"type": "array",
"items": {
"enum": [
"horse",
"greyhound",
"harness"
],
"type": "string"
},
"maxItems": 3,
"description": "Racing codes to include. horse = thoroughbreds. Default: all three."
},
"hours_ahead": {
"type": "integer",
"default": 4,
"maximum": 168,
"minimum": 1,
"description": "Hours ahead from now. The plan ceiling is 24 on Free and Hobby, 48 on Standard, 168 on Plus and above."
}
},
"additionalProperties": false
}Recent runs and form stats for every runner in one race. Give race_id, or venue + meeting_date + race_number. Costs 3 credits. Every plan.
| Argument | Type | Description |
|---|---|---|
| runs | integer | |
| venue | string | Venue name as the feeds spell it, case-insensitive, e.g. Randwick or Sandown Hillside. |
| race_id | string | race_id from odds_board, race_card, race_results or the archive. The most reliable way to name a race. |
| race_number | integer | |
| meeting_date | string | Meeting day, YYYY-MM-DD, Australian Eastern time. |
{
"type": "object",
"properties": {
"runs": {
"type": "integer",
"default": 5,
"maximum": 10,
"minimum": 1
},
"venue": {
"type": "string",
"maxLength": 80,
"minLength": 2,
"description": "Venue name as the feeds spell it, case-insensitive, e.g. Randwick or Sandown Hillside."
},
"race_id": {
"type": "string",
"maxLength": 120,
"minLength": 4,
"description": "race_id from odds_board, race_card, race_results or the archive. The most reliable way to name a race."
},
"race_number": {
"type": "integer",
"maximum": 20,
"minimum": 1
},
"meeting_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Meeting day, YYYY-MM-DD, Australian Eastern time."
}
},
"additionalProperties": false
}A one-race market read: consensus at each mark, how the market has moved, which books lead or lag, and the signals PuntersEdge derives from them. Costs 3 credits. Every plan.
| Argument | Type | Description |
|---|---|---|
| venue | string | Venue name as the feeds spell it, case-insensitive, e.g. Randwick or Sandown Hillside. |
| country | string | Two-letter country of the meeting. Only needed when two meetings share a venue name on one day (Ascot in Perth and in Berkshire). |
| race_id | string | race_id from odds_board, race_card, race_results or the archive. The most reliable way to name a race. |
| min_books | integer | |
| race_number | integer | |
| meeting_date | string | Meeting day, YYYY-MM-DD, Australian Eastern time. |
{
"type": "object",
"properties": {
"venue": {
"type": "string",
"maxLength": 80,
"minLength": 2,
"description": "Venue name as the feeds spell it, case-insensitive, e.g. Randwick or Sandown Hillside."
},
"country": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "Two-letter country of the meeting. Only needed when two meetings share a venue name on one day (Ascot in Perth and in Berkshire)."
},
"race_id": {
"type": "string",
"maxLength": 120,
"minLength": 4,
"description": "race_id from odds_board, race_card, race_results or the archive. The most reliable way to name a race."
},
"min_books": {
"type": "integer",
"default": 2,
"maximum": 14,
"minimum": 1
},
"race_number": {
"type": "integer",
"maximum": 20,
"minimum": 1
},
"meeting_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Meeting day, YYYY-MM-DD, Australian Eastern time."
}
},
"additionalProperties": false
}Every bookmaker's prices for one race across win, place and top 2/3/4, plus exotic dividends once settled. Live prices before the jump, each book's closing price after it. Give race_id, or venue + meeting_date + race_number. Costs 2 credits. Plan: Plus and above.
| Argument | Type | Description |
|---|---|---|
| venue | string | Venue name as the feeds spell it, case-insensitive, e.g. Randwick or Sandown Hillside. |
| country | string | Two-letter country of the meeting. Only needed when two meetings share a venue name on one day (Ascot in Perth and in Berkshire). |
| markets | array | Markets to include. Default: all. |
| race_id | string | race_id from odds_board, race_card, race_results or the archive. The most reliable way to name a race. |
| bookmakers | array | Only these bookmaker keys, e.g. ["tab", "sportsbet", "ladbrokes_au"]. Default: every book. An unknown key is refused free of charge with the list of valid keys. |
| race_number | integer | |
| meeting_date | string | Meeting day, YYYY-MM-DD, Australian Eastern time. |
One upcoming race in full: every runner with every bookmaker's win, place and (where offered) top 2/3/4 price, each book's quote age, scratchings and race conditions. Give the venue plus race_number or race_id; with only a venue you get that venue's next race. The call is billed even when the race is not on the live board (already run or not yet priced); the reply then lists the races that are. Costs 2 credits. Every plan.
| Argument | Type | Description |
|---|---|---|
| venue* | string | Venue name as the feeds spell it, case-insensitive, e.g. Randwick or Sandown Hillside. |
| country | string | ISO country code(s), comma-separated: AU, NZ, GB (Britain, not UK), IE, ZA, e.g. 'AU' or 'GB,IE'. |
| race_id | string | race_id from odds_board, race_card, race_results or the archive. The most reliable way to name a race. |
| bookmakers | array | Only these bookmaker keys, e.g. ["tab", "sportsbet", "ladbrokes_au"]. Default: every book. An unknown key is refused free of charge with the list of valid keys. |
| race_number | integer |
{
"type": "object",
"required": [
"venue"
],
"properties": {
"venue": {
"type": "string",
"maxLength": 80,
"minLength": 2,
"description": "Venue name as the feeds spell it, case-insensitive, e.g. Randwick or Sandown Hillside."
},
"country": {
"type": "string",
"pattern": "^[A-Za-z]{2}(,[A-Za-z]{2}){0,9}$",
"description": "ISO country code(s), comma-separated: AU, NZ, GB (Britain, not UK), IE, ZA, e.g. 'AU' or 'GB,IE'."
},
"race_id": {
"type": "string",
"maxLength": 120,
"minLength": 4,
"description": "race_id from odds_board, race_card, race_results or the archive. The most reliable way to name a race."
},
"bookmakers": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9_]{2,40}$"
},
"maxItems": 30,
"description": "Only these bookmaker keys, e.g. [\"tab\", \"sportsbet\", \"ladbrokes_au\"]. Default: every book. An unknown key is refused free of charge with the list of valid keys."
},
"race_number": {
"type": "integer",
"maximum": 20,
"minimum": 1
}
},
"additionalProperties": false
}Settled results: placings with settled prices, starting prices where published, and dividends. Use date for a past day or hours_back for the latest. Costs 2 credits. Every plan.
| Argument | Type | Description |
|---|---|---|
| date | string | Meeting day, YYYY-MM-DD, Australian Eastern time. |
| limit | integer | |
| venue | string | Venue name as the feeds spell it, case-insensitive, e.g. Randwick or Sandown Hillside. |
| offset | integer | |
| status | string | |
| country | string | ISO country code(s), comma-separated: AU, NZ, GB (Britain, not UK), IE, ZA, e.g. 'AU' or 'GB,IE'. |
| categories | array | Racing codes to include. horse = thoroughbreds. Default: all three. |
| hours_back | integer |
{
"type": "object",
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Meeting day, YYYY-MM-DD, Australian Eastern time."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 50,
"minimum": 1
},
"venue": {
"type": "string",
"maxLength": 80,
"minLength": 2,
"description": "Venue name as the feeds spell it, case-insensitive, e.g. Randwick or Sandown Hillside."
},
"offset": {
"type": "integer",
"maximum": 100000,
"minimum": 0
},
"status": {
"enum": [
"final",
"interim",
"abandoned"
],
"type": "string"
},
"country": {
"type": "string",
"pattern": "^[A-Za-z]{2}(,[A-Za-z]{2}){0,9}$",
"description": "ISO country code(s), comma-separated: AU, NZ, GB (Britain, not UK), IE, ZA, e.g. 'AU' or 'GB,IE'."
},
"categories": {
"type": "array",
"items": {
"enum": [
"horse",
"greyhound",
"harness"
],
"type": "string"
},
"maxItems": 3,
"description": "Racing codes to include. horse = thoroughbreds. Default: all three."
},
"hours_back": {
"type": "integer",
"default": 6,
"maximum": 168,
"minimum": 1
}
},
"additionalProperties": false
}A small live sample of the next races with a few bookmakers' win prices, to see the data before you connect a key. Free. Needs no API key.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}The best price for each outcome of a sport's upcoming events and which bookmaker has it. Costs 3 credits. Every plan.
| Argument | Type | Description |
|---|---|---|
| sport_key* | string | Sport key from sports_list, e.g. afl, nrl, nba or epl. An unknown key is answered with the valid ones. |
{
"type": "object",
"required": [
"sport_key"
],
"properties": {
"sport_key": {
"type": "string",
"pattern": "^[a-z0-9_]{2,60}$",
"description": "Sport key from sports_list, e.g. afl, nrl, nba or epl. An unknown key is answered with the valid ones."
}
},
"additionalProperties": false
}Every sport and league with live odds, its sport_key and how many events and bookmakers it has. Costs 1 credit. Every plan.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}How a sport's prices have moved since a time (default the last 24 hours), per bookmaker and outcome. Costs 5 credits. Plan: Standard and above.
| Argument | Type | Description |
|---|---|---|
| since | string | |
| market | string | |
| min_delta | number | |
| sport_key* | string | Sport key from sports_list, e.g. afl, nrl, nba or epl. An unknown key is answered with the valid ones. |
| bookmakers | array | Only these bookmaker keys, e.g. ["tab", "sportsbet", "ladbrokes_au"]. Default: every book. An unknown key is refused free of charge with the list of valid keys. |
{
"type": "object",
"required": [
"sport_key"
],
"properties": {
"since": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:?\\d{2})?)?$",
"maxLength": 40
},
"market": {
"enum": [
"h2h",
"spreads",
"totals"
],
"type": "string",
"default": "h2h"
},
"min_delta": {
"type": "number",
"maximum": 100,
"minimum": 0
},
"sport_key": {
"type": "string",
"pattern": "^[a-z0-9_]{2,60}$",
"description": "Sport key from sports_list, e.g. afl, nrl, nba or epl. An unknown key is answered with the valid ones."
},
"bookmakers": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9_]{2,40}$"
},
"maxItems": 30,
"description": "Only these bookmaker keys, e.g. [\"tab\", \"sportsbet\", \"ladbrokes_au\"]. Default: every book. An unknown key is refused free of charge with the list of valid keys."
}
},
"additionalProperties": false
}Every bookmaker's head-to-head, line and total prices for a sport's upcoming events. Costs 1 credit per market requested. Every plan.
| Argument | Type | Description |
|---|---|---|
| markets | array | Default h2h. Each market is billed. |
| sport_key* | string | Sport key from sports_list, e.g. afl, nrl, nba or epl. An unknown key is answered with the valid ones. |
| bookmakers | array | Only these bookmaker keys, e.g. ["tab", "sportsbet", "ladbrokes_au"]. Default: every book. An unknown key is refused free of charge with the list of valid keys. |
| competition | string | One competition, e.g. NRLW. |
{
"type": "object",
"required": [
"sport_key"
],
"properties": {
"markets": {
"type": "array",
"items": {
"enum": [
"h2h",
"spreads",
"totals"
],
"type": "string"
},
"maxItems": 3,
"description": "Default h2h. Each market is billed."
},
"sport_key": {
"type": "string",
"pattern": "^[a-z0-9_]{2,60}$",
"description": "Sport key from sports_list, e.g. afl, nrl, nba or epl. An unknown key is answered with the valid ones."
},
"bookmakers": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9_]{2,40}$"
},
"maxItems": 30,
"description": "Only these bookmaker keys, e.g. [\"tab\", \"sportsbet\", \"ladbrokes_au\"]. Default: every book. An unknown key is refused free of charge with the list of valid keys."
},
"competition": {
"type": "string",
"maxLength": 60,
"description": "One competition, e.g. NRLW."
}
},
"additionalProperties": false
}Track rating, rail, weather and every logged change for a meeting day (defaults to today). Costs 1 credit. Every plan.
| Argument | Type | Description |
|---|---|---|
| date | string | Meeting day, YYYY-MM-DD, Australian Eastern time. |
| venue | string | Venue name as the feeds spell it, case-insensitive, e.g. Randwick or Sandown Hillside. |
{
"type": "object",
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Meeting day, YYYY-MM-DD, Australian Eastern time."
},
"venue": {
"type": "string",
"maxLength": 80,
"minLength": 2,
"description": "Venue name as the feeds spell it, case-insensitive, e.g. Randwick or Sandown Hillside."
}
},
"additionalProperties": false
}{
"type": "object",
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Meeting day, YYYY-MM-DD, Australian Eastern time."
},
"venue": {
"type": "string",
"maxLength": 80,
"minLength": 2,
"description": "Venue name as the feeds spell it, case-insensitive, e.g. Randwick or Sandown Hillside."
},
"country": {
"type": "string",
"pattern": "^[A-Za-z]{2}(,[A-Za-z]{2}){0,9}$",
"description": "ISO country code(s), comma-separated: AU, NZ, GB (Britain, not UK), IE, ZA, e.g. 'AU' or 'GB,IE'. Without country or venue this covers AU, NZ, GB, IE and ZA."
},
"num_races": {
"type": "integer",
"default": 5,
"maximum": 20,
"minimum": 1
},
"bookmakers": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9_]{2,40}$"
},
"maxItems": 30,
"description": "Only these bookmaker keys, e.g. [\"tab\", \"sportsbet\", \"ladbrokes_au\"]. Default: every book. An unknown key is refused free of charge with the list of valid keys."
},
"categories": {
"type": "array",
"items": {
"enum": [
"horse",
"greyhound",
"harness"
],
"type": "string"
},
"maxItems": 3,
"description": "Racing codes to include. horse = thoroughbreds. Default: all three."
},
"hours_ahead": {
"type": "integer",
"maximum": 168,
"minimum": 1,
"description": "Scan window from now; default 6. Plan ceiling 24 / 48 / 168 as race_card."
}
},
"additionalProperties": false
}| Only these bookmaker keys, e.g. ["tab", "sportsbet", "ladbrokes_au"]. Default: every book. An unknown key is refused free of charge with the list of valid keys. |
| categories | array | Racing codes to include. horse = thoroughbreds. Default: all three. |
| race_number | integer |
| resulted_only | boolean |
{
"type": "object",
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Meeting day, YYYY-MM-DD, Australian Eastern time."
},
"limit": {
"type": "integer",
"default": 100,
"maximum": 200,
"minimum": 1
},
"venue": {
"type": "string",
"maxLength": 80,
"minLength": 2,
"description": "Venue name as the feeds spell it, case-insensitive, e.g. Randwick or Sandown Hillside."
},
"offset": {
"type": "integer",
"maximum": 10000000,
"minimum": 0
},
"country": {
"type": "string",
"pattern": "^[A-Za-z]{2}(,[A-Za-z]{2}){0,9}$",
"description": "ISO country code(s), comma-separated: AU, NZ, GB (Britain, not UK), IE, ZA, e.g. 'AU' or 'GB,IE'."
},
"race_id": {
"type": "string",
"maxLength": 120,
"minLength": 4,
"description": "race_id from odds_board, race_card, race_results or the archive. The most reliable way to name a race."
},
"to_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:?\\d{2})?)?$",
"maxLength": 40
},
"from_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:?\\d{2})?)?$",
"maxLength": 40
},
"bookmakers": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9_]{2,40}$"
},
"maxItems": 30,
"description": "Only these bookmaker keys, e.g. [\"tab\", \"sportsbet\", \"ladbrokes_au\"]. Default: every book. An unknown key is refused free of charge with the list of valid keys."
},
"categories": {
"type": "array",
"items": {
"enum": [
"horse",
"greyhound",
"harness"
],
"type": "string"
},
"maxItems": 3,
"description": "Racing codes to include. horse = thoroughbreds. Default: all three."
},
"race_number": {
"type": "integer",
"maximum": 20,
"minimum": 1
},
"resulted_only": {
"type": "boolean",
"default": false
}
},
"additionalProperties": false
}{
"type": "object",
"properties": {
"venue": {
"type": "string",
"maxLength": 80,
"minLength": 2,
"description": "Venue name as the feeds spell it, case-insensitive, e.g. Randwick or Sandown Hillside."
},
"country": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "Two-letter country of the meeting. Only needed when two meetings share a venue name on one day (Ascot in Perth and in Berkshire)."
},
"race_id": {
"type": "string",
"maxLength": 120,
"minLength": 4,
"description": "race_id from odds_board, race_card, race_results or the archive. The most reliable way to name a race."
},
"min_books": {
"type": "integer",
"default": 2,
"maximum": 14,
"minimum": 1
},
"bookmakers": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9_]{2,40}$"
},
"maxItems": 30,
"description": "Only these bookmaker keys, e.g. [\"tab\", \"sportsbet\", \"ladbrokes_au\"]. Default: every book. An unknown key is refused free of charge with the list of valid keys."
},
"race_number": {
"type": "integer",
"maximum": 20,
"minimum": 1
},
"meeting_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Meeting day, YYYY-MM-DD, Australian Eastern time."
},
"include_stale": {
"type": "boolean",
"default": false
}
},
"additionalProperties": false
}| categories | array | Racing codes to include. horse = thoroughbreds. Default: all three. |
{
"type": "object",
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Meeting day, YYYY-MM-DD, Australian Eastern time."
},
"limit": {
"type": "integer",
"default": 50,
"maximum": 200,
"minimum": 1
},
"venue": {
"type": "string",
"maxLength": 80,
"minLength": 2,
"description": "Venue name as the feeds spell it, case-insensitive, e.g. Randwick or Sandown Hillside."
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0
},
"signal": {
"type": "array",
"items": {
"enum": [
"strong_firm",
"firm",
"steady",
"drift",
"strong_drift",
"insufficient"
],
"type": "string"
},
"maxItems": 6
},
"country": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "Two-letter country of the meeting. Only needed when two meetings share a venue name on one day (Ascot in Perth and in Berkshire)."
},
"race_id": {
"type": "string",
"maxLength": 120,
"minLength": 4,
"description": "race_id from odds_board, race_card, race_results or the archive. The most reliable way to name a race."
},
"to_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:?\\d{2})?)?$",
"maxLength": 40
},
"from_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:?\\d{2})?)?$",
"maxLength": 40
},
"categories": {
"type": "array",
"items": {
"enum": [
"horse",
"greyhound",
"harness"
],
"type": "string"
},
"maxItems": 3,
"description": "Racing codes to include. horse = thoroughbreds. Default: all three."
}
},
"additionalProperties": false
}{
"type": "object",
"properties": {
"venue": {
"type": "string",
"maxLength": 80,
"minLength": 2,
"description": "Venue name as the feeds spell it, case-insensitive, e.g. Randwick or Sandown Hillside."
},
"country": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "Two-letter country of the meeting. Only needed when two meetings share a venue name on one day (Ascot in Perth and in Berkshire)."
},
"markets": {
"type": "array",
"items": {
"enum": [
"win",
"place",
"top2",
"top3",
"top4",
"exotics"
],
"type": "string"
},
"maxItems": 6,
"description": "Markets to include. Default: all."
},
"race_id": {
"type": "string",
"maxLength": 120,
"minLength": 4,
"description": "race_id from odds_board, race_card, race_results or the archive. The most reliable way to name a race."
},
"bookmakers": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9_]{2,40}$"
},
"maxItems": 30,
"description": "Only these bookmaker keys, e.g. [\"tab\", \"sportsbet\", \"ladbrokes_au\"]. Default: every book. An unknown key is refused free of charge with the list of valid keys."
},
"race_number": {
"type": "integer",
"maximum": 20,
"minimum": 1
},
"meeting_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Meeting day, YYYY-MM-DD, Australian Eastern time."
}
},
"additionalProperties": false
}