> ## Documentation Index
> Fetch the complete documentation index at: https://v3.docs.derive.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Get account settings and fees for a wallet

> Returns account-level information for a given wallet address: the list of its subaccount IDs, WebSocket rate limits (matching, non-matching, perp, and option messages per second) and any per-endpoint overrides, cancel-on-disconnect and RFQ-maker flags, the account creation timestamp, and a fee_info block with fee discounts and per-instrument maker/taker fee overrides expressed as decimals. Returns an account-not-found error if the wallet has never been registered.



## OpenAPI

````yaml /openapi.json post /private/get_account
openapi: 3.1.0
info:
  title: Derive v3 API
  version: 0.2.0
  description: JSON-RPC 2.0 methods, served over WebSocket and HTTP POST.
servers:
  - url: https://api.derive.xyz/v3
    description: Production (HTTP POST base)
  - url: https://testnet.api.derive.xyz/v3
    description: Testnet (HTTP POST base)
security: []
tags:
  - name: Subaccounts
    description: >-
      List, inspect, and label subaccounts, portfolios, positions, and
      collateral.
  - name: Session Keys
    description: Register, edit, and list delegated signing keys.
  - name: Account
    description: Wallet-level account information and settings.
  - name: Orderbook
    description: Place, replace, cancel, and query orders, trigger orders, and algos.
  - name: RFQ
    description: 'Request-for-quote: send RFQs, quote, and execute block trades.'
  - name: Vault Shareholders
    description: >-
      Deposit into and withdraw from vaults, and track shares, requests, and
      performance.
  - name: Vault Curators
    description: >-
      Create and operate curated vaults: settle deposit and withdrawal requests,
      and manage vault metadata.
  - name: History
    description: >-
      Per-account historical records: orders, trades, transfers, and
      settlements.
  - name: Market Maker Protection
    description: Configure, read, and reset market-maker protection.
  - name: Transfers & Withdrawals
    description: Move collateral between subaccounts, to other wallets, and on-chain.
  - name: System
    description: Rate limits and transaction lookups.
  - name: Market Data
    description: Instruments, currencies, tickers, and market-wide feeds.
  - name: Referrals
    description: Referral codes and program performance.
  - name: Other
    description: Uncategorized.
paths:
  /private/get_account:
    post:
      tags:
        - Account
      summary: Get account settings and fees for a wallet
      description: >-
        Returns account-level information for a given wallet address: the list
        of its subaccount IDs, WebSocket rate limits (matching, non-matching,
        perp, and option messages per second) and any per-endpoint overrides,
        cancel-on-disconnect and RFQ-maker flags, the account creation
        timestamp, and a fee_info block with fee discounts and per-instrument
        maker/taker fee overrides expressed as decimals. Returns an
        account-not-found error if the wallet has never been registered.
      operationId: private_get_account
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetAccountRequest'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PrivateGetAccountResponse'
        default:
          description: JSON-RPC error (see Error Codes)
components:
  schemas:
    GetAccountRequest:
      type: object
      required:
        - wallet
      properties:
        wallet:
          $ref: '#/components/schemas/Address'
    PrivateGetAccountResponse:
      type: object
      required:
        - cancel_on_disconnect
        - fee_info
        - is_rfq_maker
        - per_endpoint_tps
        - subaccount_ids
        - wallet
        - websocket_matching_tps
        - websocket_non_matching_tps
        - websocket_option_tps
        - websocket_perp_tps
      properties:
        cancel_on_disconnect:
          type: boolean
        creation_timestamp_sec:
          type:
            - integer
            - 'null'
          format: uint64
          minimum: 0
        fee_info:
          $ref: '#/components/schemas/AccountFeeInfo'
        is_rfq_maker:
          type: boolean
        per_endpoint_tps:
          type: object
          additionalProperties:
            type: integer
            format: uint16
            minimum: 0
        referral_code:
          type:
            - string
            - 'null'
        subaccount_ids:
          type: array
          items:
            type: integer
            format: uint64
            minimum: 0
        wallet:
          type: string
        websocket_matching_tps:
          type: integer
          format: uint16
          minimum: 0
        websocket_non_matching_tps:
          type: integer
          format: uint16
          minimum: 0
        websocket_option_tps:
          type: integer
          format: uint16
          minimum: 0
        websocket_perp_tps:
          type: integer
          format: uint16
          minimum: 0
    Address:
      description: 20-byte Ethereum address as a 0x-prefixed lowercase hex string.
      type: string
      maxLength: 42
      minLength: 42
      pattern: ^0x[0-9a-fA-F]{40}$
    AccountFeeInfo:
      type: object
      required:
        - base_fee_discount
        - rfq_maker_discount
        - rfq_taker_discount
      properties:
        base_fee_discount:
          type: string
        option_maker_fee:
          type:
            - string
            - 'null'
        option_taker_fee:
          type:
            - string
            - 'null'
        perp_maker_fee:
          type:
            - string
            - 'null'
        perp_taker_fee:
          type:
            - string
            - 'null'
        rfq_maker_discount:
          type: string
        rfq_taker_discount:
          type: string
        spot_maker_fee:
          type:
            - string
            - 'null'
        spot_taker_fee:
          type:
            - string
            - 'null'

````

## Related topics

- [Edit a session key's off-chain settings](/api-reference/session-keys/edit-a-session-keys-off-chain-settings.md)
- [Cancel on Disconnect](/trading/cancel-on-disconnect.md)
- [Fees](/vaults/fees.md)