Time in force

Every order carries a required timeInForce. It decides how your order behaves in the order book.

`timeInForce`	Unmatched size	Use it for
`GTC` — good till cancelled	Rests on the book until filled, cancelled, or expired	Quoting. Providing liquidity.
`IOC` — immediate or cancel	Discarded. Whatever matched is yours	Taking what is available now, accepting a partial fill.
`FOK` — fill or kill	Nothing executes. The whole order is cancelled unless it fills completely	All-or-nothing execution. The only way to take parlay liquidity.

A GTC order can still be a taker. If it crosses the book on arrival it matches immediately, and only the remainder rests.

Which one to use

You want to	Use
Quote a two-sided market and get filled over time	`GTC`
Bet at the best available price, taking whatever size is there	`IOC`
Bet a specific amount or nothing	`FOK`
Take a parlay	`FOK` (`IOC` is rejected with `PARLAY_ORDER_MUST_NOT_BE_IOC`)
Provide parlay liquidity	`GTC`, with a real `expiry` no later than the parlay’s
Use bet credits	`IOC` or `FOK` (a resting bet-credit order is rejected with `BET_CREDITS_REQUIRE_NON_RESTING`)

Build, sign and submit an order of any type.

The immediate-execution path, end to end.

PENDING, ACTIVE, INACTIVE, and every terminal reason.

timeInForce is write-only — tag it in your own store when you post.

Last modified on August 11, 2026