OANDA API POST /v3/accounts/{accountID}/orders

Parameters

Authentication headers

Request

Written from the method, path and parameters recorded on this page, against the demo host. Not executed against a live or demo account. Credentials are read from environment variables on your own machine and are never entered on this site. The request builder writes these same snippets, from the same record.

This call takes a request body. The samples send it as JSON with a Content-Type of application/json (in Python, passing json= sets that header) and a placeholder for each of the 1 body field the record marks as required. Each placeholder has to be replaced with a real value before the request can succeed.

# Set OANDA_TOKEN, OANDA_ACCOUNT_ID as environment variables first. Never paste real values into code.
# Optional and not shown: headers Accept-Datetime-Format.
import os
import requests

BASE_URL = "https://api-fxpractice.oanda.com"  # the demo host
headers = {
    "Authorization": "Bearer " + os.environ["OANDA_TOKEN"],
    "Content-Type": "application/json",
}
body = {"order": {}}
resp = requests.post(BASE_URL + "/v3/accounts/" + os.environ["OANDA_ACCOUNT_ID"] + "/orders", headers=headers, json=body, timeout=10)
resp.raise_for_status()
print(resp.json())

// Set OANDA_TOKEN, OANDA_ACCOUNT_ID as environment variables first. Never paste real values into code.
// Optional and not shown: headers Accept-Datetime-Format.
// Run as a module, for example a .mjs file, on a Node version that has fetch built in.
const BASE_URL = "https://api-fxpractice.oanda.com"; // the demo host
const res = await fetch(BASE_URL + "/v3/accounts/" + process.env.OANDA_ACCOUNT_ID + "/orders", {
  method: "POST",
  headers: {
    "Authorization": "Bearer " + process.env.OANDA_TOKEN,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"order": {}}),
});
if (!res.ok) throw new Error(`HTTP ${res.status}`);
console.log(await res.json());

# Set OANDA_TOKEN, OANDA_ACCOUNT_ID as environment variables first. Never paste real values into code.
# Optional and not shown: headers Accept-Datetime-Format.
curl -X POST "https://api-fxpractice.oanda.com/v3/accounts/$OANDA_ACCOUNT_ID/orders" \
  -H "Authorization: Bearer $OANDA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"order": {}}'

Response

A mock response. The values are invented, so check field names against the official reference.

{
  "_mock": true,
  "orderCreateTransaction": {
    "id": "9002",
    "type": "MARKET_ORDER",
    "instrument": "EUR_USD",
    "units": "1000",
    "timeInForce": "FOK",
    "positionFill": "DEFAULT",
    "reason": "CLIENT_ORDER",
    "accountID": "101-004-MOCK-001",
    "time": "2026-09-18T08:00:02.000000000Z"
  },
  "orderFillTransaction": {
    "id": "9003",
    "type": "ORDER_FILL",
    "orderID": "9002",
    "instrument": "EUR_USD",
    "units": "1000",
    "price": "1.10020",
    "tradeOpened": {
      "tradeID": "9003",
      "units": "1000"
    },
    "accountID": "101-004-MOCK-001",
    "time": "2026-09-18T08:00:02.000000000Z"
  },
  "relatedTransactionIDs": [
    "9002",
    "9003"
  ],
  "lastTransactionID": "9003"
}

Response schema, HTTP 201

Every field this site's OpenAPI file for OANDA declares for this response.

Unverifiedno source opened This schema is not sourced to a page of the provider's own that we opened, so check field names against the official reference.

Limits that apply at OANDA

Related OANDA API endpoints: Orders

• GET/v3/accounts/{accountID}/ordersList orders, pending by default. Filter by ids, state or instrument; paginate with beforeID.
• GET/v3/accounts/{accountID}/orders/{orderSpecifier}The details of one order on the account, whatever its state.
• PUT/v3/accounts/{accountID}/orders/{orderSpecifier}Replace a pending order: the old order is cancelled and a new one created from the specification you send, in a single call. Returns 201.
• PUT/v3/accounts/{accountID}/orders/{orderSpecifier}/cancelCancel a pending order by ID or by your client ID prefixed with @.
• PUT/v3/accounts/{accountID}/orders/{orderSpecifier}/clientExtensionsUpdate the client extensions on an order: your own ID, tag and comment, for the order and for the trade it will open. OANDA says not to use them on an account linked to MT4.
• GET/v3/accounts/{accountID}/pendingOrdersEvery pending order on the account, in one call with no filters.

OANDA API errors you may meet

• HTTP 401 (invalid or missing token)HTTP 401. The access token is invalid or missing.
• HTTP 405HTTP 405. The endpoint was called with the wrong HTTP method.
• HTTP 429HTTP 429. OANDA returned HTTP 429 because requests arrived faster than it would accept them.
• ACCOUNT_CONFIGURATION_LOCKEDThe account is locked for configuration changes.
• ACCOUNT_DEPOSIT_LOCKEDThe account is locked for deposits.
• ACCOUNT_LOCKEDThe account is locked.

All OANDA API error codes, including 236 more not listed here.