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?