History & Settlement Signals

Date's settlements

Everything the league settled on one day.

Bounded on when we SETTLED, not on when the fixture was played. A correction to a week-old game belongs in today's feed; a game played today but not yet gradeable does not.

Requires the signals entitlement (Max plan). See Responses & Errors for the success envelope and availability rules.

GEThttps://api.sportquanta.com/v1/{league}/settlements

Reference context: WKBL.

Overview · Response conventions

curl --request GET \
  --url 'https://api.sportquanta.com/v1/wkbl/settlements' \
  --header 'Authorization: Bearer <token>'

{
  "data": {
    "league": "<string>",
    "fixture_id": "<string>",
    "date": "<string>",
    "since": "<string>",
    "count": 0,
    "settlements": [
      {
        "fixture_id": "<string>",
        "league": "<string>",
        "market": "<string>",
        "period": "<string>",
        "participant_id": "<string>",
        "rule": "<string>",
        "status": "<string>",
        "reason_code": "<string>",
        "home_score": 0,
        "away_score": 0,
        "participant_score": 0,
        "player_stat": 0,
        "period_covered": true,
        "outcomes": {
          "home": "won",
          "away": "lost"
        },
        "winning_selection": "<string>",
        "graded_at": "2026-10-29T00:00:00Z",
        "revised_at": "2026-10-29T00:00:00Z",
        "revision": 0
      }
    ]
  },
  "_meta": {
    "request_id": "REQUEST_ID",
    "served_from": "live",
    "cache_ttl_seconds": 300
  }
}

Authorizations

Authorizationstringheaderrequired

Send a workspace API token in the Authorization: Bearer <token> header.

Path Parameters

leagueenum<string>default:wkblrequired

League for this reference section: wkbl.

Available options: wkbl

Query Parameters

datestring<date>

UTC day, YYYY-MM-DD. Defaults to today.

Response

application/json

Settled markets for the day.

dataobjectrequired

data.leaguestringrequired

data.fixture_idstring

data.datestring

data.sincestring

data.countintegerrequired

data.settlementsobject[] | nullrequired

data.settlements.fixture_idstringrequired

data.settlements.leaguestringrequired

data.settlements.marketstringrequired

data.settlements.periodstring

data.settlements.participant_idstring

data.settlements.rulestringrequired

data.settlements.statusstringrequired

data.settlements.reason_codestringrequired

data.settlements.home_scoreinteger

data.settlements.away_scoreinteger

data.settlements.participant_scoreinteger

data.settlements.player_statnumber

data.settlements.period_coveredbooleanrequired

data.settlements.outcomesobject

Settlement 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}string

data.settlements.winning_selectionstring

data.settlements.graded_atstring<date-time>required

data.settlements.revised_atstring<date-time>

data.settlements.revisionintegerrequired

_metaobject

Response 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_secondsinteger

Response cache TTL; independent of source freshness. Omitted when zero.