POST
/api/v2/banking/orders/tradePOST /api/v2/banking/orders/trade
Authentication
Send your API key in the x-api-key header on every request.
Parameters
| Field | Type | Required | Description |
|---|---|---|---|
| accountId (query) | string | No |
Request body
application/json
| Field | Type | Required | Description |
|---|---|---|---|
| orderId | string | No | Order ID returned by the quote response. This identifies the provider quote/order to execute. OrderId returned by POST /api/v2/banking/orders/quote. |
| quoteRequestId | string | No | Quote request ID returned by the quote response. This is different from OrderId and must be sent back with the trade request. QuoteRequestId returned by POST /api/v2/banking/orders/quote. This is separate from OrderId. |
| moveMoneyRequestId | string | No | Optional move-money request ID. Omit it unless the upstream quote/payment flow returned one. Optional. Omit unless the upstream quote/payment flow returned a moveMoneyRequestId. |
| payments | object | No |
Responses
200 — OK
| Field | Type | Required | Description |
|---|---|---|---|
| orderId | string | No | Order ID for the trade |
| bank | string | No | Bank identifier |
| settlement | EqualsMoneyTradeSettlement | No | Settlement details for trade |
| trade | EqualsMoneyTradeDetails | No | Trade execution details |
400 — Bad Request
| Field | Type | Required | Description |
|---|---|---|---|
| Message | string | No | |
| Code | string | No | |
| Status | unknown | No | |
| ValidationErrors | object | No | |
| Details | string | No |
401 — Unauthorized
| Field | Type | Required | Description |
|---|---|---|---|
| Message | string | No | |
| Code | string | No | |
| Status | unknown | No | |
| ValidationErrors | object | No | |
| Details | string | No |
404 — Not Found
| Field | Type | Required | Description |
|---|---|---|---|
| Message | string | No | |
| Code | string | No | |
| Status | unknown | No | |
| ValidationErrors | object | No | |
| Details | string | No |
500 — Internal Server Error
| Field | Type | Required | Description |
|---|---|---|---|
| Message | string | No | |
| Code | string | No | |
| Status | unknown | No | |
| ValidationErrors | object | No | |
| Details | string | No |
Example request
curl -X POST "https://{base_url}/api/v2/banking/orders/trade" \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'This page is generated from the live OpenAPI specification and always matches the current API.