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

# Create Wallet

> Create a new cryptocurrency wallet

<Note>
  Wallets are for **crypto deposits only**. For fiat deposits (USD, EUR, etc.), use [Deposit Instructions](/fx/api-reference/deposit-instructions/list-deposit-instructions) instead. See the [Deposit Flows](/fx/guides/deposit-flows) guide for a complete overview.
</Note>

### Supported Currency and Network Combinations

<Tabs>
  <Tab title="Sandbox">
    | Currency | Network         | Notes                                                 |
    | -------- | --------------- | ----------------------------------------------------- |
    | `USDC`   | `solana_devnet` | Fully functional — use a faucet to test deposits      |
    | `USDT`   | `solana_devnet` | Deposit PYUSD on Solana Devnet (temporary workaround) |
  </Tab>

  <Tab title="Production">
    | Currency | Network    |
    | -------- | ---------- |
    | `USDC`   | `ethereum` |
    | `USDC`   | `solana`   |
    | `USDT`   | `ethereum` |
    | `USDT`   | `solana`   |
  </Tab>
</Tabs>

<Warning>
  One wallet is allowed per currency + network combination. Attempting to create a duplicate returns an error.
</Warning>

## Path Parameters

<ParamField path="account_id" type="string" required>
  The account's external ID (starts with `acc_`)
</ParamField>

## Request Body

<ParamField body="currency" type="string" required>
  Cryptocurrency currency code (e.g., USDC\_ETHEREUM, BTC, ETH)
</ParamField>

<ParamField body="network" type="string" required>
  Blockchain network identifier (e.g., ethereum, bitcoin, polygon)
</ParamField>

<ParamField body="label" type="string" required>
  User-friendly label for the wallet (max 255 characters)
</ParamField>

## Response

<ResponseField name="id" type="string">
  Wallet identifier (starts with `wal_`)
</ResponseField>

<ResponseField name="object" type="string">
  Always returns `"wallet"`
</ResponseField>

<ResponseField name="account_id" type="string">
  Parent account ID
</ResponseField>

<ResponseField name="currency" type="string">
  Cryptocurrency currency
</ResponseField>

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

<ResponseField name="address" type="string">
  On-chain wallet address
</ResponseField>

<ResponseField name="label" type="string">
  User-friendly label
</ResponseField>

<ResponseField name="status" type="string">
  Wallet status: `active`, `suspended`, or `inactive`
</ResponseField>

<ResponseField name="created" type="string">
  ISO 8601 timestamp when created
</ResponseField>

<ResponseField name="updated" type="string">
  ISO 8601 timestamp when last updated
</ResponseField>

## Response Example

```json theme={null}
{
  "id": "wal_fxnw87105mc1vuru4q8yzrez",
  "object": "wallet",
  "account_id": "acct_ka44qsvpo8q3wtzuwfqf0h6u",
  "currency": "USDT",
  "network": "solana_devnet",
  "address": "C4bhocDFYFtK8fMypf31Frez7mztiim6PNvgDFbFQBLN",
  "label": "Treasury USDT Wallet",
  "status": "active",
  "created": "2024-01-01T00:00:00Z",
  "updated": "2024-01-01T00:00:00Z"
}
```