Time in Force

Control how long an order remains active.

Value	Name	Description
day	Day Order	Expires at end of trading day
gtc	Good Til Cancelled	Remains active until filled or cancelled
gtd	Good Til Date	Remains active until specified date
opg	Market on Open	Executes at market open
cls	Market on Close	Executes at market close (MOC)
ioc	Immediate or Cancel	Fill immediately or cancel
fok	Fill or Kill	Fill entirely immediately or cancel

Examples

Day Order (Default)

{
  "timeInForce": "day"
}

Good Til Cancelled

{
  "timeInForce": "gtc"
}

Market on Close

{
  "timeInForce": "cls"
}

Good Til Date

gtd keeps the order live until a specific moment, then cancels it. Pair timeInForce: "gtd" with expiresAt and a timezone.

{
  "timeInForce": "gtd",
  "expiresAt": "2026-08-15T16:00:00",
  "timezone": "America/New_York"
}

Validation rules on the create and update signal endpoints:

• expiresAt is required when timeInForce is gtd, and only valid in that case.
• timezone is required when expiresAt is supplied.
• expiresAt must be in the future when interpreted in the supplied timezone.
• expiresAt must be within 90 days from now.

How gtd is enforced depends on whether the broker supports a native GTD time-in-force on order submit. UTM picks the path automatically and records which one ran on the Order.gtdMode field so callers can detect the reliability difference without having to know broker-by-broker behaviour.

Broker	GTD mode	Resilience to UTM outage at expiry
TradeStation	Broker-native	Broker cancels the order at expiresAt even if UTM is down.
Alpaca	UTM-emulated	UTM submits as gtc and schedules a server-side cancel. If UTM is down at the expiry moment, the cancel does not fire.
Interactive Brokers	UTM-emulated	The desktop bridge does not yet forward native GTD, so IB falls back to the same emulated path Alpaca uses.

The caller-facing contract is the same regardless of mode: Order.timeInForce keeps the original gtd value and Order.expiresAt carries the requested expiry. On the emulated path UTM also writes Order.gtdCancellationJobId referencing the queued cancel; on the native path that field stays null.

Order.gtdMode

Order.gtdMode is set by UTM at order-submit time. It can take one of:

• "broker" - the broker accepted a native GTD time-in-force with an explicit expiry. The broker cancels at expiry regardless of UTM uptime.
• "emulated" - UTM submitted the order as gtc and scheduled a server-side cancel at expiresAt. UTM must be up at the expiry moment for the cancel to fire.
• null - the order is not gtd, so the field is not applicable.

The signal-create response does not carry gtdMode; the mode is determined when the order is placed at the broker, not when the signal is created. Callers that need the mode should read it from the order detail endpoint.

Broker submission cutoffs for CLS

cls orders must reach the broker before its submission cutoff. Orders submitted past the cutoff are rejected. Cutoffs are expressed as minutes before market close so they apply correctly on short trading days (e.g. half-day Thanksgiving session) without special handling.

Broker	CLS cutoff (minutes before close)	Regular session ET equivalent
Alpaca	10	3:50 PM
TradeStation	10	3:50 PM
Interactive Brokers	15	3:45 PM

Alpaca additionally requires cls orders to be submitted after 7:00 PM ET on the prior session — that is broker-side window opening behaviour, separate from the UTM cutoff guard described below.

UTM auto-close safety behaviour

When the strategy auto-close feature submits a cls order, UTM checks two things before sending:

1. Account type. Paper accounts always receive day instead of cls. Paper trading endpoints do not handle the closing auction reliably, so UTM submits a plain market order at the scheduled fire time. Paper users should expect this and use the fill price recorded against the order, not a closing-auction print, when comparing test results.
2. Broker cutoff. For live accounts, if the fire time is at or after the broker's CLS cutoff (see table above), UTM downgrades the order from cls to day. The order then fills against the order book at close rather than being rejected.

This applies to auto-close orders only. Signals submitted manually or via webhook are sent with whatever timeInForce the caller specifies and must meet broker submission windows independently.

To stay clear of the cutoff on live accounts, configure autoCloseMinutesBefore on your strategy with at least 15 minutes of buffer. The 15-minute floor exists because it sits at or above every supported broker's CLS cutoff. The default is 30 minutes, which gives adequate margin for all supported brokers.