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>"
}

Documentation Index

Fetch the complete documentation index at: https://apidocs.hopnow.io/llms.txt

Use this file to discover all available pages before exploring further.

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"
}