Skip to main content
POST
/
v1
/
accounts
/
{account_id}
/
wallets
Create Wallet
curl --request POST \
  --url https://api.hopnow.io/v1/accounts/{account_id}/wallets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "currency": "<string>",
  "network": "<string>",
  "label": "<string>"
}
'
{
  "id": "<string>",
  "object": "<string>",
  "account_id": "<string>",
  "currency": "<string>",
  "network": "<string>",
  "addresses": [
    {
      "address": "<string>",
      "tag": "<string>"
    }
  ],
  "label": "<string>",
  "status": "<string>",
  "created": "<string>",
  "updated": "<string>"
}
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

CurrencyNetworkNotes
USDCsolana_devnetFully functional — use a faucet to test deposits
USDTsolana_devnetDeposit PYUSD on Solana Devnet (temporary workaround)
One wallet is allowed per currency + network combination. Attempting to create a duplicate returns an error.

​
Path Parameters

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

​
Request Body

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

​
Response

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

​
Response Example

{
  "id": "wal_fxnw87105mc1vuru4q8yzrez",
  "object": "wallet",
  "account_id": "acct_ka44qsvpo8q3wtzuwfqf0h6u",
  "currency": "USDT",
  "network": "solana_devnet",
  "addresses": [
    {
      "address": "C4bhocDFYFtK8fMypf31Frez7mztiim6PNvgDFbFQBLN",
      "tag": null
    }
  ],
  "label": "Treasury USDT Wallet",
  "status": "active",
  "created": "2024-01-01T00:00:00Z",
  "updated": "2024-01-01T00:00:00Z"
}