Execute a trade
Executes a trade against a quote. Call this before the quotes expiresAt.
Authorizations
ES256-signed JWT bearer token, single-use, 60-second TTL. See Authentication for how to mint one.
ES256 signature over the request, bound to the bearer JWT. Required on every request. See Authentication → Request signing.
Headers
Client-generated unique key to make a write operation safely retryable. UUID recommended. See Idempotency.
1 - 255^[a-zA-Z0-9_-]{1,255}$"550e8400-e29b-41d4-a716-446655440000"
Optional, client-supplied correlation ID for this request. Echoed verbatim on the response when supplied; the response omits it when the request did not supply one. Distinct from X-Trace-Id (server-generated, always present). See Metadata & tracing.
"my-req-abc-123"
Environment selector, matching the API key's bound environment. Defaults to SANDBOX when omitted. See Environments. When present, the value must be SANDBOX or LIVE, matched without regard to case. Any other value, including an empty one, returns 400 INVALID_APP_MODE; details.received echoes the value you sent.
SANDBOX, LIVE "SANDBOX"
Body
Executes a trade against a previously created quote. Unknown fields are rejected with 400 VALIDATION_BODY_FAILED.
ID of the quote to execute the trade against.
^([a-z]{3,5}_[1-9A-HJ-NP-Za-km-z]{1,22}|[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})$"qte_3FfGK34vwMvVFDedyb2nkf"
Client-supplied reference for the trade. Present as null when unset; maximum 255 characters.
255"order-123"
Response
Trade executed.
A trade executes against a quote at the quoted rate.