Data freshness and quality
Payloads are pre-match and validated. Warnings tell you which rows to trust less.
Prediction reliability
include_unreliable. PyPI 0.3.1 does not support the
SDK argument; it requires the local 0.3.2
SDK and the updated API. Do not assume this option is available on the live service.By default, Starter returns only reliable predictions. Explicitly request
include_unreliable=true on match lists, detail, bulk or picks to also receive complete,
verified calculations rejected for identified sporting quality reasons. This does not extend the
match horizon or competition entitlement, and does not change website gates or probabilities.
reliability is a boolean; reliability_context is a sorted list of
language-independent reason codes, empty when reliable. It is not a probability of correctness.
as_of remains the calculation timestamp.
{"reliability": false, "reliability_context": ["elo_unreliable"],
"reliability_policy_version": "starter-reliability-policy-v1"}| Code | Meaning |
|---|---|
| elo_unreliable | Elo reliability requirement is not satisfied. |
| shadow_insufficient_data | The existing sporting quality gate marks the calculation as shadow. |
| sparse_goal_context | Limited goal-context sample; accompanies a shadow decision. |
| elo_missing | Missing Elo evidence used by the sporting quality gate. |
| goal_raw_data_unreliable | Goal observations do not satisfy the sporting quality requirement. |
| uefa_qualification_mute | UEFA qualification/playoff excluded by the website publication policy. |
Incomplete/invalid probabilities, unknown rejection reasons, invalid provenance, ambiguous identity or cancelled fixtures are not opened by this option. Default filtering occurs before pagination; keep the option unchanged while following a cursor. ETags distinguish both variants.
Freshness
Starter serves a separately promoted release. Each payload was produced before kickoff from the data
available at its as_of timestamp and validated by the publication pipeline. The API does
not promise live updates, and there is no live route.
Warnings
The quality object carries warnings and quality metadata. Retain them, handle missing
optional values, and use the version fields for traceability.
"quality": {"warnings": []}What is not exposed
Proprietary rules, coefficients, advanced context, and calibration methods are not part of the public contract. Probabilities are analytical estimates, not guarantees of outcomes or financial returns.
See the quality model for the field list.