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>'import requests
url = "https://api.fieldfunded.com/v1/settlements"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.fieldfunded.com/v1/settlements', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fieldfunded.com/v1/settlements",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.fieldfunded.com/v1/settlements"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.fieldfunded.com/v1/settlements")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fieldfunded.com/v1/settlements")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"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
}
}Settlement
Get 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.
Optimized for automated betting systems to process payouts as soon as results are finalized.
An event appears in this feed as soon as at least one market is resolved (resolved_markets_count >= 1);
additional markets are appended gradually until pending_markets_count reaches 0.
This includes standard markets, player-prop markets, and dynamic live markets as each one is officially resolved.
Team names, logos, and final scores are included with each settlement entry.
⚠️ Poll regularly after the game ends to capture all market resolutions as they arrive gradually.
Poll every ~60s to capture all market resolutions before they expire.
This endpoint can return larger responses than lightweight endpoints (e.g. /v1/scores) because each
item may include multiple resolved markets and outcomes. We recommend keeping
limit small (20-50).
Results are returned newest first (ended_at descending), with event_id as a tie-breaker.
Use cursor pagination for efficient incremental processing.
For permanent score data, use /v1/events/{eventId}/result.
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>'import requests
url = "https://api.fieldfunded.com/v1/settlements"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.fieldfunded.com/v1/settlements', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fieldfunded.com/v1/settlements",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.fieldfunded.com/v1/settlements"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.fieldfunded.com/v1/settlements")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fieldfunded.com/v1/settlements")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"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
}
}Authorizations
Your FieldFunded API Key
Query Parameters
Maximum number of settlements to return (default: 100, max: 200). Recommended 20-50 for recurring polling.
Required range:
1 <= x <= 200Number of settlements to skip for pagination (default: 0). For recurring polling, keep offset=0.
Required range:
x >= 0Cursor-based pagination token (base64url encoded {ended_at,event_id} from next_cursor). Do not combine with offset.
Filter settlements by a single event id.
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).