Developer Portal
Trader APIsHTTP APITrading

Account MetricsGET

Returns latest metrics snapshot for the authenticated user's account (PnL, Equity, Balance, Margins)

View as Markdown
GET
/accounts/{account_id}/metrics

Authorization

AuthorizationRequiredBearer <token>

JWT token obtained from the login endpoint

In: header

Path Parameters

account_idRequiredstring

Account ID to fetch metrics for

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

Successfully retrieved account metrics

{
  "account_id": "acc_123456",
  "timestamp": 1707849123456,
  "pnl": 1250.5,
  "equity": 101250.5,
  "balance": 100000,
  "used_margin": 5000,
  "free_margin": 96250.5,
  "margin_level": 2025.01,
  "position_pnl_by_id": {
    "pos_001": 500.25,
    "pos_002": 750.25
  }
}

Double Position

Places a market order matching the position's symbol, side, and remaining open quantity. When the order fills, the resulting deal is merged into the existing position (VWAP recalculation + quantity increase).

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.).