horseracingapi.co.uk
Documentation / Guides

Plans and limits

What each plan reads, its rate limit and its monthly calls.

Plans differ in the days they read and how many calls they make. Every plan returns the same fields.

PlanPriceReadsPer minutePer month
Free keyFreeyesterday only6050
Live£35 a month, £350 a yeartoday and the next 3 days180250,000
Archive£60 a month, £600 a yearJanuary 2017 to yesterday90150,000
Complete£89 a month, £890 a yearJanuary 2017 to the next 3 days180400,000

Annual plans cost ten months. Prices are in pounds. Race reports and statistics are on Complete.

The free key

The free key reads yesterday's UK racing, by each course's own day. Prices (starting prices, the market and dividends) come back as null with a note in meta: the fields stay, so nothing breaks when you upgrade.

Rate limits

Every answer carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset (Unix seconds), and X-Quota-Remaining for the month. Too many calls in a minute is a 429 rate_limited with Retry-After; the month used up is a 429 quota_exceeded saying when it resets.

Checking your key

GET /v1/usage gives your plan, its window and the calls used today and this month. It does not count against your calls.

Compare the plans on the pricing page.