The states
Which status to act on
MATCHED is the matching engine’s word that you are matched. LOCKED means the funds are escrowed
on chain, and nothing revises the bet after that.
V3 has driven on-chain lock failures to effectively zero, and a matched bet going on to LOCKED is
overwhelmingly the norm. However, expect some hiccups in the early days and we cannot provide 100% guarantees at the moment. So choose by what a
revision would cost you:
- I can deal with the occasional revised bet — act on
MATCHED. It arrives well ahead of the lock (couple seconds), and it is what happens in almost every case. - I cannot deal with any revised bet — hedging off-venue, or paying a customer
against it — wait for
LOCKED. It is the only irreversible status.
FAILED, and no funds moved.
Reading outcome
A quarter-line bet needs more care. The parent’s
outcome carries direction only, so outcome
alone does not tell you whether the bet half-won or fully won. See
Quarter-line markets.
Related
Order lifecycle
The order state machine.
Which grain?
Bet, leg, or position — which endpoint answers your question.