Skip to main content
GET
Get execution status

Authorizations

x-app-id
string
header
required

Your application ID. Required for all app-tier and user-tier routes.

Authorization
string
header
required

JWT access token returned by POST /auth/verify. Required for user-tier routes.

Query Parameters

quoteId
string
required
Minimum string length: 1
mode
enum<string>
Available options:
live,
paper

Response

200

executionId
string | null
required

Execution id; null until execution starts.

quoteId
string
required

The quote being executed.

orderIds
string[]
required

Orders created for this trade.

overallState
enum<string>
required

Overall state of the trade. In progress: created, routing, quoting, placing, confirming. Terminal (terminal: true): filled, partially_filled, failed, cancelled, expired.

Available options:
created,
routing,
quoting,
placing,
confirming,
filled,
partially_filled,
failed,
cancelled,
expired
terminal
boolean
required

true once nothing will change; stop polling.

errorReason
string | null
required

Readable reason the trade failed.

pollAfterMs
integer | null
required

Suggested wait before the next poll, in milliseconds; null when terminal.

Required range: x >= 0
dagProgress
object | null
required

Progress of the trade's execution plan; null until the plan exists.

steps
object[]
required

Execution steps, for a progress display. Group rows by groupId.

orders
object[]
required

One entry per order.

pendingSignatures
object[]

Self-custody only: requests waiting for the user's wallet, including ones raised after the fill call. Answer them on POST /execution/fill/{quoteId}/signatures.