For the complete documentation index, see llms.txt. This page is also available as Markdown.

Bet Status Lifecycle

Suspended alone cannot tell you when to permanently remove a bet from your UI. It is normal for a bet to suspend and resume several times during a fixture. The BetStatusId field adds a fourth value, Closed, that gives you a reliable removal signal for that bet.

State Machine

A bet moves through these states:

Open (1) ⟷ Suspended (2) ⟷ Closed (4) → Settled (3)

Status

Will it reopen?

UI guidance

Open

N/A

Show the bet, enable betting

Suspended

Very likely

Show the bet, disable betting

Closed

Rarely

Remove the bet from your UI

Settled

No

Show the result

Closed applies to the bet, not to the market. Treat it as final and remove the bet from your UI. In rare cases a provider can revert it.

Status and BetStatusId share the same enumeration, with one difference: Status does not carry Closed. When a bet closes, Status reports Suspended (2) instead, so only BetStatusId gives you the removal signal.

What a Closed Bet Looks Like

In an outright market, an eliminated participant arrives with BetStatusId set to Closed (4), while Status falls back to Suspended (2):

{
  "Id": "213192246116247002",
  "Name": "Global Agenda",
  "Status": 2,
  "BetStatusId": 4,
  "Price": "15",
  "ProviderBetId": "0",
  "LastUpdate": "2026-07-20T23:27:48.7569313Z",
  "ParticipantId": 53894728
}

Scope

TRADE sends BetStatusId=Closed whenever a bet permanently closes. In outright markets, for example, individual bets close one at a time as participants are eliminated — such as a team eliminated from a "World Cup Winner" market — while the market itself stays relevant until the tournament resolves. Market-level MarketStatus does not have a Closed value.

Migration

BetStatusId is delivered alongside the existing Status field, so current integrations keep working without changes. Status will be deprecated on 1 March 2027. Migrate your display and removal logic to BetStatusId before then.

See Bet Settlements & Statuses for the full enumeration, and Market / Settlement for where the field appears on the wire.

Last updated

Was this helpful?