---
title: "/account"
method: GET
path: "/api/v1/account"
tags: ["Account Data"]
---

# /account

`GET /api/v1/account`

Retrieves the user's account details.

## Query parameters

- `accountAddress` string

## Response `200`

Successful response with account details.

- Account
  - `groupId` string — The (optional) group ID of the account. Accounts belonging to the same group cannot trade against each other.
  - `tradingFees` TradingFees, required
    - `makerFeeE9` string, required — The Account Maker Fee (e9 format).
    - `takerFeeE9` string, required — The Account Taker Fee (e9 format).
    - `isApplied` boolean, required — Are the fees applied on the account?
  - `canTrade` boolean, required — If the user can trade.
  - `canDeposit` boolean, required — If the current user can deposit to the account.
  - `canWithdraw` boolean, required — If the current user can withdraw from the account.
  - `crossEffectiveBalanceE9` string, required — Total effective balance in USD (e9 format).
  - `crossMarginRequiredE9` string, required — The sum of initial margin required across all cross positions (e9 format).
  - `totalOrderMarginRequiredE9` string, required — The sum of initial margin required across all open orders (e9 format).
  - `marginAvailableE9` string, required — The amount of margin available to open new positions and orders (e9 format).
  - `crossMaintenanceMarginRequiredE9` string, required — The sum of maintenance margin required across all cross positions (e9 format).
  - `crossMaintenanceMarginAvailableE9` string, required — The amount of margin available before liquidation (e9 format).
  - `crossMaintenanceMarginRatioE9` string, required — The ratio of the maintenance margin required to the account value (e9 format).
  - `crossLeverageE9` string, required — The leverage of the account (e9 format).
  - `totalUnrealizedPnlE9` string, required — Total unrealized profit (e9 format).
  - `crossUnrealizedPnlE9` string, required — Unrealized profit of cross positions (e9 format).
  - `crossUnrealizedLossE9` string, required — An implicitly negative number that sums only the losses of all cross positions.
  - `crossAccountValueE9` string, required — The total value of the cross account, combining the cross effective balance and unrealized PnL across all cross positions, and subtracting any pending funding payments on any cross position.
  - `totalAccountValueE9` string, required — The total value of the account, combining the total effective balance and unrealized PnL across all positions, and subtracting any pending funding payments on any position.
  - `updatedAtMillis` integer, required — Last update time in milliseconds since Unix epoch.
  - `assets` Asset[], required
    - `symbol` string, required — The symbol of the asset.
    - `quantityE9` string, required — The quantity of the asset.
    - `effectiveBalanceE9` string, required — The effective balance of the asset.
    - `maxWithdrawQuantityE9` string, required — The maximum quantity that can be withdrawn.
    - `updatedAtMillis` integer, required — The timestamp of the last update in milliseconds.
  - `positions` Position[], required
    - `symbol` string, required — Market address.
    - `avgEntryPriceE9` string, required — Average entry price determined by a simple average of all entry prices resulting in this position size (e9 format).
    - `clientSetLeverageE9` string, required — Isolated position leverage (e9 format).
    - `liquidationPriceE9` string, required — Liquidation price (e9 format).
    - `markPriceE9` string, required — Mark price (e9 format).
    - `notionalValueE9` string, required — Notional value (e9 format).
    - `sizeE9` string, required — Position size (e9 format).
    - `unrealizedPnlE9` string, required — Unrealized profit (e9 format).
    - `side` 'LONG' | 'SHORT' | 'UNSPECIFIED', required — The side of the position, either long or short
    - `marginRequiredE9` string, required — Initial margin required with current mark price (e9 format).
    - `maintenanceMarginE9` string, required — Maintenance margin required with current mark price (e9 format).
    - `isIsolated` boolean, required — If the position is isolated.
    - `isolatedMarginE9` string, required — Margin value present if margin type is isolated (e9 format).
    - `updatedAtMillis` integer, required — Last update time.
    - `fundingRatePaymentAllTimeE9` string, required — Total funding rate payment (e9 format).
    - `fundingRatePaymentSinceChangeE9` string, required — Funding rate payment since last position change (e9 format).
    - `fundingRatePaymentSinceOpenedE9` string, required — Funding rate payment since position opened (e9 format).
  - `authorizedAccounts` string[], required — Deprecated: Replaced with authorizedWallets.
  - `accountAddress` string, required — The address of the account.
  - `authorizedWallets` AuthorizedWallet[], required — The wallets that are authorized to trade on behalf of the current account.
    - `address` string, required — The address of the authorized wallet.
    - `alias` string — The alias of the authorized wallet.
    - `authorizedAtMillis` integer, required — The timestamp in milliseconds when the wallet was authorized.

## Other responses

- `400` — request missing required parameters
- `401` — unauthorized access
- `404` — account not found
- `500` — internal server error

---

[API](https://skmtc.net/bluefin/apis/bluefin-account-data-api.md) · [All operations](https://skmtc.net/bluefin/apis/bluefin-account-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bluefin/bluefin-account-data-api/versions/5fd638fb0785/schema)