Skip to main content
POST
Create Wallet
Wallets are for crypto deposits only. For fiat deposits (USD, EUR, etc.), use Deposit Instructions instead. See the Deposit Flows guide for a complete overview.

Supported Currency and Network Combinations

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

Path Parameters

string
required
The account’s external ID (starts with acc_)

Request Body

string
required
Cryptocurrency currency code (e.g., USDC_ETHEREUM, BTC, ETH)
string
required
Blockchain network identifier (e.g., ethereum, bitcoin, polygon)
string
required
User-friendly label for the wallet (max 255 characters)

Response

string
Wallet identifier (starts with wal_)
string
Always returns "wallet"
string
Parent account ID
string
Cryptocurrency currency
string
Blockchain network
string
On-chain wallet address
string
User-friendly label
string
Wallet status: active, suspended, or inactive
string
ISO 8601 timestamp when created
string
ISO 8601 timestamp when last updated

Response Example