> ## Documentation Index
> Fetch the complete documentation index at: https://hedera-0c6e0218-mintlify-bc559771.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Account Plugin

> Hiero CLI Account plugin commands for creating, importing, listing, and inspecting Hedera accounts, plus checking balances and managing account aliases.

## Most Used Commands

**Create a new account**

```sh theme={null}
hcli account create \
  --balance 1 \
  --name <account-name>
```

**Check an account balance**

```sh theme={null}
hcli account balance --account myaccount
```

**List all accounts**

```sh theme={null}
hcli account list
```

## Full Command Reference

<Accordion title="Account Create">
  Creates a new Hedera account.

  <ResponseField name="-b, --balance" type="string" required>
    Initial HBAR balance. Default: display units. Add "t" for Tinybar units <br />
    `--balance 10`   --> 10 HBAR <br />
    `--balance 100t` --> 100 Tinybars
  </ResponseField>

  <ResponseField name="-a, --auto-associations" type="int">
    The maximum number of automatic association tokens allowed <br />
    Default value set to 0
  </ResponseField>

  <ResponseField name="-n, --name" type="string">
    Alias of the created account to be used
  </ResponseField>

  <ResponseField name="-k, --key-manager" type="string">
    Key manager to use: `local` or `local_encrypted` (defaults to config setting) <br />
  </ResponseField>

  <ResponseField name="-t, --key-type" type="string(ecdsa|ed25519)">
    Key type for the account. Default: ecdsa. Mutually exclusive with `--key`.
  </ResponseField>

  <ResponseField name="-K, --key" type="string">
    Existing key for the new account (ecdsa/ed25519 private or public key, key reference `kr_xxx`, or alias name). Mutually exclusive with `--key-type`.
  </ResponseField>
</Accordion>

<Accordion title="Account Update">
  Update properties of an existing Hedera account on-chain.

  <ResponseField name="-a, --account" type="string" required>
    Account ID or alias of the account to update
  </ResponseField>

  <ResponseField name="-K, --key" type="string">
    New key for the account (private/public key, key reference, or alias). Requires private key in KMS.
  </ResponseField>

  <ResponseField name="-k, --key-manager" type="string">
    Key manager to use: `local` or `local_encrypted` (defaults to config setting)
  </ResponseField>

  <ResponseField name="-m, --memo" type="string">
    Account memo (max 100 characters). Pass `null` to clear.
  </ResponseField>

  <ResponseField name="--max-auto-associations" type="number">
    Max automatic token associations (-1 for unlimited, 0 to disable)
  </ResponseField>

  <ResponseField name="--staked-account-id" type="string">
    Account ID to stake to. Pass `null` to clear.
  </ResponseField>

  <ResponseField name="--staked-node-id" type="number">
    Node ID to stake to. Pass `null` to clear.
  </ResponseField>

  <ResponseField name="--decline-staking-reward" type="boolean">
    Decline staking reward
  </ResponseField>

  <ResponseField name="--auto-renew-period" type="number">
    Auto renew period in seconds
  </ResponseField>

  <ResponseField name="--receiver-signature-required" type="boolean">
    Require receiver signature for transfers
  </ResponseField>
</Accordion>

<Accordion title="Account Import">
  Import an existing account into the CLI tool. Provide `accountId:privateKey` format.

  <ResponseField name="-K, --key" type="string" required>
    Specify the private key in `accountId:privateKey` format (e.g., "`0.0.123456:abc123...`")
  </ResponseField>

  <ResponseField name="-n, --name" type="string">
    Name of the account to be used
  </ResponseField>

  <ResponseField name="-k, --key-manager" type="string">
    Key manager to use: `local` or `local_encrypted` (defaults to config setting) <br />
  </ResponseField>
</Accordion>

<Accordion title="Account Balance">
  Retrieve the balance for an account ID or name.

  <ResponseField name="-a, --account" type="string" required>
    Account ID, alias or name of the account present in state
  </ResponseField>

  <ResponseField name="-H, --hbar-only">
    Show only HBAR balance
  </ResponseField>

  <ResponseField name="-t, --token" type="string">
    Show balance for specific token ID, specify token ID or name
  </ResponseField>

  <ResponseField name="-r, --raw">
    Display balances in raw units (tinybars for HBAR, base units for tokens)
  </ResponseField>
</Accordion>

<Accordion title="Account List">
  List all accounts stored in the address book.

  <ResponseField name="-p, --private">
    Include private keys reference ID in listing. This is not the actual private key!
  </ResponseField>
</Accordion>

<Accordion title="Account View">
  View detailed information about an account.

  <ResponseField name="-a, --account" type="string" required>
    View data for account ID or name of the account present in state.
  </ResponseField>
</Accordion>

<Accordion title="Account Clear">
  Remove all account information from the address book.
</Accordion>

<Accordion title="Account Delete">
  Delete an account on Hedera and remove it from local state if present, or remove from local state only with `--state-only`. On-chain delete requires `--transfer-id` for the beneficiary account.

  <ResponseField name="-a, --account" type="string" required>
    With `--state-only`: Hedera account ID or local alias. Otherwise: account key (ID, `id:private key`, key reference, alias with stored key, etc.)
  </ResponseField>

  <ResponseField name="-t, --transfer-id" type="string">
    Required when deleting on Hedera: account that receives remaining HBAR (Hedera ID or alias). Mutually exclusive with `--state-only`.
  </ResponseField>

  <ResponseField name="-s, --state-only">
    Remove the account only from local CLI state. Do not submit AccountDeleteTransaction. Mutually exclusive with `--transfer-id`.
  </ResponseField>
</Accordion>