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

# public/get_subaccounts

> Returns the wallet address and the sorted list of all subaccount IDs owned by that wallet. Yields an empty list if the wallet has no subaccounts. Public endpoint, no authentication required.



## OpenAPI

````yaml /openapi.json post /public/get_subaccounts
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: Liquidations
    description: >-
      Open a Dutch auction against a breaching subaccount, quote the auctions
      running right now, bid on them, and review past ones.
  - 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: Onchain Actions
    description: >-
      L1 onchain actions submitted via OnchainActionManager: register deposit
      addresses, list pending deposits, and inspect onchain action history.
  - name: System
    description: Rate limits, transaction lookups, and live incidents.
  - name: Market Data
    description: Instruments, currencies, tickers, and market-wide feeds.
  - name: Maker Scoring
    description: Maker programs, score breakdowns, and detailed scoring snapshots.
  - name: Referrals
    description: Referral codes and program performance.
  - name: Other
    description: Uncategorized.
paths:
  /public/get_subaccounts:
    post:
      tags:
        - Subaccounts
      summary: public/get_subaccounts
      description: >-
        Returns the wallet address and the sorted list of all subaccount IDs
        owned by that wallet. Yields an empty list if the wallet has no
        subaccounts. Public endpoint, no authentication required.
      operationId: public_get_subaccounts
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PublicGetSubaccountsRequest'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PrivateGetSubaccountsResponse'
        default:
          description: JSON-RPC error (see Error Codes)
components:
  schemas:
    PublicGetSubaccountsRequest:
      type: object
      required:
        - wallet
      properties:
        wallet:
          $ref: '#/components/schemas/Address'
    PrivateGetSubaccountsResponse:
      type: object
      required:
        - subaccount_ids
        - wallet
      properties:
        subaccount_ids:
          type: array
          items:
            type: integer
            format: uint64
            minimum: 0
        wallet:
          type: string
    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}$

````

## Related topics

- [Changelog](/changelog.md)
- [public/get_vaults](/api-reference/vault-shareholders/publicget_vaults.md)
- [public/get_vault](/api-reference/vault-shareholders/publicget_vault.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.