API ReferenceExecution
List your conditional orders across every venue
const url = 'https://exec.predictefy.com/v1/exec/conditional?fireMode=all&limit=50';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://exec.predictefy.com/v1/exec/conditional?fireMode=all&limit=50' \ --header 'Authorization: Bearer <token>'Requires Authorization: Bearer <api-key> with the trade scope. Newest first. cursor is the previous page's last conditional order id; meta.nextCursor is null on the last page. status accepts all or a comma-separated subset of the lifecycle vocabulary, and fireMode narrows to the orders one side actually acts on — poll ?status=triggered&fireMode=client for the orders you have to submit yourself.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Query Parameters
Section titled “Query Parameters”all (default) or a comma-separated subset of the conditional statuses.
all (default), or one fire mode. Anything else is 400 VALIDATION_ERROR rather than a silently ignored filter.
Snapshot/offset cursors are signed by the server; a tampered or foreign cursor is rejected as VALIDATION_ERROR.
Positive page size. Values over 200 are accepted and clamped to 200.
Responses
Section titled “Responses”Account-scoped conditional-order page.
object
An armed take-profit / stop-loss order. The stored artifact, its hash, its key id and any fire lease are deliberately absent from this shape and are never returned.
object
The trusted-edge country at arm time, re-applied to the venue geofence at fire.
Present on the single-order read only.
One append-only transition, with the evidence that caused it.
object
The trigger rule. Every optional field has an engine default that is stored explicitly on the armed row, so an order always says exactly what it meant.
object
The direction the reference price must cross.
The probability the reference must reach.
mark is the median of best bid, best ask and a fresh last trade; bid/ask select the executable side explicitly.
Consecutive qualifying samples required before the order triggers.
How long the condition must hold, measured on book timestamps.
No trigger while the book's spread is wider than this.
The qualifying quote must show at least this size.
Sugar. Rewritten to when from the stored order's side (a stop sells below and buys above; take-profit mirrors it), and echoed back on the stored rule.
object
Pass as cursor for the next page; null on the last page.
Example
{ "success": true, "data": [ { "events": [ { "actor": "api" } ], "fireMode": "hosted", "status": "armed", "trigger": { "when": "at_or_above", "reference": "mark", "confirmations": 2, "dwellMs": 2000, "maxSpread": 0.1, "minSize": 1, "tpsl": "tp" } } ]}Invalid route query, body, or lifecycle state.
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}Missing, invalid, unknown, or revoked Predictefy API key.
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}The API key lacks the mandatory trade scope, or the account's plan does not include conditional orders (Pro is the minimum).
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}The conditional order family is not enabled for this account on this deployment.
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}The authenticated execution token bucket is exhausted.
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}Unexpected internal execution failure.
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}Authentication, billing, or execution storage is temporarily unavailable.
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}