API reference
Opono Tie Forecast
Copy as Markdown
List knockout ties
GET /v1/ties
List, at zero credits, the knockout matches in the next 8 days that need a winner on the day: a one-match tie or a second leg.
Authentication: Bearer API key with data.read; active Plus or Pro plan required.
Parameters
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
| — | — | — | None. |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
| — | — | — | None. |
Body parameters
| Name | Type | Required | Description |
|---|---|---|---|
| — | — | — | None. |
Example request
bash
curl 'https://api.opono.com/v1/ties' \
--header "Authorization: Bearer $OPONO_API_KEY"Response
| Field | Type | Description |
|---|---|---|
object | string | list. |
as_of | string or null | When the forecasts were published; null when there are none. |
data | array | Ties in kick-off order. |
data[].fixture_id | integer | Fixture ID for the tie forecast and for simulations. |
data[].kickoff | string | Kick-off in ISO 8601 UTC. |
data[].leg | string | single or second. |
data[].competition | object | Competition id and round name, when known. |
Example response
200 response with a test key.
json
{
"object": "list",
"as_of": null,
"data": []
}Errors
| Status | Code | Meaning |
|---|---|---|
| 400 | parameter_invalid | A parameter has an invalid value. |
| 401 | invalid_api_key | The credential cannot authenticate. |
| 401 | key_revoked | The API key has been revoked. |
| 401 | key_expired | The API key has expired. |
| 403 | scope_missing | The key lacks the required scope. |
| 403 | tier_restricted | The organisation plan does not include this operation. |
| 403 | org_suspended | Your account is suspended. |
| 403 | ip_not_allowed | The caller is outside the key's IP allowlist. |
| 429 | rate_limited | A request or authentication rate limit was exceeded. |
| 503 | dependency_unavailable | Request admission is unavailable. |
| 503 | maintenance | The API is paused for maintenance. |
Opono Tie Forecast
GET /v1/fixtures/{fixture_id}/tie
Read Opono Robin's forecast of a knockout tie for 1 credit: the 90-minute result, the chances of extra time and penalties, and of the home side going through. A second leg conditions on the first-leg score. The away side goes through in the rest of the cases, less any replay the competition's rules allow. Closes at kick-off.
Authentication: Bearer API key with data.read; active Plus or Pro plan required.
Parameters
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
fixture_id | integer | Yes | Use a returned fixture ID instead of home, away, and date; minimum: 1. |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
| — | — | — | None. |
Body parameters
| Name | Type | Required | Description |
|---|---|---|---|
| — | — | — | None. |
Example request
bash
curl 'https://api.opono.com/v1/fixtures/19609874/tie' \
--header "Authorization: Bearer $OPONO_API_KEY"Response
| Field | Type | Description |
|---|---|---|
object | string | tie_forecast. |
fixture_id | integer | Selected fixture. |
kickoff | string | Kick-off in ISO 8601 UTC. |
home / away | object | Team ID and name. |
competition | object | Competition id and round name, when known. |
leg | string | single, a one-match tie; or second, the second leg of two. |
first_leg | object or null | A second leg's first-leg home_goals and away_goals; null for a one-match tie. |
rules.decided_on_the_day | number | Chance a level tie is settled by extra time or penalties on the day, not by a replay. |
rules.straight_to_penalties | number | Chance a level tie goes straight to penalties. |
rules.away_goals | number | Chance away goals decide a level aggregate. |
result_90 | object | home, draw and away after 90 minutes and added time. |
p_extra_time | number | Chance of extra time. |
p_penalties | number | Chance of a penalty shootout. |
p_home_through | number | Chance the home side goes through, by any route. |
as_of | string | When the forecast was published, in ISO 8601 UTC. |
publication | string | The publication's day. A new day's forecast is a new paid read; the same one replays for free. |
model.public_name / model.version | string / string | Opono Robin and its release. |
credits_charged | number | One credit on first live delivery; zero for a same-publication replay or test key. |
replay | boolean | Whether your organisation already read this forecast from this publication. |
livemode | boolean | False for synthetic test output. |
receipt | object | Credit receipt on live delivery or replay. |
Example response
200 synthetic test response; zero credits.
json
{
"object": "tie_forecast",
"fixture_id": 19609874,
"kickoff": "2026-10-28T19:45:00.000Z",
"home": {
"team_id": 1,
"name": "Synthetic home"
},
"away": {
"team_id": 2,
"name": "Synthetic away"
},
"competition": {
"id": 1,
"round": "Synthetic round"
},
"leg": "single",
"first_leg": null,
"rules": {
"decided_on_the_day": 1,
"straight_to_penalties": 0.1,
"away_goals": 0,
"source": "synthetic"
},
"result_90": {
"home": 0.45,
"draw": 0.27,
"away": 0.28
},
"p_extra_time": 0.243,
"p_penalties": 0.115,
"p_home_through": 0.588,
"as_of": "2026-10-27T10:05:28.000Z",
"publication": "synthetic",
"model": {
"public_name": "Opono Robin",
"version": "synthetic"
},
"credits_charged": 0,
"replay": false,
"livemode": false
}Errors
| Status | Code | Meaning |
|---|---|---|
| 400 | parameter_invalid | A parameter has an invalid value. |
| 401 | invalid_api_key | The credential cannot authenticate. |
| 401 | key_revoked | The API key has been revoked. |
| 401 | key_expired | The API key has expired. |
| 403 | scope_missing | The key lacks the required scope. |
| 403 | tier_restricted | The organisation plan does not include this operation. |
| 403 | org_suspended | Your account is suspended. |
| 403 | ip_not_allowed | The caller is outside the key's IP allowlist. |
| 429 | rate_limited | A request or authentication rate limit was exceeded. |
| 503 | dependency_unavailable | Request admission is unavailable. |
| 503 | maintenance | The API is paused for maintenance. |
| 402 | balance_too_low | Your available balance cannot cover the request. |
| 404 | tie_not_found | No tie forecast exists for this fixture. |
| 404 | fixture_not_found | No matching simulation fixture exists. |