Skip to main content
POST
https://apis.hopnow.io
/
v1
/
accounts
/
{account_id}
/
wallets
Create Wallet
curl --request POST \
  --url https://apis.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>"
}

​
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 wlt_)
​
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": "wlt_1234567890abcdef",
  "object": "wallet",
  "account_id": "acc_1234567890abcdef",
  "currency": "USDC_ETHEREUM",
  "network": "ethereum",
  "addresses": [
    {
      "address": "0x1234567890abcdef1234567890abcdef12345678",
      "tag": null
    }
  ],
  "label": "Treasury USDC",
  "status": "active",
  "created": "2024-01-01T00:00:00Z",
  "updated": "2024-01-01T00:00:00Z"
}