Order Lifecycle
How orders move from creation to settlement.
Every trade on Doji follows a specific lifecycle. Orders are created off-chain, matched by an operator, and settled on-chain through smart contracts. This hybrid approach combines the speed of centralized matching with the security of blockchain settlement.
Create & Sign
When you submit a trade, Doji creates a structured order containing your market, side (Yes/No), price, and size. Your wallet signs this order cryptographically — this signature authorizes the Exchange contract to execute the trade on your behalf without ever taking custody of your funds.
Submit to CLOB
The signed order is submitted to the Polymarket CLOB operator, which validates your signature, balance, and allowances.
Match or Rest
If your order is marketable (your buy price ≥ lowest ask, or your sell price ≤ highest bid), it matches immediately against resting orders. If not, it rests on the orderbook waiting for a counterparty until filled, cancelled, or expired.
Settlement
When orders match, the trade is submitted to the blockchain. The Exchange contract verifies both signatures and atomically transfers tokens and USDC.e between buyer and seller — either the entire trade succeeds or nothing happens.
Confirmation
The trade achieves finality on Polygon. Your token balances update and the trade appears in your Portfolio history.
Order Statuses
| Status | Description |
|---|---|
| Live | Order is resting on the orderbook |
| Matched | Order matched immediately |
| Delayed | Marketable order subject to a 3-second delay (sports markets) |
Maker vs. Taker
| Role | Description |
|---|---|
| Maker | Your order rests on the book and is later matched — you add liquidity |
| Taker | Your order matches immediately against resting orders — you remove liquidity |
Price improvement benefits the taker. If you place a buy at $0.55 and it matches a resting sell at $0.52, you pay $0.52.
Cancellation
You can cancel any unfilled order at any time. If an order has been partially filled, only the remaining unfilled portion can be cancelled — the filled part is final.
Your available balance decreases as you place open orders. The maximum size for a new order is your balance minus the amounts reserved by existing open orders.