> ## 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 End User Wallets

A guide for creating multi-currency wallets (USD & NGN) for an end-user entity using their `entityId` from Account Service.

## Endpoint

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

## Request Body

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

## Example Request

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

## Success Response (200)

```json theme={null}
{
  "message": "Wallets created",
  "wallets": [
    {
      "id": "97500af1-0964-419e-9ed6-3a3aeb1285bc",
      "slug": "NGN Wallet",
      "currency": "NGN",
      "balance": "0",
      "permissions": { "permissionType": "OWNER", "permissionFlowType": "ALL" },
      "settings": {
        "walletType": "USER",
        "approvalThreshold": 1,
        "displayCurrency": "NGN",
        "fundingCurrencies": ["USD", "NGN"],
        "withdrawalCurrencies": ["USD", "NGN"],
        "showBalance": true
      }
    },
    {
      "id": "af520cb7-5205-4cfb-ab50-ab4802a488fd",
      "slug": "USD Wallet",
      "currency": "USD",
      "balance": "0",
      "permissions": { "permissionType": "OWNER", "permissionFlowType": "ALL" },
      "settings": {
        "walletType": "USER",
        "approvalThreshold": 1,
        "displayCurrency": "USD",
        "fundingCurrencies": ["USD", "NGN"],
        "withdrawalCurrencies": ["USD", "NGN"],
        "showBalance": true
      }
    }
  ]
}
```

## Notes

* Creates both USD and NGN wallets for the specified entity.
* Use `walletType: USER` for end users; corporate/business wallets may use other types.