FieldFunded Sports API
Real-time odds, live scores, and automatic settlement for 30+ sports & esports. 1,000+ markets per game including player props. Team logos, league logos, country flags, and sport icons included. Parlays, outrights/futures, and featured games from priority leagues. Sub-second latency, fully automatic market resolution.
FieldFunded Sports API endpoints
| Method | Endpoint | Description |
|---|---|---|
| Sports | ||
| GET |
getMarkets /v1/markets |
Discovers all known market types currently available, grouped by sport. Samples active events to extract available market names and keys. Useful for building market selectors,… |
| GET |
getSports /v1/sports |
Returns all sports that currently have active events (live or prematch). Includes event counts per sport. The endpoint provides events counts and metadata for all active sports… |
| GET |
getLeagues /v1/leagues |
Returns all active leagues with event counts, grouped by sport. Each league includes a `slug` that can be used as a stable identifier for filtering via… |
| Events | ||
| GET |
getEventDetails /v1/events/{eventId} |
Returns complete event details including all available betting markets, detailed scoreboard with period scores, and sport-specific data (serving indicators for tennis, power play… |
| GET |
searchEvents /v1/search |
Search for events by team name or league name. Returns matching events across all sports. Supports partial matching. |
| POST |
getEventsBatch /v1/events/batch |
Fetch full details for up to 20 events in a single request. More efficient than individual requests. Returns **400 Bad Request** if more than 20 IDs are provided. **Full Market… |
| GET |
getFeaturedGames /v1/featured |
Returns top games from **priority leagues** — the biggest matches happening now or coming up soon. Live games are shown first, followed by nearest upcoming. Priority leagues:… |
| GET |
getEvents /v1/events |
Returns a paginated list of sports events. Filter by sport, league, or status. Results are sorted by start time (live events first, then upcoming). **Note**: By default, ended… |
| Live | ||
| GET |
getLiveEvents /v1/live |
Returns all currently live in-play events across all sports. This is a **lightweight listing endpoint** — each event includes real-time scores, match clocks, event metadata,… |
| GET |
getScores /v1/scores |
Returns live scores for all in-play events. Matches that recently ended are kept in the response for a 5-minute buffer window so your polling system can safely capture the final… |
| Odds | ||
| GET |
getEventOdds /v1/events/{eventId}/odds |
Returns current odds for all markets of a specific event without the full event envelope (scores, metadata, etc.). This is a **lightweight, odds-only** alternative to… |
| Results | ||
| GET |
getEventResult /v1/events/{eventId}/result |
Returns the official score/state for an event result. Available automatically as soon as the game finishes — no developer action required. This endpoint is **score-only** and… |
| Settlement | ||
| POST |
checkParlay /v1/bets/check-parlay |
Submit a multi-leg parlay and get the combined resolution. The API resolves each leg individually by matching `market` name and `outcome` label, then calculates the combined… |
| POST |
checkBets /v1/bets/check |
Submit your users' bet selections and check their resolution status — the API automatically determines if each bet `won`, `lost`, `refund`, or is still `pending`. Each selection… |
| GET |
getSettlements /v1/settlements |
Fully automatic — markets resolve without developer intervention as soon as a game ends. Retrieves a real-time feed of recently settled match results and market resolutions.… |
| GET |
getOutrightSettlements /v1/settlements/outrights |
Returns settled outcomes for outright/futures markets (tournament-level settlements). This endpoint is separate from `/v1/settlements`, which is match/event settlement only.… |
| Outrights | ||
| GET |
getOutrightDetail /v1/outrights/{tournamentId} |
Returns all **outright/futures markets and odds** for a specific tournament. Example markets: "Premier League Winner", "Top Scorer", "Most Assists", "Relegation", "Top 4 Finish",… |
| GET |
getOutrights /v1/outrights |
Returns tournaments that have **outright (futures) markets** — long-term bets like "Who will win the Premier League?" or "Ballon d'Or winner". These are NOT match-by-match odds.… |
| GET |
getOutrightSports /v1/outrights/sports |
Discovers which sports currently have outright (futures) markets available. Returns sport IDs and tournament counts — use these IDs with `/v1/outrights?sport_id=X`. Scans 17… |
| System | ||
| GET |
getHealth /v1/health |
Reports the health of the API, including service connectivity, data freshness, and uptime. Returns HTTP 200 when healthy, HTTP 503 when degraded. Use this for monitoring… |
| GET |
getStatus /v1/status |
Returns current API health, data freshness timestamps, and global event counts. **No authentication required** — safe to call from status pages, monitoring dashboards, or public… |
| GET |
ping /v1/ping |
Ultra-lightweight endpoint for uptime monitoring. Returns immediately with minimal payload. > This endpoint does not count against your monthly quota. Fixed rate limit: 2 req/s,… |
| Usage Monitoring | ||
| GET |
getUsage /v1/usage |
Returns your current API usage statistics including today's requests, monthly quota consumption, remaining requests, and a 30-day daily breakdown. |
| GET |
getUsageEndpoints /v1/usage/endpoints |
Returns request counts per endpoint for the current billing month, sorted by volume (highest first). Use this to identify which endpoints consume the most quota and optimize your… |
| GET |
getUsageWarnings /v1/usage/warnings |
Returns any active warnings for your API key, including quota threshold alerts and elevated error rate notifications. Warning levels: `info` (approaching limit), `warning` (>80%… |
| Other endpoints | ||
| GET |
searchEvents /v1/search |
Search for events by team name or league name. Returns matching events across all sports. Supports partial matching. |
| POST |
getEventsBatch /v1/events/batch |
Fetch full details for up to 20 events in a single request. More efficient than individual requests. Returns **400 Bad Request** if more than 20 IDs are provided. **Full Market… |
| GET |
getEvents /v1/events |
Returns a paginated list of sports events. Filter by sport, league, or status. Results are sorted by start time (live events first, then upcoming). **Note**: By default, ended… |
| GET |
getHealth /v1/health |
Reports the health of the API, including service connectivity, data freshness, and uptime. Returns HTTP 200 when healthy, HTTP 503 when degraded. Use this for monitoring… |
| POST |
checkParlay /v1/bets/check-parlay |
Submit a multi-leg parlay and get the combined resolution. The API resolves each leg individually by matching `market` name and `outcome` label, then calculates the combined… |
| GET |
getOutrights /v1/outrights |
Returns tournaments that have **outright (futures) markets** — long-term bets like "Who will win the Premier League?" or "Ballon d'Or winner". These are NOT match-by-match odds.… |
| GET |
getOutrightDetail /v1/outrights/{tournamentId} |
Returns all **outright/futures markets and odds** for a specific tournament. Example markets: "Premier League Winner", "Top Scorer", "Most Assists", "Relegation", "Top 4 Finish",… |
| GET |
getEventOdds /v1/events/{eventId}/odds |
Returns current odds for all markets of a specific event without the full event envelope (scores, metadata, etc.). This is a **lightweight, odds-only** alternative to… |
| GET |
getOutrightSports /v1/outrights/sports |
Discovers which sports currently have outright (futures) markets available. Returns sport IDs and tournament counts — use these IDs with `/v1/outrights?sport_id=X`. Scans 17… |
| GET |
getLiveEvents /v1/live |
Returns all currently live in-play events across all sports. This is a **lightweight listing endpoint** — each event includes real-time scores, match clocks, event metadata,… |
| GET |
getScores /v1/scores |
Returns live scores for all in-play events. Matches that recently ended are kept in the response for a 5-minute buffer window so your polling scripts can safely capture the final… |
| GET |
getSettlements /v1/settlements |
Fully automatic — markets resolve without developer intervention as soon as a game ends. Retrieves a real-time feed of recently settled match results and market resolutions.… |
| GET |
getEventResult /v1/events/{eventId}/result |
Returns the official score/state for an event result. Available automatically as soon as the game finishes — no developer action required. This endpoint is **score-only** and… |
| GET |
getUsageEndpoints /v1/usage/endpoints |
Returns request counts per endpoint for the current billing month, sorted by volume (highest first). Use this to identify which endpoints consume the most quota and optimize your… |
| GET |
getOutrightSettlements /v1/settlements/outrights |
Returns settled outcomes for outright/futures markets (tournament-level settlements). This endpoint is separate from `/v1/settlements`, which is match/event settlement only.… |
| POST |
checkBets /v1/bets/check |
**The white-label killer feature.** Submit your users' bet selections and get automatic settlement results. The API matches each selection by `market` name and `outcome` label… |
| GET |
ping /v1/ping |
Ultra-lightweight endpoint for uptime monitoring. Returns immediately with minimal payload. > This endpoint does not count against your monthly quota. Fixed rate limit: 2 req/s,… |
| GET |
getUsageWarnings /v1/usage/warnings |
Returns any active warnings for your API key, including quota threshold alerts and elevated error rate notifications. Warning levels: `info` (approaching limit), `warning` (>80%… |
| GET |
getLeagues /v1/leagues |
Returns all active leagues with event counts, grouped by sport. Each league includes a `slug` that can be used as a stable identifier for filtering via… |
| GET |
getUsage /v1/usage |
Returns your current API usage statistics including today's requests, monthly quota consumption, remaining requests, and a 30-day daily breakdown. |
| GET |
getStatus /v1/status |
Returns current API health, data freshness timestamps, and global event counts. **No authentication required** — safe to call from status pages, monitoring dashboards, or public… |
| GET |
getMarkets /v1/markets |
Discovers all known market types currently available, grouped by sport. Samples active events to extract available market names and keys. Useful for building market selectors,… |
| GET |
getEventDetails /v1/events/{eventId} |
Returns complete event details including all available betting markets, detailed scoreboard with period scores, and sport-specific data (serving indicators for tennis, power play… |
| GET |
getSports /v1/sports |
Returns all sports that currently have active events (live or prematch). Includes event counts per sport. The endpoint provides events counts and metadata for all active sports… |
| GET |
getFeaturedGames /v1/featured |
Returns top games from **priority leagues** — the biggest matches happening now or coming up soon. Live games are shown first, followed by nearest upcoming. Priority leagues:… |
FieldFunded Sports API pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | 2 / second |
|
| PRO | $29 / month | 10 / second |
|
| ULTRA | $59 / month | 30 / second |
|
| MEGA | $99.99 / month | 60 / second |
|