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

# Sub-Accounts

> Overview of sub-account management endpoints for creating, managing, and configuring sub-accounts.

Sub-accounts enable creation and management of separate trading accounts under the main account. Control access with dedicated API keys, transfer funds between accounts, and monitor balances.

For general API conventions (base URL, error format, rate limits), see the [API Reference Overview](/api-reference/overview).

***

## Who uses this

Sub-accounts back the **partner-operated** integration model — see [Integration models](/concepts/integration-models) for the full comparison:

* **Model A — partner-operated sub-accounts.** The partner creates and manages one sub-account per end user under the master account and holds the sub-account API key. This is the account-operator and managed-trading-platform pattern, and the endpoints below implement it. See [Embedded Trading sub-account integration](/guides/sub-account-integration).
* **Model B — customers' own accounts (contrast).** The end user keeps a standalone WhiteBIT account and the partner connects through a [Fast API Key](/guides/fast-api-key-integration); sub-accounts are not used. Listed here so the choice between the two models is explicit.

***

## Account Management

<CardGroup cols={2}>
  <Card title="Create Sub-Account" icon="user-plus" href="/api-reference/sub-accounts/create-sub-account">
    Create a new sub-account
  </Card>

  <Card title="Delete Sub-Account" icon="user-minus" href="/api-reference/sub-accounts/delete-sub-account">
    Delete a sub-account
  </Card>

  <Card title="Edit Sub-Account" icon="user-pen" href="/api-reference/sub-accounts/edit-sub-account">
    Edit sub-account details
  </Card>

  <Card title="List of Sub-Accounts" icon="users" href="/api-reference/sub-accounts/list-of-sub-accounts">
    Get list of all sub-accounts
  </Card>

  <Card title="Block Sub-Account" icon="user-lock" href="/api-reference/sub-accounts/block-sub-account">
    Block a sub-account
  </Card>

  <Card title="Unblock Sub-Account" icon="user-check" href="/api-reference/sub-accounts/unblock-sub-account">
    Unblock a sub-account
  </Card>
</CardGroup>

***

## Balance & Transfers

<CardGroup cols={2}>
  <Card title="Sub-Account Transfer" icon="arrow-right-arrow-left" href="/api-reference/sub-accounts/sub-account-transfer">
    Transfer funds to/from sub-account
  </Card>

  <Card title="Sub-Account Balances" icon="wallet" href="/api-reference/sub-accounts/sub-account-balances">
    Get sub-account balances
  </Card>

  <Card title="Get Sub-Account Transfer History" icon="clock-rotate-left" href="/api-reference/sub-accounts/get-sub-account-transfer-history">
    Get sub-account transfer history
  </Card>
</CardGroup>

***

## Withdrawals

<CardGroup cols={2}>
  <Card title="List Unconfirmed Sub-Account Withdrawals" icon="clock" href="/api-reference/sub-accounts/list-unconfirmed-sub-account-withdrawals">
    List sub-account withdrawals awaiting main account confirmation
  </Card>

  <Card title="Confirm Sub-Account Withdrawal" icon="circle-check" href="/api-reference/sub-accounts/confirm-sub-account-withdrawal">
    Approve a pending sub-account withdrawal by transaction id
  </Card>
</CardGroup>

***

## API Key Management

<CardGroup cols={2}>
  <Card title="Create Sub-Account API Key" icon="key" href="/api-reference/sub-accounts/create-sub-account-api-key">
    Create API key for sub-account
  </Card>

  <Card title="Edit Sub-Account API Key" icon="pen-to-square" href="/api-reference/sub-accounts/edit-sub-account-api-key">
    Edit sub-account API key
  </Card>

  <Card title="Delete Sub-Account API Key" icon="trash" href="/api-reference/sub-accounts/delete-sub-account-api-key">
    Delete sub-account API key
  </Card>

  <Card title="List Sub-Account API Keys" icon="list" href="/api-reference/sub-accounts/list-sub-account-api-keys">
    List all sub-account API keys
  </Card>

  <Card title="Reset Sub-Account API Key" icon="rotate" href="/api-reference/sub-accounts/reset-sub-account-api-key">
    Reset sub-account API key
  </Card>

  <Card title="List Sub-Account API Key IP Addresses" icon="network-wired" href="/api-reference/sub-accounts/list-sub-account-api-key-ip-addresses">
    List IP addresses for API key
  </Card>

  <Card title="Create Sub-Account API Key IP Address" icon="plus" href="/api-reference/sub-accounts/create-sub-account-api-key-ip-address">
    Add IP address to API key whitelist
  </Card>

  <Card title="Delete Sub-Account API Key IP Address" icon="minus" href="/api-reference/sub-accounts/delete-sub-account-api-key-ip-address">
    Remove IP address from API key whitelist
  </Card>
</CardGroup>


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