Market States

Market state tells users what can happen next. It should be visible anywhere a user might trade, review a position, or inspect market history.

State before price A price is only useful if the market state allows the action the user wants to take. Closed, suspended, or pending-settlement markets should not accept new orders even if historical prices are still visible.

Common states

StateMeaning
UpcomingThe event has not started or the market is not live yet. Orders may be unavailable depending on market state.
OpenThe market is accepting orders. Users should still review spread, liquidity, and estimated payout.
LiveThe event is in progress and prices may move quickly. Live markets can be paused or closed by state changes.
SuspendedNew orders are temporarily blocked. This can happen during feed delays, market review, or risk controls.
ClosedNew orders are not accepted. The event may still be awaiting final settlement.
Pending settlementThe winning outcome is being finalized or settlement accounting is still processing.
SettledThe final outcome has been applied and user positions are closed.

Lifecycle

Most markets move through this lifecycle:

StepStateWhat users can expect
1UpcomingThe market can be browsed or followed. Trading may not be available yet.
2OpenOrders can be previewed and submitted while the selected outcome remains tradeable.
3LiveThe event is in progress. Prices and availability can change quickly.
4ClosedNew orders are blocked. Existing positions remain visible.
5Pending settlementFinal-looking prices may appear, but balance crediting is not complete yet.
6SettledFinal P&L is applied, demo/live accounting is complete, and the position moves to history.

Some markets skip a state. For example, a non-sports market may never be live, and a canceled market can move directly from open or closed to a special correction flow.

Why a market can stop accepting orders

A market can become unavailable because:

  • The event ended or reached a cutoff.
  • The market closed.
  • A live feed became unreliable.
  • Liquidity was unavailable.
  • A market rule or compliance review is required.
  • The market was canceled, corrected, or merged.

User actions by state

StateNew tradesOpen positionsBalance updates
UpcomingNot guaranteedNot applicable unless trading opened earlyNo settlement update
OpenAllowed if quote and outcome are validMarked to current pricesNo settlement update
LiveAllowed only while the market remains tradeableMarked to live pricesNo settlement update
SuspendedBlockedPositions remain visibleNo settlement update
ClosedBlockedPositions wait for finalizationNo settlement update
Pending settlementBlockedEstimated final P&L may displayBalance updates after accounting succeeds
SettledBlockedPosition appears in historyFinal payout or loss is applied

User-facing expectation

If a market is unavailable, Pariflow should prefer a clear inactive state over a trade form that appears active but rejects orders late. Rejections should explain the reason when possible.

When balance updates Balance should update after settlement accounting succeeds, not merely because a chart reached 100c or 0c.