trading
Trigger events
Authenticated spot trigger activation, fire, update, cancellation, and failure events for one root account or subaccount. Each publication is an ordered array of every event queued for the channel when it was sent, at most 256 events and 64 KiB: {"events":[…]} in JSON and triggers.v1.TriggerEventBatch in protobuf. Apply events in array order and in publication order. (triggerId, eventType, childSeq, tsNs) identifies an event: an event whose identity was already received replaces the earlier copy, so a replayed or re-sent event is applied once. When the subscription reports that missed publications could not be recovered, reload recent trigger events over REST.
Channel
private:spot:triggers:events:{accountPublicId} {
"type": "subscribe",
"channel": "private:spot:triggers:events:6MSXSqCnTZa"
}Channel parameters
Public root account or subaccount identifier authorized by the subscription token.
e.g. 6MSXSqCnTZaMessage
JSON objectTriggerCancelReason enum name. Present only for EVENT_CANCELED.
Public identifier of the child order created by this event. Omitted when no child was created.
KjYLZQiF6xxChild sequence number for multi-child trigger strategies. Zero when not applicable.
1Event category: EVENT_ACTIVATED, EVENT_ARMED, EVENT_FIRED, EVENT_FIRE_REFUSED, EVENT_CANCELED, EVENT_UPDATED, or EVENT_FAILED.
EVENT_FIREDTriggerFailureReason enum name. Present only for EVENT_FAILED.
Price that fired the trigger: for a stop-loss or take-profit, the price that crossed its trigger price; for a trailing stop, its trailing trigger threshold when it fired; for a ladder, the level's price. A market child order's slippage cap is measured from it. In quote-asset units as a decimal string with up to nine fractional digits. Zero for non-firing events, including EVENT_ACTIVATED and EVENT_ARMED. For EVENT_FIRE_REFUSED, the price the refused attempt fired at.
101.25TriggerFailureReason enum name of the refused attempt named by childSeq. Present only for EVENT_FIRE_REFUSED, which leaves the trigger live.
Public root-account or subaccount identifier associated with the trigger.
6MSXSqCnTZaSpot trading pair symbol of the trigger, for example BTC-USDT.
BTC-USDTPublic trigger identifier.
92fHfkJgBqrTrigger type: STOP_LOSS, TAKE_PROFIT, TRAILING_STOP, TWAP, or LADDER.
STOP_LOSSEvent time in Unix nanoseconds (UTC), encoded as an exact decimal string.
1767225600123456789