Time in Force

Time in force (TIF) determines how long an order remains eligible for execution. This page explains the TIF values Dinari's APIs accept and how they behave in production.

For order types and required fields, see Order Types. For session-specific behavior, see Market Hours & Weekend Orders.

Supported values

The order_tif enum accepts four values:

`order_tif`	Meaning
`DAY`	Active until the end of the trading day. Default.
`GTC`	Good 'til cancelled.
`IOC`	Immediate or cancel.
`FOK`	Fill or kill.

Use DAY

DAY is the default and the recommended value for all order flow.

On the Managed and Proxied (EIP-155) order APIs, order_tif defaults to DAY.
In Dinari's hosted trading UI, the TIF selector also defaults to DAY.

Market orders are designed to clear promptly rather than rest on a book, so DAY is the appropriate setting for the large majority of integrations.

⚠️
Downstream behavior
Dinari's order book accepts all four TIF values, but the fulfilling brokerage effectively treats orders as DAY. End-to-end honoring of GTC, IOC, and FOK is not guaranteed. Use DAY unless Dinari has explicitly confirmed alternative TIF behavior for your integration.

TIF and trading sessions

TIF is interpreted relative to trading sessions, not wall-clock time. A DAY order placed outside regular market hours — for example, over the weekend — remains eligible through the next trading session. In practice, a DAY order placed on a Saturday means "by the end of the next trading day."

See Market Hours & Weekend Orders for how each session handles resting orders.

API reference

order_tif is set on order creation. On the Managed order endpoints it defaults to DAY when omitted. On the Proxied (EIP-155) endpoints it is a required field in Eip155OrderRequestPermitInput.

resp = client.v2.accounts.order_requests.eip155.create_permit(
    account_id,
    chain_id="eip155:11155111",
    order_side="BUY",
    order_tif="DAY",       # default and recommended value
    order_type="LIMIT",
    limit_price=150.0,
    asset_token_quantity=1,
    payment_token="0x...",
    stock_id=stock_id,
)

The order_tif of a placed order is returned by Get Order by ID:

GET /api/v2/accounts/{account_id}/orders/{order_id}