TriggersService
List Triggers
List triggers for an account with optional symbol, status, and trigger-type filters.
Request
curl --request GET \ \ --url 'https://api.testnet.polyester.com/v1/triggers?limit=100&pageToken=eyJvZmZzZXQiOjEwMH0&parentOrderId=9876543210123&status=CREATED&subaccountId=6789012345678&symbol=BTC-USDT&symbolId=1&triggerType=STOP_LOSS' \ --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
{
"nextPageToken": "eyJvZmZzZXQiOjIwMH0",
"triggers": [
{
"armedAt": "2025-01-01T00:00:00Z",
"cancelReason": "USER_REQUEST",
"clientTriggerId": "9155001234567",
"completedAt": "2025-01-01T00:00:00Z",
"createdAt": "2025-01-01T00:00:00Z",
"feeAsset": "QUOTE",
"parentOrderId": "5USXJZmk",
"qty": "100000",
"status": "CREATED",
"stop": {
"triggerDirection": "ABOVE",
"triggerPrice": "0.005",
"triggerPriceSource": "LAST_PRICE"
},
"stopLoss": {
"child": {
"marketIoc": {}
},
"side": "BUY",
"triggerPrice": "0.005"
},
"stpMode": "EXPIRE_MAKER",
"subaccountId": "45LUmqjT",
"symbol": "BTC-USDT",
"triggerId": "59VD7Lar",
"updatedAt": "2025-01-01T00:00:00Z"
}
]
}Opaque keyset cursor returned by the previous response.
Repeatable or comma-separated TriggerStatus enum names
Optional filter by stable numeric pair ID. Zero means all symbols.
Opaque cursor for the next page. Empty when no more results exist.
eyJvZmZzZXQiOjIwMH0Timestamp when the trigger became armed.
2025-01-01T00:00:00ZWhy an admitted trigger was canceled.
USER_REQUESTClient-provided trigger ID for idempotency and correlation.
9155001234567Timestamp when the trigger reached a terminal successful state.
2025-01-01T00:00:00ZCreation timestamp.
2025-01-01T00:00:00ZWhy an admitted trigger failed.
Fee asset for BUY child orders.
QUOTENumber of linearly distributed levels.
Reject each level instead of taking liquidity.
Maximum generated level price in quote units scaled by 1e9.
Minimum generated level price in quote units scaled by 1e9.
Child side.
Number of distinct ladder levels with at least one fill. A partially filled level counts once, including across replacement child orders. This is not the number of fully filled levels.
Cumulative filled child-order base quantity scaled by the pair's base_quantity_scale from GetSpotConfig. Zero means no quantity executed, including when the parent completed because all children were canceled.
Quantity distribution across ladder levels.
Number of price levels in the ladder.
Maximum price in quote units scaled by 1e9 for the ladder range.
Minimum price in quote units scaled by 1e9 for the ladder range.
Parent order ID for attached-risk triggers; empty for standalone triggers.
5USXJZmkChild quantity scaled by the pair's base_quantity_scale from GetSpotConfig.
100000Current trigger lifecycle status.
CREATEDDirection the price must cross to fire the trigger.
ABOVETrigger threshold price in quote units scaled by 1e9.
0.005Price source used for trigger evaluation.
LAST_PRICELimit price in quote units scaled by 1e9.
Reject instead of taking liquidity.
Limit price in quote units scaled by 1e9.
Limit price in quote units scaled by 1e9.
Market child with implicit IOC behavior.
Child order side.
BUYTrigger threshold in quote units scaled by 1e9.
0.005Self-trade prevention mode for child orders.
EXPIRE_MAKERPublic account or sub-account ID associated with the trigger.
45LUmqjTTrading pair symbol, e.g. BTC-USDT.
BTC-USDTLimit price in quote units scaled by 1e9.
Reject instead of taking liquidity.
Limit price in quote units scaled by 1e9.
Limit price in quote units scaled by 1e9.
Market child with implicit IOC behavior.
Child order side.
Trigger threshold in quote units scaled by 1e9.
Optional activation price: trailing only starts after this price is reached. Expressed in quote units scaled by 1e9.
Optional maximum allowed slippage in basis points (1 bp = 0.01%).
Non-negative maximum absolute price delta in Q9 execution-price ticks (1 tick = 1e-9 quote units). Zero means no absolute cap is configured.
Current peak price in quote units scaled by 1e9 for sell trailing stops.
Trailing distance in basis points (1 bp = 0.01%).
Trailing distance as a price delta in 1e-9 quote-unit ticks.
Direction the price must cross to fire the trigger. Fixed for the lifetime of the trigger and exposed for completeness.
Current trailing trigger threshold in quote units scaled by 1e9. This is evaluator-authored runtime state and moves when the peak or trough changes. It is absent until the trailing trigger is armed and a positive threshold exists.
Price source used for trigger evaluation. Fixed for the lifetime of the trigger and exposed for completeness.
Current trough price in quote units scaled by 1e9 for buy trailing stops.
Optional activation price in quote units scaled by 1e9.
Maximum slippage in basis points (1 bp = 0.01%).
Positive maximum absolute price delta in Q9 execution-price ticks (1 tick = 1e-9 quote units).
Child order side.
Distance in basis points (1 bp = 0.01%).
Distance as a price delta in 1e-9 quote-unit ticks.
Trigger ID.
59VD7LarTotal execution duration in milliseconds.
Slice limit price in quote units scaled by 1e9.
Maximum adverse price movement per slice in basis points (1 bp = 0.01%).
Positive maximum absolute price delta per slice in Q9 execution-price ticks (1 tick = 1e-9 quote units).
Child side.
Interval between slices in milliseconds.
Total duration of TWAP execution in milliseconds.
Cumulative filled child-order base quantity scaled by the pair's base_quantity_scale from GetSpotConfig.
Total number of planned slices.
Current slice index, zero-based.
Interval between TWAP slices in milliseconds.
Last update timestamp.
2025-01-01T00:00:00Z| 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. |