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

# Create Multi-Currency Wallets (End User)

> Create USD and NGN wallets for an end-user entity in one call.

## Overview

Use this after creating an end-user account. Provide the `entityId` (account.id) and set `walletType: USER` to create both USD and NGN wallets.

## Endpoint

* `POST {{LIQUIDITY_URL}}/v1/ext/wallet/create`
* Auth: Bearer `{{accessToken}}`

## Request

```bash theme={null}
curl -X POST "{{LIQUIDITY_URL}}/v1/ext/wallet/create" \
  -H "Authorization: Bearer {{accessToken}}" \
  -H "Content-Type: application/json" \
  -d '{
    "entityId": "{{entityId}}",
    "walletType": "USER"
  }'
```

### Fields

| Field        | Type   | Description                     | Required |
| ------------ | ------ | ------------------------------- | -------- |
| `entityId`   | string | Entity ID from account creation | Yes      |
| `walletType` | string | Use `USER` for end-user wallets | Yes      |

## Response (200)

```json theme={null}
{
  "message": "Wallets created",
  "wallets": [
    {
      "id": "97500af1-0964-419e-9ed6-3a3aeb1285bc",
      "currency": "NGN",
      "balance": "0",
      "permissions": { "permissionType": "OWNER", "permissionFlowType": "ALL" }
    },
    {
      "id": "af520cb7-5205-4cfb-ab50-ab4802a488fd",
      "currency": "USD",
      "balance": "0",
      "permissions": { "permissionType": "OWNER", "permissionFlowType": "ALL" }
    }
  ]
}
```

## Notes

* Creates both USD and NGN wallets for the entity.
* For collection vs spend wallets, use the multi-currency retrieval endpoint with `type` = `collection` or `spend`.
