Skip to main content
GET
/
v1
/
settlements
Settlement Feed — Auto-resolved market outcomes (won/lost/refund)
curl --request GET \
  --url https://api.fieldfunded.com/v1/settlements \
  --header 'X-API-Key: <api-key>'
{ "settlements": [ { "event_id": "87654321", "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", "final_score": { "home": 2, "away": 1 }, "sport": "soccer", "league": "Premier League", "country": "England", "start_time": "2026-04-12T15:00:00Z", "status": "settled", "settlement_status": "settled", "ended_at": "2026-04-12T16:55:00Z", "resolved_markets": [ { "key": "match_winner", "name": "Match Winner", "market_id": 340159, "outcomes": [ { "label": "Home", "result": "won", "selection_id": 1824561 }, { "label": "Draw", "result": "lost", "selection_id": 1824562 }, { "label": "Away", "result": "lost", "selection_id": 1824563 } ] }, { "key": "over_under_2_5", "name": "Over/Under 2.5", "market_id": 340160, "outcomes": [ { "label": "Over 2.5", "result": "won", "selection_id": 1824570 }, { "label": "Under 2.5", "result": "lost", "selection_id": 1824571 } ] }, { "key": "double_chance", "name": "Double Chance", "market_id": 340161, "outcomes": [ { "label": "Home/Draw", "result": "won", "selection_id": 1824580 }, { "label": "Home/Away", "result": "lost", "selection_id": 1824581 }, { "label": "Draw/Away", "result": "lost", "selection_id": 1824582 } ] }, { "key": "both_teams_to_score", "name": "Both Teams To Score", "market_id": 340162, "outcomes": [ { "label": "Yes", "result": "won", "selection_id": 1824590 }, { "label": "No", "result": "lost", "selection_id": 1824591 } ] }, { "key": "half_time_result", "name": "Half-time Result", "market_id": 340163, "outcomes": [ { "label": "Home", "result": "lost", "selection_id": 1824600 }, { "label": "Draw", "result": "won", "selection_id": 1824601 }, { "label": "Away", "result": "lost", "selection_id": 1824602 } ] }, { "key": "correct_score", "name": "Correct Score", "market_id": 340164, "outcomes": [ { "label": "2-1", "result": "won", "selection_id": 1824610 }, { "label": "1-1", "result": "lost", "selection_id": 1824611 }, { "label": "2-0", "result": "lost", "selection_id": 1824612 } ] }, { "key": "asian_handicap_minus_1", "name": "Asian Handicap -1.0", "market_id": 340165, "outcomes": [ { "label": "Home (-1.0)", "result": "won", "selection_id": 1824620 }, { "label": "Away (+1.0)", "result": "lost", "selection_id": 1824621 } ] }, { "key": "total_corners_over_9_5", "name": "Total Corners Over 9.5", "market_id": 340166, "outcomes": [ { "label": "Over 9.5", "result": "won", "selection_id": 1824630 }, { "label": "Under 9.5", "result": "lost", "selection_id": 1824631 } ] }, { "key": "first_goalscorer", "name": "First Goalscorer", "market_id": 340167, "outcomes": [ { "label": "Harry Kane", "result": "won", "selection_id": 1824640 }, { "label": "Bukayo Saka", "result": "lost", "selection_id": 1824641 } ] }, { "key": "total_cards_over_3_5", "name": "Total Cards Over 3.5", "market_id": 340168, "outcomes": [ { "label": "Over 3.5", "result": "won", "selection_id": 1824650 }, { "label": "Under 3.5", "result": "lost", "selection_id": 1824651 } ] } ], "resolved_markets_count": 1118, "total_markets_count": 1118, "pending_markets_count": 0 } ], "total": 842, "fully_settled": 10, "score_only": 0, "limit": 50, "offset": 0, "has_more": true, "next_cursor": "BASE64URL_CURSOR_TOKEN_FROM_PREVIOUS_RESPONSE", "applied_filters": { "event_ids_count": 0, "using_cursor": false } }

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

​
limit
integer
default:100

Maximum number of settlements to return (default: 100, max: 200). Recommended 20-50 for recurring polling.

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

Number of settlements to skip for pagination (default: 0). For recurring polling, keep offset=0.

Required range: x >= 0
​
cursor
string

Cursor-based pagination token (base64url encoded {ended_at,event_id} from next_cursor). Do not combine with offset.

​
event_id
string

Filter settlements by a single event id.

​
event_ids
string

Filter settlements by multiple event ids (CSV). Maximum 50 ids.

Response

A feed of recently ended events and their finalized market outcomes (won, lost, refund).

​
settlements
object[]
​
total
integer
​
fully_settled
integer
​
score_only
integer
​
limit
integer
​
offset
integer
​
has_more
boolean
​
next_cursor
string | null

Cursor for next page when using cursor-based incremental polling

​
applied_filters
object