> ## Documentation Index > Fetch the complete documentation index at: https://docs.decibel.trade/llms.txt > Use this file to discover all available pages before exploring further. # Get account overview > Retrieve comprehensive account information including equity, realized/unrealized PnL, margin utilization, and optional performance metrics. Use `include_performance=true` to get historical return metrics. ## OpenAPI ````yaml /api-reference/openapi.json get /api/v1/account_overviews openapi: 3.1.0 info: title: Decibel Trading API description: >- RESTful API for Decibel. Provides read-only endpoints for market data, trading operations, positions, and analytics. contact: name: Decibel Team url: https://decibel.trade/ license: name: '' version: 1.0.0 servers: - url: https://api.mainnet.aptoslabs.com/decibel description: Mainnet - url: https://api.testnet.aptoslabs.com/decibel description: Testnet security: - bearerAuth: [] tags: - name: Market Data description: Market information and real-time data endpoints - name: User description: User information and account management - name: Trades description: Trading operations and history - name: Positions description: User position management - name: Orders description: Order management and history - name: TWAP description: Time-weighted average price orders - name: Bulk Orders description: Bulk order management - name: Vaults description: Vault operations and management - name: Analytics description: Analytics and performance metrics - name: Predeposit Rewards description: Season 0 predeposit USDC rewards - name: Referrals description: Referral code management and tracking paths: /api/v1/account_overviews: get: tags: - Account summary: Get account overview description: >- Retrieve comprehensive account information including equity, realized/unrealized PnL, margin utilization, and optional performance metrics. Use `include_performance=true` to get historical return metrics. operationId: handle_account_overview parameters: - name: account in: query description: User account address required: true schema: type: string example: 0x123... - name: volume_window in: query description: >- Volume time window (e.g., "7d", "14d", "30d", "90d"). Omit to exclude volume data. required: false schema: type: string description: Time window for volume queries enum: - 7d - 14d - 30d - 90d example: 30d - name: include_performance in: query description: Include performance metrics required: false schema: type: boolean default: false example: false - name: performance_lookback_days in: query description: Performance lookback window in days. required: false schema: type: integer format: int32 default: 90 minimum: 0 example: 90 responses: '200': description: Account overview retrieved successfully content: application/json: schema: $ref: '#/components/schemas/AccountOverviewDto' '500': description: Database error components: schemas: AccountOverviewDto: type: object required: - perp_equity_balance - unrealized_pnl - unrealized_funding_cost - cross_margin_ratio - maintenance_margin - cross_account_leverage_ratio - total_margin - usdc_cross_withdrawable_balance - usdc_isolated_withdrawable_balance - margin_deficit properties: all_time_return: type: - number - 'null' format: double average_cash_position: type: - number - 'null' format: double average_leverage: type: - number - 'null' format: double cross_account_leverage_ratio: type: number format: double example: 40.99 cross_account_position: type: - number - 'null' format: double cross_margin_ratio: type: number format: double example: 0.01 liquidation_fees_paid: type: - number - 'null' format: double description: >- Total fees paid during margin call liquidations (always positive). Fee rate is configurable per market (default 0.5%, max 2% of notional). This is already included in realized_pnl but shown separately for transparency. Null for accounts that have never been margin called. example: 45.5 liquidation_losses: type: - number - 'null' format: double description: >- Net collateral balance changes from liquidations (vault/BLP accounts only). Regular users: always null - their liquidation loss is in realized_pnl via BackStopLiquidation trades. Vault accounts: positive = margin received from liquidated users (profit), negative = bad debt covered when users were underwater (loss). example: -500 maintenance_margin: type: number format: double example: 115.29 margin_deficit: type: number format: double description: >- Cross-margin deficit: 0 when healthy, negative when the account has a margin hole. When negative, new deposits will partially fill this deficit before becoming available to trade. For example, deficit = -12 means a $185 deposit yields only $173 available (the first $12 fills the hole). Formula: min(0, margin_balance - margin_for_free_collateral + min(0, unrealized_pnl - funding) - order_margin) example: -12.06 max_drawdown: type: - number - 'null' format: double net_deposits: type: - number - 'null' format: double description: >- Net deposits (total deposits - total withdrawals) in USDC. Used to verify all_time_return: all_time_return = ((equity - net_deposits) / net_deposits) * 100 example: 30277044.96 perp_equity_balance: type: number format: double example: 10064.88 pnl_90d: type: - number - 'null' format: double realized_pnl: type: - number - 'null' format: double example: 1250.5 sharpe_ratio: type: - number - 'null' format: double total_margin: type: number format: double example: 9998.72 unrealized_funding_cost: type: number format: double example: -87.84 unrealized_pnl: type: number format: double example: 154 usdc_cross_withdrawable_balance: type: number format: double example: 9843.79 usdc_isolated_withdrawable_balance: type: number format: double example: 0 vault_equity: type: - number - 'null' format: double description: >- Total USDC value of vault shares held by this account. NULL when not yet available (e.g., WebSocket updates before real-time vault tracking). example: 259.73 volume: type: - number - 'null' format: double weekly_win_rate_12w: type: - number - 'null' format: double securitySchemes: bearerAuth: type: http scheme: bearer description: >- Bearer token from Geomi. See [Authentication](/api-reference/rest/authentication) for setup instructions. ````