Create Wallet
POST /v1/wallets/{account_id}
Creates a new wallet for the specified account. The wallet is created on the specified chain and initially assigned to the given network.
Headers
| Header | Required | Value |
|---|---|---|
Authorization | Yes | Bearer <token> |
Content-Type | Yes | application/json |
X-Target-Server | Yes | wallets |
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
account_id | string (UUID) | Yes | Account ID to create the wallet under |
Request Body
| Field | Type | Required | Validation | Description |
|---|---|---|---|---|
name | string | Yes | min: 2, max: 255 | Wallet name |
type | string | Yes | hot or cold | Wallet type |
chain_id | string (UUID) | Yes | Valid UUID | Chain to create the wallet on |
network_id | string (UUID) | Yes | Valid UUID | Initial network to assign |
{
"name": "My Hot Wallet",
"type": "hot",
"chain_id": "550e8400-e29b-41d4-a716-446655440000",
"network_id": "770e8400-e29b-41d4-a716-446655440000"
}
Response
201 Created
Wallet created successfully. No response body.
note
Wallet creation is an asynchronous process. The wallet address is generated by the custody service and may take a moment to become available.
400 Bad Request
401 Unauthorized
404 Not Found
Account not found.