> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sx.bet/llms.txt
> Use this file to discover all available pages before exploring further.

# Bet lifecycle

> How a bet's status changes from placement to settlement on SX Bet.

## The states

```mermaid theme={null}
flowchart LR
  P["<b>PENDING</b>"]
  L["<b>LOCKED</b>"]
  S["<b>SETTLED</b>"]
  F["<b>FAILED</b>"]
  P --> L --> S
  P --> F
```

| Status    | Means                                                                    |
| --------- | ------------------------------------------------------------------------ |
| `PENDING` | The matching engine matched you. The on-chain lock is not confirmed yet. |
| `LOCKED`  | Funds are escrowed on chain. **The bet is real and irreversible.**       |
| `SETTLED` | The fixture is graded and the outcome is recorded in `settlement`.       |
| `FAILED`  | The on-chain lock did not succeed. No funds moved.                       |

## Reading `outcome`

| Value | Means            |
| ----- | ---------------- |
| `1`   | Outcome one won. |
| `2`   | Outcome two won. |
| `0`   | **Void.**        |

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](/developers/quarter-line-markets).

## Related

<CardGroup cols={2}>
  <Card title="Order lifecycle" icon="arrow-progress" href="/developers/order-lifecycle">
    The order state machine.
  </Card>

  <Card title="Which grain?" icon="layer-group" href="/developers/which-grain">
    Bet, leg, or position — which endpoint answers your question.
  </Card>
</CardGroup>
