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

# Create wallet

> Create a new wallet on a given blockchain.

Creates a new wallet on a specific blockchain for the treasury account. Requires an API key with access level 2 or higher.

## Path parameters

<ParamField path="accountId" type="string" required>
  The treasury account ID.
</ParamField>

## Body

<ParamField body="alias" type="string" required>
  Friendly alias name for the wallet.
</ParamField>

<ParamField body="blockchain" type="string" required>
  Blockchain network. One of `ETHEREUM`, `POLYGON`, `BSC`, `ARBITRUM`, `OPTIMISM`, `BASE`, `AVALANCHE`.
</ParamField>

## Response

<ResponseField name="id" type="string">
  Unique wallet identifier.
</ResponseField>

<ResponseField name="alias" type="string">
  Friendly alias name for the wallet.
</ResponseField>

<ResponseField name="wallet_address" type="string">
  Blockchain wallet address.
</ResponseField>

<ResponseField name="blockchain" type="string">
  Blockchain network.
</ResponseField>

<ResponseField name="enabled" type="boolean">
  Whether the wallet is enabled for transactions.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.cryptomate.me/mpc/accounts/acc_6f1e2a30-4a3c-4b2e-9a1d-5e8c9b7a1f23/wallets/create" \
    -H "x-api-key: $CRYPTOMATE_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "alias": "Primary Polygon Wallet",
      "blockchain": "POLYGON"
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "id": "wallet_a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
    "alias": "Primary Polygon Wallet",
    "wallet_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
    "blockchain": "POLYGON",
    "enabled": true
  }
  ```

  ```json 412 Precondition Failed theme={null}
  {
    "code": "VAL",
    "message": "The current limit for this product has been reached. Please increase the limit."
  }
  ```
</ResponseExample>
