History & Settlement Signals
Game settlements
How each market on this fixture resolved.
A settlement is keyed WITHOUT a line, and reports the values the market
settled against rather than one book's verdict. That is deliberate: a
total at 8.5 and the same total at 9 are different bets on the same
result, and storing an outcome per line every book happened to post
would be more data that answers less. Grade your own line against
home_score / away_score / player_stat.
outcomes and winning_selection are present only where the verdict
does not depend on a line — moneyline and the yes/no props.
Check period_covered before grading anything. When it is false the
fixture never reached the market's period (a first-five-innings line on
a game called in the fourth), and the values describe innings that were
not played.
status is graded, or void when the market did not stand at all —
an abandoned match, an awarded result, a player who never appeared.
Markets we cannot settle are absent rather than reported with a guess.
Requires the signals entitlement (Max plan). See Responses & Errors for the success envelope and availability rules.
https://api.sportquanta.com/v1/{league}/games/{id}/settlementsReference context: WKBL.
Overview · Response conventions
Authorizations
AuthorizationstringheaderrequiredSend a workspace API token in the Authorization: Bearer <token> header.
Path Parameters
leagueenum<string>default:wkblrequiredLeague for this reference section: wkbl.
Available options: wkbl
idstringrequiredResponse
application/jsonSettled markets.
Query validation failed. Depending on the handler, invalid_query_parameter is returned with HTTP 400 or 422. Pre-read validation is non-billable.
Missing or invalid bearer API token.
Access is forbidden: the token lacks api.read scope, the plan lacks an endpoint/bookmaker capability, or configured billing access is inactive. Inspect error.code and details.feature when present.
The league is unsupported, the endpoint is not available for that sport, or the requested data has not been ingested. Inspect error.code.
Token validation or an internal handler failed. Token-store failures use api_token_lookup_failed; unsupported internal sport dispatch can use data_layer_unavailable.
The data layer (Mongo / ClickHouse / Redis cache) is temporarily unreachable. The server attempted the lookup; it failed. Retry with backoff. Per the spec's order of evaluation, this DOES consume monthly quota — the request reached step 6.
dataobjectrequireddata.leaguestringrequireddata.fixture_idstringdata.datestringdata.sincestringdata.countintegerrequireddata.settlementsobject[] | nullrequireddata.settlements.fixture_idstringrequireddata.settlements.leaguestringrequireddata.settlements.marketstringrequireddata.settlements.periodstringdata.settlements.participant_idstringdata.settlements.rulestringrequireddata.settlements.statusstringrequireddata.settlements.reason_codestringrequireddata.settlements.home_scoreintegerdata.settlements.away_scoreintegerdata.settlements.participant_scoreintegerdata.settlements.player_statnumberdata.settlements.period_coveredbooleanrequireddata.settlements.outcomesobjectSettlement result keyed by selection identifier (for example home, away, over, under). Values record won, lost, push (stake returned at the line), or void (market did not stand). Join keys to this market's selections; this is not an array.
data.settlements.outcomes.{key}stringdata.settlements.winning_selectionstringdata.settlements.graded_atstring<date-time>requireddata.settlements.revised_atstring<date-time>data.settlements.revisionintegerrequired_metaobjectResponse request/cache metadata. Optional evidence fields are specific to this handler; cache TTL does not measure source-data freshness.
_meta.request_idstring_meta.served_fromenum<string>Available options: live, cache
_meta.cache_ttl_secondsintegerResponse cache TTL; independent of source freshness. Omitted when zero.
errorobjectrequirederror.codestringrequiredStable machine-readable error code.
error.messagestringrequiredUser-facing error summary.
error.detailsanyOptional error details.