TriggersService
Create Trigger
Create a standalone trigger order. Supports stop, trailing, TWAP, and ladder trigger configurations.
Request
curl --request POST \ \
--url 'https://api.testnet.polyester.com/v1/triggers' \
--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' \
--header 'Content-Type: application/json' \
--data '{
"subaccountId": "45LUmqjT",
"trigger": {
"clientTriggerId": "9155001234567",
"feeAsset": "QUOTE",
"qty": "100000",
"selfTradePreventionMode": "EXPIRE_MAKER",
"stopLoss": {
"child": {
"marketIoc": {}
},
"side": "BUY",
"triggerPrice": "0.005"
},
"symbol": "BTC-USDT"
}
}'Responses
{
"acceptedAt": "2025-01-01T00:00:00Z",
"acceptedAtTsNs": "1735689600000000000",
"clientTriggerId": "9155001234567",
"triggerId": "59VD7Lar"
}Target sub-account. When omitted, uses the caller's root account.
Client-provided trigger ID for idempotency.
Fee asset for BUY children. SELL children must use QUOTE.
Number 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.
Total quantity scaled by the pair's base_quantity_scale.
Child self-trade prevention mode. Defaults to EXPIRE_MAKER.
Limit 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.
Trading pair symbol, e.g. BTC-USDT.
Limit 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 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.
Total 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.
Time creation admission completed.
2025-01-01T00:00:00ZAdmission completion time in nanoseconds since epoch (UTC).
1735689600000000000Echoed client trigger ID.
9155001234567Assigned trigger ID.
59VD7Lar| 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. |