---
title: "Create a Wallet"
method: POST
path: "/v2/wallet"
---

# Create a Wallet

`POST /v2/wallet`

Create a new wallet and associate it with a customer.

## Request body

- CreateWalletDto
  - `customerId` string, required — The unique identifier of the customer who owns this wallet.
  - `address` string, required — The wallet address on the specified network. Must be a valid address format for the network.
  - `network` 'arbitrum' | 'avalanche' | 'base' | 'ethereum' | 'polygon' | 'sol' | 'tron', required — The blockchain network for this wallet. Must be a supported crypto network.

## Response `201`

- WalletResponseDto
  - `id` string, required — The unique identifier of the wallet.
  - `address` string, required — The wallet address on the specified network.
  - `network` 'sol' | 'fogo' | 'ethereum' | 'arbitrum' | 'polygon' | 'base' | 'avalanche' | 'sui' | 'noble' | 'sei' | 'tron' | 'starknet' | 'aptos' | 'hyperliquid', required — The blockchain network for this wallet.
  - `customerId` string, required — The unique identifier of the customer who owns this wallet.
  - `created` string, required — The ISO 8601 timestamp when the wallet was created.
  - `updated` string, required — The ISO 8601 timestamp when the wallet was last updated.

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `422` — Unprocessable Entity - Validation Error

---

[API](https://skmtc.net/spherepay/apis/docs-spherepay-co.md) · [All operations](https://skmtc.net/spherepay/apis/docs-spherepay-co/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/spherepay/docs-spherepay-co/versions/4f3f5484aed3/schema)