Skip to main content
GET
/
v1
/
events
Get Events — Real-time odds with 300ms refresh (filterable)
curl --request GET \
  --url https://api.fieldfunded.com/v1/events \
  --header 'X-API-Key: <api-key>'
{
  "events": [
    {
      "id": "87654321",
      "sport": {
        "key": "soccer",
        "name": "Soccer"
      },
      "league": {
        "slug": "premier-league",
        "name": "Premier League",
        "country": "England"
      },
      "home_team": "Arsenal",
      "away_team": "Chelsea",
      "home_logo": "https://api.fieldfunded.com/api/logo/t-38",
      "away_logo": "https://api.fieldfunded.com/api/logo/t-42",
      "status": "live",
      "start_time": "2026-04-12T15:00:00Z",
      "score": {
        "home": 2,
        "away": 1
      },
      "clock": "67:10 2nd half",
      "period": "2nd Half",
      "odds": {
        "home": 1.45,
        "draw": 4.5,
        "away": 6
      },
      "odds_format": "decimal",
      "markets_count": 72,
      "updated_at": "2026-04-12T15:45:30.000Z"
    }
  ],
  "total": 842,
  "limit": 50,
  "offset": 0
}

Documentation Index

Fetch the complete documentation index at: https://docs.fieldfunded.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-API-Key
string
header
required

Your FieldFunded API Key

Query Parameters

​
sport
string

Filter by sport key (e.g. soccer, basketball, cs2). Use all or omit for all sports.

Example:

"soccer"

​
status
enum<string>
default:all

Filter by event status

Available options:
live,
prematch,
all
​
league
string

Filter by league. Supports exact slug match (premier-league) or partial name match (Premier). Use /v1/leagues to discover available league slugs.

Example:

"premier-league"

​
country
string

Filter by country (exact or partial match, case-insensitive)

Example:

"england"

​
date
string<date>

Filter events on a specific day (UTC). Format: YYYY-MM-DD. Cannot combine with from/to.

Example:

"2026-04-15"

​
from
string<date>

Filter events starting from this date (UTC inclusive). Format: YYYY-MM-DD. Use with to for a range.

Example:

"2026-04-15"

​
to
string<date>

Filter events up to this date (UTC inclusive). Format: YYYY-MM-DD. Use with from for a range.

Example:

"2026-04-17"

​
starts_within
string

Filter upcoming events starting within a time window from now. Format: {number}{unit} where unit is m (minutes), h (hours), or d (days). Only returns prematch events — excludes already-live games.

Example:

"60m"

​
limit
integer
default:50

Maximum number of events to return

Required range: 1 <= x <= 200
​
offset
integer
default:0

Number of events to skip (for pagination)

Required range: x >= 0
​
odds_format
enum<string>
default:decimal

Odds format for all values in response. Default: decimal

Available options:
decimal,
american,
fractional

Response

A paginated list of live and upcoming sports events, including available betting markets.

​
events
object[]
​
total
integer

Total events matching filters (before pagination)

​
limit
integer
​
offset
integer