Skip to main content

Create Crypto Wallet

Deprecated

This endpoint is deprecated. Use POST /v3/crypto/wallets. It keeps working for now, and its responses carry Deprecation: true and a Link header naming the v3 page; BlockWyre will tell you the date before it stops, from when it answers 410 Gone. See Crypto v3.

This endpoint creates a new cryptocurrency wallet for the specified currency.

Technical Details​

  • Webhooks: This operation triggers the crypto_wallet_created webhook.
Authorization:

Every request is signed with your API key: a short-lived JWT, signed with your private key, sent in one header on /v3/* and /api/v2/* alike.

Headers:
Authorization: APIKey {SIGNED_JWT}

How to build and sign the JWT: Authentication.

Endpoint

POST

/api/v2/crypto/wallets

Request Body Sample​

{
"accountId": "00000000-0000-0000-0000-000000000000",
"coin": "BTC",
"label": "My Bitcoin Wallet"
}

Request Body Schema​

FieldTypeDescription
accountIdstringRequired. Account ID to associate the wallet with.
coinstringRequired. Cryptocurrency coin ID (e.g., BTC, ETH, USDT).
labelstringOptional. Label for the wallet.

Response Sample​

{
"id": "00000000-0000-0000-0000-000000000000",
"accountId": "00000000-0000-0000-0000-000000000000",
"address": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
"coin": "BTC",
"status": "active",
"label": "My Bitcoin Wallet",
"createdAt": "2025-01-01T00:00:00Z",
"updatedAt": "2025-01-01T00:00:00Z"
}

Errors​

StatusMessageMeaning
409wallet_already_existsThe account already has an active wallet for this coin.
409wallet_address_in_useThe wallet's deposit address is already registered.
409crypto_operation_unsupportedThe provider the workspace uses for this coin cannot create wallets.

Support and Resources​

If you need assistance or have any questions, our support team is here to help. You can contact our support team at support@blockwyre.com.

Stay Updated​

Stay up-to-date with the latest news, updates, and features from BlockWyre by following us on social media:

We are excited to have you on board and look forward to seeing how you leverage BlockWyre's powerful tools to enhance your financial operations. Happy integrating!