# Equibase — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access comprehensive horse racing data from Equibase, including horse profiles, historical race results, track entries, post times, speed figures, and leader statistics for horses, jockeys, trainers, and owners.

**Category:** Sports | **Website:** [equibase.com/](https://equibase.com/) | **Docs:** [parse.bot/marketplace/309336a6-d098-4302-9b5c-faa1307ed3ac/equibase-com-api](https://parse.bot/marketplace/309336a6-d098-4302-9b5c-faa1307ed3ac/equibase-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-equibase-com-api-309336a6/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_foals_scheduled

Retrieve foal crop statistics showing performance of horses from a specific foal year, ranked by earnings. Returns horses with their sire, speed figure, starts, wins, and earnings data.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-equibase-com-api-309336a6/get_foals_scheduled \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_horse_profile

Retrieve comprehensive horse data including career statistics broken down by year (starts, wins, earnings, highest speed figure) and historical race records with track, date, race type, finish position, and E-Speed figure. Requires the horse's reference number from search_horse results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `breed_type` | string | No | Breed type |
| `ref_no` | string | Yes | Horse reference number from search_horse results (e.g. '10286142') |
| `registry` | string | No | Registry code (e.g. T for Thoroughbred) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-equibase-com-api-309336a6/get_horse_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"breed_type":"<string>","ref_no":"<string>","registry":"<string>"}'
```

### get_leaders

Retrieve yearly or meet leader statistics for horses, jockeys, trainers, or owners ranked by earnings. Returns top performers with win/place/show counts, win percentage, top-three percentage, earnings, and earnings per start.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `breed` | string | No | Breed type filter. Accepted values: TB (Thoroughbred), QH (Quarter Horse). |
| `timeframe` | string | No | Timeframe for statistics. Accepted values: year, meet. |
| `type` | string | No | Leader type. Accepted values: horse, jockey, trainer, owner. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-equibase-com-api-309336a6/get_leaders \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"breed":"<string>","timeframe":"<string>","type":"<string>"}'
```

### get_race_results

Extract detailed horse racing results from a specific race including top finishers with win/place/show payoffs and exotic wager payoffs. Results are available for past race days only. The track and date must correspond to an actual race day.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | No | Country code |
| `date` | string | Yes | Race date in MM/DD/YYYY format |
| `race_num` | string | Yes | Race number (e.g. '1', '2', '3') |
| `track` | string | Yes | Track abbreviation (e.g. CD for Churchill Downs, SA for Santa Anita, AQU for Aqueduct) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-equibase-com-api-309336a6/get_race_results \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>","date":"<string>","race_num":"<string>","track":"<string>"}'
```

### get_speed_figures

Retrieve E-Speed figure leaders for the current year, sorted by highest speed figure. Returns horses with their speed figures, earnings, starts, wins, and sire information. Useful for identifying peak performers.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-equibase-com-api-309336a6/get_speed_figures \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_track_entries

Retrieve race card entries for a track on a specific date including race number, race type, purse, distance, surface, post time, number of starters, and detailed runner information (program number, post position, horse name, jockey, trainer, weight, morning line odds, medication, reference number, registry). Entries are typically available 1-2 days before the race date.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | No | Country code |
| `date` | string | Yes | Date in MM/DD/YYYY format |
| `track` | string | Yes | Track abbreviation (e.g. CD for Churchill Downs, SA for Santa Anita, SAR for Saratoga) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-equibase-com-api-309336a6/get_track_entries \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>","date":"<string>","track":"<string>"}'
```

### search_horse

Search for horses by name. Returns matching horses with reference numbers, sire/dam lineage, year of birth, sex, color, and registry information. Multiple matches are common for popular names; use ref_no from results to fetch full profiles.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `breed_type` | string | No | Breed type filter. Accepted values: TB (Thoroughbred), QH (Quarter Horse). |
| `name` | string | Yes | Horse name to search for |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-equibase-com-api-309336a6/search_horse \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"breed_type":"<string>","name":"<string>"}'
```