TriggersService

List Trigger Events

List append-only trigger events for a trigger, including child-order actions, with optional event-category filtering and reverse-time pagination. A trigger the caller can read that has no event yet answers an empty list.

Method

GET

Path

/v1/triggers/{trigger_id}/events

Visibility

Authentication required

Authentication

Session token or API key

MFA Requirement

Not required

GET

/v1/triggers/{trigger_id}/events

Request

Testnet

curl --request GET \ \
  --url 'https://api.testnet.polyester.com/v1/triggers/59VD7Lar/events?eventType=FIRED&limit=100&subaccountId=45LUmqjT' \
  --header 'Accept: */*' \
  --header 'X-API-KEY-ID: YOUR_API_KEY_ID' \
  --header 'X-API-TIMESTAMP: YOUR_API_TIMESTAMP' \
  --header 'X-API-SIGNATURE: YOUR_API_SIGNATURE'

Responses

{
  "events": [
    {
      "cancelReason": "USER_REQUEST",
      "childOrderId": "5USXJZmk",
      "childSeq": 1,
      "eventType": "FIRED",
      "firePx": "61000.25",
      "fireRefusalReason": "UNKNOWN_SYMBOL",
      "subaccountId": "45LUmqjT",
      "symbol": "BTC-USDT",
      "triggerId": "59VD7Lar",
      "triggerType": "STOP_LOSS",
      "tsNs": "1735689600000000000"
    }
  ],
  "nextPageToken": "eyJvZmZzZXQiOjIwMH0"
}

trigger_id string required > 0

eventType enum must be defined value

Optional TriggerEventType enum name, for example FIRED. Omit to return all events.

limit integer ≤ 1000

pageToken string max 512 chars

Opaque keyset cursor returned by the previous response.

subaccountId string /^[1-9A…m-z]+$/

12 fields

cancelReason enum

Why an admitted trigger was canceled.

USER_REQUEST OCO PARENT_CANCELED_NO_FILL SELF_TRADE_PREVENTION ACCOUNT_REPAIR PAIR_DRAIN_TRIGGER PAIR_DRAIN_TWAP PAIR_DRAIN_LADDER PAIR_DRAIN_ATTACHED_LEG MARKET_HALTED MISSING_REASON_CODE INTERNAL_ERROR

Example USER_REQUEST

childOrderId string /^[1-9A…m-z]+$/

Child order ID created by this event, if any.

Example 5USXJZmk

childSeq integer (int32)

Child sequence number for multi-child trigger strategies.

Example 1

eventType enum

Event category.

FIRED CANCELED UPDATED FAILED ACTIVATED ARMED FIRE_REFUSED

Example FIRED

failureReason enum

Why an admitted trigger failed.

UNKNOWN_SYMBOL PAIR_DISABLED MIN_NOTIONAL TICK_SIZE INSUFFICIENT_FUNDS RISK_LIMIT DUPLICATE_CLIENT_ID MARKET_HALTED ENGINE_BUSY ACCOUNT_UNKNOWN ORDER_UNKNOWN POST_ONLY_CROSS REDUCE_ONLY_BLOCKED PRICE_BAND_VIOLATION MARKET_CAP_VIOLATION EMPTY_BOOK FOK_INSUFFICIENT_LIQUIDITY FEE_ASSET_NOT_ALLOWED MARKET_PRICE_UNAVAILABLE STALE_QUOTE MIN_QUANTITY STEP_SIZE INVALID_SIZING MAX_QUOTE_DEBIT_TOO_SMALL FEE_CEILING_EXCEEDED INVALID_TIME_IN_FORCE TRIGGER_PRICE_INVALID TRIGGER_PRICE_SOURCE_UNSUPPORTED TRAILING_DISTANCE_INVALID MODIFICATION_REQUIRES_REPLACE ORDER_ALREADY_TERMINAL CONFLICT_IDEMPOTENCY_KEY_REUSE RATE_LIMITED POLICY_SPOT_TRADE_DENY POLICY_MARKET_DENY POLICY_MAX_NOTIONAL POLICY_MAX_OPEN_ORDERS POLICY_TRADING_HALTED MAX_SLIPPAGE_INVALID DUPLICATE_ORDER_ID MAX_QUANTITY MAX_NOTIONAL PAIR_POST_ONLY MAX_OPEN_ORDERS_TOTAL MAX_OPEN_ORDERS_PER_PAIR STP_MODE_NOT_ALLOWED PAIR_BACKLOGGED MODE_NOT_SUPPORTED MARKET_QUOTE_STALE MARKET_QUOTE_UNHEALTHY QTY_INVALID LIMIT_PRICE_INVALID TWAP_INTERVAL_INVALID LADDER_RANGE_TOO_NARROW LADDER_LEVELS_INVALID ATTACHED_LEGS_EXCEEDED PRICE_LEVELS_EXHAUSTED SETTLEMENT_BACKLOGGED CLIENT_ORDER_IDS_EXHAUSTED INVALID_ORDER_ID ORDER_ID_CONFLICT INVALID_SIDE INVALID_ORDER_TYPE INVALID_STP_MODE INVALID_ORDER_FLAGS PRICE_LEVEL_QUANTITY_LIMIT CHILD_QTY_RAISE_NOT_ALLOWED TRIGGERS_EXHAUSTED ORDER_SEQUENCE_EXHAUSTED FEE_SCHEDULE_UNAVAILABLE POLICY_UNAVAILABLE ACCOUNT_ROUTING_INVALID CLIENT_TRIGGER_ID_INVALID TRIGGER_DIRECTION_INVALID FEE_ASSET_INVALID FEE_CEILING_INVALID UNSUPPORTED_FIELD_SET TRIGGER_FIRE_LIMIT_REACHED CONDITION_FLAGS_INVALID CONDITION_PARAMETER_SET SLIPPAGE_TICKS_INVALID SLIPPAGE_BPS_INVALID SLIPPAGE_BOUNDS_CONFLICT LIMIT_CHILD_SLIPPAGE_SET NEW_ACCOUNT_CAPACITY_REACHED ORDER_TYPE_NOT_ALLOWED_IN_AUCTION POST_ONLY_NOT_ALLOWED_IN_AUCTION TWAP_CAPACITY_REACHED CHILD_ORDER_INCONSISTENT ORDER_LIMITS_UNAVAILABLE ACCOUNT_REPAIRING INDEX_PRICE_UNAVAILABLE TRIGGER_WOULD_TRIGGER_IMMEDIATELY SELF_TRADE_PREVENTED MISSING_REASON_CODE INTERNAL_ERROR

firePx string /^[0-9]…9]+)?$/

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. A decimal string in quote asset units per base asset unit, for example '60000'. Absent for time-scheduled triggers such as TWAP.

Example 61000.25

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.

Example UNKNOWN_SYMBOL

subaccountId string /^[1-9A…m-z]+$/

Public account or sub-account ID associated with the trigger.

Example 45LUmqjT

symbol string

Trading symbol numeric identifier.

Example BTC-USDT

triggerId string /^[1-9A…m-z]+$/

Trigger ID associated with the event.

Example 59VD7Lar

triggerType enum

Trigger type at the time of the event.

STOP_LOSS TAKE_PROFIT TRAILING_STOP TWAP LADDER

Example STOP_LOSS

tsNs string /^[0-9]+$/

Event timestamp in nanoseconds since epoch (UTC).

Example 1735689600000000000

nextPageToken string

Opaque cursor for the next page. Empty when no more results exist.

Example eyJvZmZzZXQiOjIwMH0

Possible errors: 5

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.

GET

/v1/triggers/{trigger_id}/events

Request

Testnet

curl --request GET \ \
  --url 'https://api.testnet.polyester.com/v1/triggers/59VD7Lar/events?eventType=FIRED&limit=100&subaccountId=45LUmqjT' \
  --header 'Accept: */*' \
  --header 'X-API-KEY-ID: YOUR_API_KEY_ID' \
  --header 'X-API-TIMESTAMP: YOUR_API_TIMESTAMP' \
  --header 'X-API-SIGNATURE: YOUR_API_SIGNATURE'

Responses

{
  "events": [
    {
      "cancelReason": "USER_REQUEST",
      "childOrderId": "5USXJZmk",
      "childSeq": 1,
      "eventType": "FIRED",
      "firePx": "61000.25",
      "fireRefusalReason": "UNKNOWN_SYMBOL",
      "subaccountId": "45LUmqjT",
      "symbol": "BTC-USDT",
      "triggerId": "59VD7Lar",
      "triggerType": "STOP_LOSS",
      "tsNs": "1735689600000000000"
    }
  ],
  "nextPageToken": "eyJvZmZzZXQiOjIwMH0"
}