OANDA API GET /v3/accounts/{accountID}

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.

# 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"],
}
resp = requests.get(BASE_URL + "/v3/accounts/" + os.environ["OANDA_ACCOUNT_ID"], headers=headers, 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, {
  method: "GET",
  headers: {
    "Authorization": "Bearer " + process.env.OANDA_TOKEN,
  },
});
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 GET "https://api-fxpractice.oanda.com/v3/accounts/$OANDA_ACCOUNT_ID" \
  -H "Authorization: Bearer $OANDA_TOKEN"

Response

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

{
  "_mock": true,
  "account": {
    "id": "101-004-MOCK-001",
    "alias": "Mock practice account",
    "currency": "GBP",
    "balance": "10000.0000",
    "NAV": "10012.5000",
    "unrealizedPL": "12.5000",
    "pl": "0.0000",
    "marginUsed": "66.6700",
    "marginAvailable": "9945.8300",
    "marginRate": "0.0333",
    "openTradeCount": 1,
    "openPositionCount": 1,
    "pendingOrderCount": 1,
    "hedgingEnabled": false,
    "lastTransactionID": "9001",
    "trades": [
      {
        "id": "MOCK-T-001",
        "instrument": "EUR_USD",
        "price": "1.10000",
        "openTime": "2026-09-18T08:00:00.000000000Z",
        "state": "OPEN",
        "initialUnits": "1000",
        "currentUnits": "1000",
        "realizedPL": "0.0000",
        "unrealizedPL": "1.2500",
        "marginUsed": "33.3300"
      }
    ],
    "positions": [],
    "orders": []
  },
  "lastTransactionID": "9001"
}

Response schema, HTTP 200

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: Accounts

• GET/v3/accountsList every account your token can access. Start here to find your accountID.
• GET/v3/accounts/{accountID}/changesPoll an account for its current state and for what has changed since a transaction you name. This is the documented way to keep a local copy of an account up to date.
• PATCH/v3/accounts/{accountID}/configurationChange the parts of an account its owner may set: the alias and the margin rate.
• GET/v3/accounts/{accountID}/summaryAccount summary without the trade, position and order lists. Cheap balance and margin check.

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.