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.

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/9155001234567/events?eventType=FIRED&limit=100&pageToken=eyJvZmZzZXQiOjEwMH0&subaccountId=6789012345678' \
  --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": "0.005",
      "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. EVENT_UNSPECIFIED returns all events.

limit integer ≤ 1000

pageToken string max 512 chars

Opaque keyset cursor returned by the previous response.

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

11 fields

cancelReason enum

Why an admitted trigger was canceled.

USER_REQUEST OCO PARENT_CANCELED_NO_FILL 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

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 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 MISSING_REASON_CODE INTERNAL_ERROR

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

Price that caused a conditional trigger to fire, in quote units scaled by 1e9. Absent for time-scheduled triggers such as TWAP.

Example 0.005

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	Status	Error	When
unauthenticated	401	Unauthenticated	Authentication required.
permission-denied	403	Permission Denied	Permission denied.
invalid-argument	400	Invalid Argument	Invalid argument.
not-found	404	Not Found	Not found.
unavailable	503	Unavailable	Service unavailable.

GET

/v1/triggers/{trigger_id}/events

Request

Testnet

curl --request GET \ \
  --url 'https://api.testnet.polyester.com/v1/triggers/9155001234567/events?eventType=FIRED&limit=100&pageToken=eyJvZmZzZXQiOjEwMH0&subaccountId=6789012345678' \
  --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": "0.005",
      "subaccountId": "45LUmqjT",
      "symbol": "BTC-USDT",
      "triggerId": "59VD7Lar",
      "triggerType": "STOP_LOSS",
      "tsNs": "1735689600000000000"
    }
  ],
  "nextPageToken": "eyJvZmZzZXQiOjIwMH0"
}

Polyester is best experienced on desktop.

Request

Responses