FanDuel Racing race detail API

Endpoint facts

Method

GET

API path

/fanduel/racing/race

Auth

apiKey

Credits

2 credits/request

Charged on

Successful 2xx responses only

Platform

FanDuel

Response schema

#/definitions/fanduel.racingRaceResponseDoc

How this endpoint behaves

Query parameters

• track (required): track code from the tracks route, such as LRL. Malformed codes return 400.
• number (required): race number, 1 to 99. Other values return 400. A race that is not on today's card returns 404.
• include (optional, repeat the parameter or comma-separate): optional groups to add. Allowed values: handicapping, timeform, pool_grids. Any other value returns 400. Values are case-insensitive and repeats are ignored. The response's included lists the groups that were applied (canonical order), so an absent group is never mistaken for missing data.

Optional groups (include)

• handicapping adds, to every runner, handicapping and favorite_rank. handicapping holds up to six groups: speed_and_class (avg_class_rating, high_speed, normalised_speed_rating, high_speed_ranking, avg_speed, last_class_rating, avg_distance), average_pace (early, middle, finish, races), jockey_trainer (names, entity ids, starts, wins, places, shows of that pairing), snapshot (power_rating, normalised_power_rating, power_rating_ranking, days_off, horse_wins, horse_starts), free_pick (number, info) and past_results (starts, first, second, third, win_percentage, top3_percentage and their rankings such as 2nd). The service sends a group with every figure at zero for a runner with no history (a first-time starter); such a group is left out, so an absent group means no history, never zero. favorite_rank ranks the runner within the race, 1 being the favorite, by current_odds, morning_line, high_speed and power_rating.
• timeform adds, to every runner, timeform with analyst_comment, production_comment, tissue_price (Timeform's own decimal price, omitted when 0), free_pick and flags, the list of Timeform flags that are true. Flags: horse_in_focus, warning_horse, jockey_uplift, trainer_uplift, horse_for_course_positive, horse_for_course_negative, hot_trainer, cold_trainer, sectional_flag, significant_improver, jockey_in_form, clear_top_rated, interesting_jockey_booking, first_time_blinkers, highest_last_speed_rating. For an official race it also adds to every entry of results.finishers an entry number and timeform: beaten_lengths and beaten_text (for example 4.25 and 4¼), total_beaten_lengths and total_beaten_text (the margin to the winner), starting_price (decimal) and post_race_report. Many tracks send none of this and many runners have no analyst comment; those fields are simply omitted. rating_stars and form_figures on a runner are always present when the service has them, with or without this group.
• pool_grids adds, to every entry, pool_grids: one grid per pool with wager_type and cells, each {target, amount, status}. The entry is the grid's owner. For an exacta or a quinella target is the other entry, for a daily double it is the entry in the next race, and for win, place and show pools there is no target and the single cell is the money on the entry itself. Cells with no money and no status are left out. The service fills grids mostly once a race is official; an early open race returns none.

Response notes

• entries are the numbers a bet names. current_odds and morning_line are given as fractional (3/2; a bare numerator such as 6 is 6/1) and decimal (2.5); recent_odds is the price history, newest first, with the service's trending flag.
• pools, probables and will_pays are filled only when the track reports them. On 2026-10-23, 100 of 494 races had pools: 59 official, 34 Up Next, 4 Race Off and 4 open; will-pays appeared on 12. Otherwise they are empty lists, so an open race early in the card usually has none.
• results is present for an official race. A race the service reports as refunded has no finishers and one payoff whose selection is Refund (a French race on 2026-10-23, among 9 of 64 official races).
• wagers lists the wager types the race accepts with their minimum and maximum; decode a code with the wager-types route.
• track_condition is shown when the service knows it (for example Fast), and omitted when it reports Unknown.

Data is read from FanDuel Racing's own public service and is shown as published at the time of the request; it is not a betting recommendation, and prices, pools and statuses change by the minute. 503 on upstream failure.

{
  "included": ["handicapping", "timeform", "pool_grids"],
  "entries": [
    {
      "number": 1,
      "runners": [
        {
          "name": "Glory Run",
          "form_figures": "114",
          "rating_stars": 3,
          "handicapping": {
            "speed_and_class": { "avg_class_rating": 76, "high_speed": 80, "normalised_speed_rating": 61, "avg_speed": 69, "last_class_rating": 85, "avg_distance": 80 },
            "average_pace": { "early": 3.2, "middle": 1.6, "finish": 2.3, "races": 3 },
            "jockey_trainer": { "jockey_name": "Achard Alex", "trainer_name": "Ennis John", "starts": 82, "wins": 12, "places": 6, "shows": 13 },
            "snapshot": { "power_rating": 77, "normalised_power_rating": 59.23, "days_off": 74, "horse_wins": 2, "horse_starts": 3 },
            "past_results": { "starts": 3, "first": 2, "second": 0, "third": 0, "win_percentage": 66.67, "top3_percentage": 66.67, "win_percentage_ranking": "2nd" }
          },
          "favorite_rank": { "current_odds": 6, "morning_line": 6, "high_speed": 4, "power_rating": 5 },
          "timeform": { "analyst_comment": "Began career with two wins. ...", "tissue_price": 34, "flags": [] }
        }
      ],
      "pool_grids": [
        { "wager_type": { "code": "EX", "name": "Exacta" }, "cells": [ { "target": 2, "amount": 431 }, { "target": 3, "amount": 374 } ] },
        { "wager_type": { "code": "WN", "name": "Win" }, "cells": [ { "amount": 2821 } ] }
      ]
    }
  ],
  "results": {
    "finishers": [
      { "position": 2, "number": "7", "entry": 7, "timeform": { "beaten_lengths": 4.25, "beaten_text": "4¼", "total_beaten_lengths": 4.25, "total_beaten_text": "4½ lengths", "starting_price": 5.24, "post_race_report": "out,4p turn,earned2nd" } }
    ]
  }
}

Shared guides

Related