Developer Portal
Trader APIsHTTP APITrading

My AccountsGET

Lists all trading accounts (portfolios) owned by the authenticated client profile, with the account_id required by every other account-scoped operation. Each entry carries balance, credit, unrealized PnL, used margin, currency, trade status, demo flag and margin-call/stop-out flags, but excludes positions and orders. Start here when no account id is known. Returns an empty accounts array if the profile owns none.

View as Markdown
GET
/profiles/me/accounts

Authorization

AuthorizationRequiredBearer <token>

JWT token obtained from the login endpoint

In: header

curl -X GET "http://localhost:8081/api/v1/profiles/me/accounts" \
  -H "Authorization: Bearer <token>"

Accounts retrieved successfully

{
  "accounts": [
    {
      "account_id": "10034",
      "currency": "EUR",
      "balance": 9900.8,
      "credit": 500,
      "unrealized_pnl": 9093.48,
      "used_margin": 1016.17,
      "in_margin_call": false,
      "in_stop_out": false,
      "status": "TRADE_STATUS_FULL",
      "is_demo": false
    }
  ]
}

Margin Preview

Advisory preview of the additional margin needed to open `volume` lots of `symbol_id` as a market BUY and as a market SELL, priced at the current bid. Account, group, symbol and access status, holidays and quotes are checked as for a BUY; trading sessions, volume limits, exposure limits, price protection and long-only restrictions on SELL are not, so an order can still be rejected. Pending orders are margin-checked when they trigger, not when placed. `required_margin` is clamped at 0, while `used_margin_after` and `free_margin_after` reflect margin released by hedging.

My Profile

Returns the profile of the authenticated user, identified by the JWT subject. Includes identity fields (id, email, first/last name) and profile metadata (language, country, address, etc.).