Skip to main content
GET
Get Events — Real-time odds with 300ms refresh (filterable)

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