triggers.v1.TriggersService
ListTriggerEvents
List trigger events (append-only history). A trigger the caller cannot read (no such trigger, another account's, or one outside the selected sub-account) answers NOT_FOUND, as GetTrigger does. A trigger the caller can read that has no event yet answers an empty list.
Method
POST
Path
triggers.v1.TriggersService/ListTriggerEvents
Service
triggers.v1.TriggersService
Visibility
Authentication
Session token or API key
MFA Requirement
Not required
POST
triggers.v1.TriggersService/ListTriggerEvents Request
Testnet
curl --request POST \ \
--url 'https://api.testnet.polyester.com/triggers.v1.TriggersService/ListTriggerEvents' \
--header 'Content-Type: application/json' \
--header 'Connect-Protocol-Version: 1' \
--data '{
"eventType": "EVENT_FIRED",
"limit": 100,
"pageToken": "eyJvZmZzZXQiOjEwMH0",
"subaccountId": "6789012345678",
"triggerId": "9155001234567"
}'Responses
{
"events": [
{
"cancelReason": "TRIGGER_CANCEL_REASON_USER_REQUEST",
"childOrderId": "9876543210123",
"childSeq": 1,
"eventType": "EVENT_FIRED",
"firePriceTicks": "61000250000000",
"fireRefusalReason": "TRIGGER_FAILURE_REASON_UNKNOWN_SYMBOL",
"subaccountId": "6789012345678",
"symbolId": 1,
"triggerId": "9155001234567",
"triggerType": "STOP_LOSS",
"tsNs": "1735689600000000000"
}
],
"nextPageToken": "eyJvZmZzZXQiOjIwMH0"
}Request
triggers.v1.ListTriggerEventsRequestResponse
triggers.v1.ListTriggerEventsResponse triggerId string (fixed64)
Trigger ID to list events for.
subaccountId string (fixed64)
Optional public subaccount ID. When omitted, subaccount-scoped API keys use their bound subaccount; other callers use their authenticated root account.
limit integer (int32)
Maximum number of events to return. Defaults to 100 when omitted; maximum is 1000.
eventType enum
Optional event category filter. When unspecified, returns all event categories. Use EVENT_FIRED to enumerate child-order actions.
pageToken string
Opaque keyset cursor from a previous response. The cursor is exclusive and bound to the authenticated account, trigger, sub-account scope, event filter, and newest-first sort order.
12 fields
triggerId string (fixed64)
Trigger ID associated with the event.
subaccountId string (fixed64)
Public account or sub-account ID associated with the trigger.
symbolId integer (int32)
Trading symbol numeric identifier.
triggerType enum
Trigger type at the time of the event.
STOP_LOSS TAKE_PROFIT TRAILING_STOP TWAP LADDER
eventType enum
Event category.
EVENT_FIRED EVENT_CANCELED EVENT_UPDATED EVENT_FAILED EVENT_ACTIVATED EVENT_ARMED EVENT_FIRE_REFUSED
tsNs string (uint64)
Event timestamp in nanoseconds since epoch (UTC).
childSeq integer (int32)
Child sequence number for multi-child trigger strategies.
childOrderId string (fixed64)
Child order ID created by this event, if any.
firePriceTicks string (int64)
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 units scaled by 1e9. Absent for time-scheduled triggers such as TWAP.
cancelReason enum
Why an admitted trigger was canceled.
TRIGGER_CANCEL_REASON_USER_REQUEST TRIGGER_CANCEL_REASON_OCO TRIGGER_CANCEL_REASON_PARENT_CANCELED_NO_FILL TRIGGER_CANCEL_REASON_SELF_TRADE_PREVENTION TRIGGER_CANCEL_REASON_ACCOUNT_REPAIR TRIGGER_CANCEL_REASON_PAIR_DRAIN_TRIGGER TRIGGER_CANCEL_REASON_PAIR_DRAIN_TWAP TRIGGER_CANCEL_REASON_PAIR_DRAIN_LADDER TRIGGER_CANCEL_REASON_PAIR_DRAIN_ATTACHED_LEG TRIGGER_CANCEL_REASON_MARKET_HALTED TRIGGER_CANCEL_REASON_MISSING_REASON_CODE TRIGGER_CANCEL_REASON_INTERNAL_ERROR
failureReason enum
Why an admitted trigger failed.
TRIGGER_FAILURE_REASON_UNKNOWN_SYMBOL TRIGGER_FAILURE_REASON_PAIR_DISABLED TRIGGER_FAILURE_REASON_MIN_NOTIONAL TRIGGER_FAILURE_REASON_TICK_SIZE TRIGGER_FAILURE_REASON_INSUFFICIENT_FUNDS TRIGGER_FAILURE_REASON_RISK_LIMIT TRIGGER_FAILURE_REASON_DUPLICATE_CLIENT_ID TRIGGER_FAILURE_REASON_MARKET_HALTED TRIGGER_FAILURE_REASON_ENGINE_BUSY TRIGGER_FAILURE_REASON_ACCOUNT_UNKNOWN TRIGGER_FAILURE_REASON_ORDER_UNKNOWN TRIGGER_FAILURE_REASON_POST_ONLY_CROSS TRIGGER_FAILURE_REASON_REDUCE_ONLY_BLOCKED TRIGGER_FAILURE_REASON_PRICE_BAND_VIOLATION TRIGGER_FAILURE_REASON_MARKET_CAP_VIOLATION TRIGGER_FAILURE_REASON_EMPTY_BOOK TRIGGER_FAILURE_REASON_FOK_INSUFFICIENT_LIQUIDITY TRIGGER_FAILURE_REASON_FEE_ASSET_NOT_ALLOWED TRIGGER_FAILURE_REASON_MARKET_PRICE_UNAVAILABLE TRIGGER_FAILURE_REASON_STALE_QUOTE TRIGGER_FAILURE_REASON_MIN_QUANTITY TRIGGER_FAILURE_REASON_STEP_SIZE TRIGGER_FAILURE_REASON_INVALID_SIZING TRIGGER_FAILURE_REASON_MAX_QUOTE_DEBIT_TOO_SMALL TRIGGER_FAILURE_REASON_FEE_CEILING_EXCEEDED TRIGGER_FAILURE_REASON_INVALID_TIME_IN_FORCE TRIGGER_FAILURE_REASON_TRIGGER_PRICE_INVALID TRIGGER_FAILURE_REASON_TRIGGER_PRICE_SOURCE_UNSUPPORTED TRIGGER_FAILURE_REASON_TRAILING_DISTANCE_INVALID TRIGGER_FAILURE_REASON_MODIFICATION_REQUIRES_REPLACE TRIGGER_FAILURE_REASON_ORDER_ALREADY_TERMINAL TRIGGER_FAILURE_REASON_CONFLICT_IDEMPOTENCY_KEY_REUSE TRIGGER_FAILURE_REASON_RATE_LIMITED TRIGGER_FAILURE_REASON_POLICY_SPOT_TRADE_DENY TRIGGER_FAILURE_REASON_POLICY_MARKET_DENY TRIGGER_FAILURE_REASON_POLICY_MAX_NOTIONAL TRIGGER_FAILURE_REASON_POLICY_MAX_OPEN_ORDERS TRIGGER_FAILURE_REASON_POLICY_TRADING_HALTED TRIGGER_FAILURE_REASON_MAX_SLIPPAGE_INVALID TRIGGER_FAILURE_REASON_DUPLICATE_ORDER_ID TRIGGER_FAILURE_REASON_MAX_QUANTITY TRIGGER_FAILURE_REASON_MAX_NOTIONAL TRIGGER_FAILURE_REASON_PAIR_POST_ONLY TRIGGER_FAILURE_REASON_MAX_OPEN_ORDERS_TOTAL TRIGGER_FAILURE_REASON_MAX_OPEN_ORDERS_PER_PAIR TRIGGER_FAILURE_REASON_STP_MODE_NOT_ALLOWED TRIGGER_FAILURE_REASON_PAIR_BACKLOGGED TRIGGER_FAILURE_REASON_MODE_NOT_SUPPORTED TRIGGER_FAILURE_REASON_MARKET_QUOTE_STALE TRIGGER_FAILURE_REASON_MARKET_QUOTE_UNHEALTHY TRIGGER_FAILURE_REASON_QTY_INVALID TRIGGER_FAILURE_REASON_LIMIT_PRICE_INVALID TRIGGER_FAILURE_REASON_TWAP_INTERVAL_INVALID TRIGGER_FAILURE_REASON_LADDER_RANGE_TOO_NARROW TRIGGER_FAILURE_REASON_LADDER_LEVELS_INVALID TRIGGER_FAILURE_REASON_ATTACHED_LEGS_EXCEEDED TRIGGER_FAILURE_REASON_PRICE_LEVELS_EXHAUSTED TRIGGER_FAILURE_REASON_SETTLEMENT_BACKLOGGED TRIGGER_FAILURE_REASON_CLIENT_ORDER_IDS_EXHAUSTED TRIGGER_FAILURE_REASON_INVALID_ORDER_ID TRIGGER_FAILURE_REASON_ORDER_ID_CONFLICT TRIGGER_FAILURE_REASON_INVALID_SIDE TRIGGER_FAILURE_REASON_INVALID_ORDER_TYPE TRIGGER_FAILURE_REASON_INVALID_STP_MODE TRIGGER_FAILURE_REASON_INVALID_ORDER_FLAGS TRIGGER_FAILURE_REASON_PRICE_LEVEL_QUANTITY_LIMIT TRIGGER_FAILURE_REASON_CHILD_QTY_RAISE_NOT_ALLOWED TRIGGER_FAILURE_REASON_TRIGGERS_EXHAUSTED TRIGGER_FAILURE_REASON_ORDER_SEQUENCE_EXHAUSTED TRIGGER_FAILURE_REASON_FEE_SCHEDULE_UNAVAILABLE TRIGGER_FAILURE_REASON_POLICY_UNAVAILABLE TRIGGER_FAILURE_REASON_ACCOUNT_ROUTING_INVALID TRIGGER_FAILURE_REASON_CLIENT_TRIGGER_ID_INVALID TRIGGER_FAILURE_REASON_TRIGGER_DIRECTION_INVALID TRIGGER_FAILURE_REASON_FEE_ASSET_INVALID TRIGGER_FAILURE_REASON_FEE_CEILING_INVALID TRIGGER_FAILURE_REASON_UNSUPPORTED_FIELD_SET TRIGGER_FAILURE_REASON_TRIGGER_FIRE_LIMIT_REACHED TRIGGER_FAILURE_REASON_CONDITION_FLAGS_INVALID TRIGGER_FAILURE_REASON_CONDITION_PARAMETER_SET TRIGGER_FAILURE_REASON_SLIPPAGE_TICKS_INVALID TRIGGER_FAILURE_REASON_SLIPPAGE_BPS_INVALID TRIGGER_FAILURE_REASON_SLIPPAGE_BOUNDS_CONFLICT TRIGGER_FAILURE_REASON_LIMIT_CHILD_SLIPPAGE_SET TRIGGER_FAILURE_REASON_NEW_ACCOUNT_CAPACITY_REACHED TRIGGER_FAILURE_REASON_ORDER_TYPE_NOT_ALLOWED_IN_AUCTION TRIGGER_FAILURE_REASON_POST_ONLY_NOT_ALLOWED_IN_AUCTION TRIGGER_FAILURE_REASON_TWAP_CAPACITY_REACHED TRIGGER_FAILURE_REASON_CHILD_ORDER_INCONSISTENT TRIGGER_FAILURE_REASON_ORDER_LIMITS_UNAVAILABLE TRIGGER_FAILURE_REASON_ACCOUNT_REPAIRING TRIGGER_FAILURE_REASON_INDEX_PRICE_UNAVAILABLE TRIGGER_FAILURE_REASON_TRIGGER_WOULD_TRIGGER_IMMEDIATELY TRIGGER_FAILURE_REASON_SELF_TRADE_PREVENTED TRIGGER_FAILURE_REASON_MISSING_REASON_CODE TRIGGER_FAILURE_REASON_INTERNAL_ERROR
fireRefusalReason enum
Why the attempt named by child_seq was refused while the trigger stayed live. Set only on EVENT_FIRE_REFUSED; other event types leave it unset.
TRIGGER_FAILURE_REASON_UNKNOWN_SYMBOL TRIGGER_FAILURE_REASON_PAIR_DISABLED TRIGGER_FAILURE_REASON_MIN_NOTIONAL TRIGGER_FAILURE_REASON_TICK_SIZE TRIGGER_FAILURE_REASON_INSUFFICIENT_FUNDS TRIGGER_FAILURE_REASON_RISK_LIMIT TRIGGER_FAILURE_REASON_DUPLICATE_CLIENT_ID TRIGGER_FAILURE_REASON_MARKET_HALTED TRIGGER_FAILURE_REASON_ENGINE_BUSY TRIGGER_FAILURE_REASON_ACCOUNT_UNKNOWN TRIGGER_FAILURE_REASON_ORDER_UNKNOWN TRIGGER_FAILURE_REASON_POST_ONLY_CROSS TRIGGER_FAILURE_REASON_REDUCE_ONLY_BLOCKED TRIGGER_FAILURE_REASON_PRICE_BAND_VIOLATION TRIGGER_FAILURE_REASON_MARKET_CAP_VIOLATION TRIGGER_FAILURE_REASON_EMPTY_BOOK TRIGGER_FAILURE_REASON_FOK_INSUFFICIENT_LIQUIDITY TRIGGER_FAILURE_REASON_FEE_ASSET_NOT_ALLOWED TRIGGER_FAILURE_REASON_MARKET_PRICE_UNAVAILABLE TRIGGER_FAILURE_REASON_STALE_QUOTE TRIGGER_FAILURE_REASON_MIN_QUANTITY TRIGGER_FAILURE_REASON_STEP_SIZE TRIGGER_FAILURE_REASON_INVALID_SIZING TRIGGER_FAILURE_REASON_MAX_QUOTE_DEBIT_TOO_SMALL TRIGGER_FAILURE_REASON_FEE_CEILING_EXCEEDED TRIGGER_FAILURE_REASON_INVALID_TIME_IN_FORCE TRIGGER_FAILURE_REASON_TRIGGER_PRICE_INVALID TRIGGER_FAILURE_REASON_TRIGGER_PRICE_SOURCE_UNSUPPORTED TRIGGER_FAILURE_REASON_TRAILING_DISTANCE_INVALID TRIGGER_FAILURE_REASON_MODIFICATION_REQUIRES_REPLACE TRIGGER_FAILURE_REASON_ORDER_ALREADY_TERMINAL TRIGGER_FAILURE_REASON_CONFLICT_IDEMPOTENCY_KEY_REUSE TRIGGER_FAILURE_REASON_RATE_LIMITED TRIGGER_FAILURE_REASON_POLICY_SPOT_TRADE_DENY TRIGGER_FAILURE_REASON_POLICY_MARKET_DENY TRIGGER_FAILURE_REASON_POLICY_MAX_NOTIONAL TRIGGER_FAILURE_REASON_POLICY_MAX_OPEN_ORDERS TRIGGER_FAILURE_REASON_POLICY_TRADING_HALTED TRIGGER_FAILURE_REASON_MAX_SLIPPAGE_INVALID TRIGGER_FAILURE_REASON_DUPLICATE_ORDER_ID TRIGGER_FAILURE_REASON_MAX_QUANTITY TRIGGER_FAILURE_REASON_MAX_NOTIONAL TRIGGER_FAILURE_REASON_PAIR_POST_ONLY TRIGGER_FAILURE_REASON_MAX_OPEN_ORDERS_TOTAL TRIGGER_FAILURE_REASON_MAX_OPEN_ORDERS_PER_PAIR TRIGGER_FAILURE_REASON_STP_MODE_NOT_ALLOWED TRIGGER_FAILURE_REASON_PAIR_BACKLOGGED TRIGGER_FAILURE_REASON_MODE_NOT_SUPPORTED TRIGGER_FAILURE_REASON_MARKET_QUOTE_STALE TRIGGER_FAILURE_REASON_MARKET_QUOTE_UNHEALTHY TRIGGER_FAILURE_REASON_QTY_INVALID TRIGGER_FAILURE_REASON_LIMIT_PRICE_INVALID TRIGGER_FAILURE_REASON_TWAP_INTERVAL_INVALID TRIGGER_FAILURE_REASON_LADDER_RANGE_TOO_NARROW TRIGGER_FAILURE_REASON_LADDER_LEVELS_INVALID TRIGGER_FAILURE_REASON_ATTACHED_LEGS_EXCEEDED TRIGGER_FAILURE_REASON_PRICE_LEVELS_EXHAUSTED TRIGGER_FAILURE_REASON_SETTLEMENT_BACKLOGGED TRIGGER_FAILURE_REASON_CLIENT_ORDER_IDS_EXHAUSTED TRIGGER_FAILURE_REASON_INVALID_ORDER_ID TRIGGER_FAILURE_REASON_ORDER_ID_CONFLICT TRIGGER_FAILURE_REASON_INVALID_SIDE TRIGGER_FAILURE_REASON_INVALID_ORDER_TYPE TRIGGER_FAILURE_REASON_INVALID_STP_MODE TRIGGER_FAILURE_REASON_INVALID_ORDER_FLAGS TRIGGER_FAILURE_REASON_PRICE_LEVEL_QUANTITY_LIMIT TRIGGER_FAILURE_REASON_CHILD_QTY_RAISE_NOT_ALLOWED TRIGGER_FAILURE_REASON_TRIGGERS_EXHAUSTED TRIGGER_FAILURE_REASON_ORDER_SEQUENCE_EXHAUSTED TRIGGER_FAILURE_REASON_FEE_SCHEDULE_UNAVAILABLE TRIGGER_FAILURE_REASON_POLICY_UNAVAILABLE TRIGGER_FAILURE_REASON_ACCOUNT_ROUTING_INVALID TRIGGER_FAILURE_REASON_CLIENT_TRIGGER_ID_INVALID TRIGGER_FAILURE_REASON_TRIGGER_DIRECTION_INVALID TRIGGER_FAILURE_REASON_FEE_ASSET_INVALID TRIGGER_FAILURE_REASON_FEE_CEILING_INVALID TRIGGER_FAILURE_REASON_UNSUPPORTED_FIELD_SET TRIGGER_FAILURE_REASON_TRIGGER_FIRE_LIMIT_REACHED TRIGGER_FAILURE_REASON_CONDITION_FLAGS_INVALID TRIGGER_FAILURE_REASON_CONDITION_PARAMETER_SET TRIGGER_FAILURE_REASON_SLIPPAGE_TICKS_INVALID TRIGGER_FAILURE_REASON_SLIPPAGE_BPS_INVALID TRIGGER_FAILURE_REASON_SLIPPAGE_BOUNDS_CONFLICT TRIGGER_FAILURE_REASON_LIMIT_CHILD_SLIPPAGE_SET TRIGGER_FAILURE_REASON_NEW_ACCOUNT_CAPACITY_REACHED TRIGGER_FAILURE_REASON_ORDER_TYPE_NOT_ALLOWED_IN_AUCTION TRIGGER_FAILURE_REASON_POST_ONLY_NOT_ALLOWED_IN_AUCTION TRIGGER_FAILURE_REASON_TWAP_CAPACITY_REACHED TRIGGER_FAILURE_REASON_CHILD_ORDER_INCONSISTENT TRIGGER_FAILURE_REASON_ORDER_LIMITS_UNAVAILABLE TRIGGER_FAILURE_REASON_ACCOUNT_REPAIRING TRIGGER_FAILURE_REASON_INDEX_PRICE_UNAVAILABLE TRIGGER_FAILURE_REASON_TRIGGER_WOULD_TRIGGER_IMMEDIATELY TRIGGER_FAILURE_REASON_SELF_TRADE_PREVENTED TRIGGER_FAILURE_REASON_MISSING_REASON_CODE TRIGGER_FAILURE_REASON_INTERNAL_ERROR
nextPageToken string
Opaque cursor for the next page. Empty when no more results exist.
| Key | HTTP status | Connect code | Error | When |
|---|---|---|---|---|
| unauthenticated | 401 | unauthenticated | Unauthenticated | Authentication required. |
| permission-denied | 403 | permission_denied | Permission Denied | Permission denied. |
| invalid-argument | 400 | invalid_argument | Invalid Argument | Invalid argument. |
| not-found | 404 | not_found | Not Found | Not found. |
| unavailable | 503 | unavailable | Unavailable | Service unavailable. |