trader.account

1 method on trader.account. Each returns the answer's data and throws NoviqaError on a failed answer.

retrieve

GET/trader/v1/account

Live account state

Money (balance, credit, equity, margin, free margin, margin level), the risk levels of the group, open positions and pending orders, read live from execution. Floating profit is at current prices. Afterwards keep it current from the live socket. trade.timeout when execution does not answer; not_found when the account is not loaded. Only the signed-in account is ever read: the login comes from the session, never from the request.

Parameters

X-HST-Accountstring · header

Intended signed-in login captured by the browser tab before dispatch and retained across retries. A mismatch returns auth.account_changed (409) before mutation or refresh rotation. This never selects or authorizes an account; omission preserves existing API client compatibility.

Returns

Promise<AccountState>

The answer's data.

Errors

400invalid_input: invalid input

401auth.session_expired: session expired, sign in again

403auth.invalid_terminal: this terminal cannot be used here

403auth.otp_enrol_required: your group requires one-time codes: set them up to continue

403auth.password_change_required: you must change your password first

404not_found: not found

409auth.account_changed: the signed-in account changed; sign in again before continuing

500internal: something went wrong

504trade.timeout: request timed out

SDK

import { trader } from "@/lib/noviqa"

const data = await trader.account.retrieve()

cURL

curl -X GET "$NOVIQA_API_URL/trader/v1/account" \
  -H "Authorization: Bearer $NOVIQA_TOKEN"

Response 200

{
  "success": true,
  "code": "ok",
  "message": "done",
  "data": {
    "error": "ok",
    "money": {
      "agent_commission": "1.08452",
      "balance": "1000.00",
      "balance_prev_day": "1.08452",
      "balance_prev_month": "1.08452",
      "blocked_commission": "1.08452",
      "blocked_profit": "1.08452",
      "credit": "0.00",
      "currency": "USD",
      "currency_digits": 1,
      "day": "2026-09-25T10:15:00Z",
      "effective_leverage": "1.08452",
      "equity": "1012.40"
    },
    "orders": [
      {
        "activated_at": "2026-09-25T10:15:00Z",
        "by_position_id": 1,
        "comment": "Deposit via bank",
        "contract_size": "1.08452",
        "created_at": "2026-09-25T10:15:00Z",
        "dealer": 1,
        "deviation_pts": 1,
        "digits": 5,
        "done_at": "2026-09-25T10:15:00Z",
        "expiration": "string",
        "expires_at": "2026-09-25T10:15:00Z",
        "external_id": "string"
      }
    ],
    "positions": [
      {
        "comment": "Deposit via bank",
        "contract_size": "1.08452",
        "dealer": 1,
        "digits": 5,
        "external_id": "string",
        "id": 1,
        "login": 1001,
        "margin": "108.45",
        "opened_at": "2026-09-25T10:15:00Z",
        "origin": {},
        "price_current": "1.08452",
        "price_open": "1.08452"
      }
    ],
    "risk": {
      "free_margin_mode": "ignore_pl",
      "level_type": "percent",
      "leverage": 100,
      "leverage_profile": "string",
      "margin_call_level": "1.08452",
      "margin_mode": "netting",
      "stop_out_level": "1.08452"
    }
  },
  "request_id": "5b7f2c1e"
}

trader.account.retrieve(options?: RequestOptions): Promise<models.AccountState>