/v1/accounts/{accountId}/execution/orders/{orderId}PATCHAuthorization
bearerAuth *Bearer <token>
Token in: header
Path Parameters
accountId *string
Min length:
1orderId *string
Pattern:
^(?:0|[1-9][0-9]*)$Header Parameters
idempotency-key *string
Min length:
1Max length: 128Request Body
application/jsonrequiredprice?string
Pattern:
^-?(?:0|[1-9][0-9]*)(?:\.[0-9]+)?$stopLimitPrice?string
Pattern:
^-?(?:0|[1-9][0-9]*)(?:\.[0-9]+)?$stopLoss?string | null
takeProfit?string | null
timeInForce?"gtc" | "day" | "specified" | "specified_day"
expiresAt?string (date-time)
Response
200 · The broker command reached a confirmed terminal outcome
commandId *string (uuid)
operation *"order.submit" | "order.modify" | "order.cancel" | "position.modify" | "position.close"
outcome *"accepted" | "rejected" | "commit_unknown" | "unresolved"
status *"placed" | "filled" | "partially_filled" | "canceled" | "expired" | "modified" | "rejected" | "unknown"
retcode *integernull
retcodeExternal *integernull
retcodeDescription *string
orderId?string
Pattern:
^(?:0|[1-9][0-9]*)$dealId?string
Pattern:
^(?:0|[1-9][0-9]*)$positionId?string
Pattern:
^(?:0|[1-9][0-9]*)$clientOrderId?string
Caller-defined execution identity, unique within a connected account.
Pattern:
^[A-Za-z0-9._:-]+$Min length: 1Max length: 31volume *string
Pattern:
^-?(?:0|[1-9][0-9]*)(?:\.[0-9]+)?$price *string
Pattern:
^-?(?:0|[1-9][0-9]*)(?:\.[0-9]+)?$bid?string
Pattern:
^-?(?:0|[1-9][0-9]*)(?:\.[0-9]+)?$ask?string
Pattern:
^-?(?:0|[1-9][0-9]*)(?:\.[0-9]+)?$recovered *boolean
observedAt *string (date-time)
latencyMs *number
Min:
0202 · The broker commit is not yet known and can be reconciled by command ID
commandId *string (uuid)
operation *"order.submit" | "order.modify" | "order.cancel" | "position.modify" | "position.close"
outcome *"accepted" | "rejected" | "commit_unknown" | "unresolved"
status *"placed" | "filled" | "partially_filled" | "canceled" | "expired" | "modified" | "rejected" | "unknown"
retcode *integernull
retcodeExternal *integernull
retcodeDescription *string
orderId?string
Pattern:
^(?:0|[1-9][0-9]*)$dealId?string
Pattern:
^(?:0|[1-9][0-9]*)$positionId?string
Pattern:
^(?:0|[1-9][0-9]*)$clientOrderId?string
Caller-defined execution identity, unique within a connected account.
Pattern:
^[A-Za-z0-9._:-]+$Min length: 1Max length: 31volume *string
Pattern:
^-?(?:0|[1-9][0-9]*)(?:\.[0-9]+)?$price *string
Pattern:
^-?(?:0|[1-9][0-9]*)(?:\.[0-9]+)?$bid?string
Pattern:
^-?(?:0|[1-9][0-9]*)(?:\.[0-9]+)?$ask?string
Pattern:
^-?(?:0|[1-9][0-9]*)(?:\.[0-9]+)?$recovered *boolean
observedAt *string (date-time)
latencyMs *number
Min:
0400 · Invalid request
error *object | object
401 · Invalid API key
error *object | object
403 · Insufficient API key scope or connected account slot limit
error *object | object
404 · Resource not found
error *object | object
409 · Account is not active
error *object | object
413 · Request body too large
error *object | object
422 · The broker or terminal rejected the operation
error *object | object
429 · Rate limit exceeded
error *object | object
500 · Unexpected failure
error *object | object
503 · Capacity exhausted, upstream unavailable, or history coverage unsettled
error *object | object
504 · Upstream request timed out
error *object | object
Request example
curl -X PATCH "https://api.fivesocket.com/v1/accounts/<accountId>/execution/orders/<orderId>" \ -H "idempotency-key: <idempotency-key>" \ -H "Authorization: Bearer <token>" \ -H "Content-Type: application/json" \ -d '{ "price": "string", "stopLimitPrice": "string", "stopLoss": "string", "takeProfit": "string", "timeInForce": "gtc", "expiresAt": "2024-01-15T09:30:00Z" }'