Create Crypto Wallet
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_createdwebhook.
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
/api/v2/crypto/wallets
Request Body Sample
{
"accountId": "00000000-0000-0000-0000-000000000000",
"coin": "BTC",
"label": "My Bitcoin Wallet"
}
Request Body Schema
| Field | Type | Description |
|---|---|---|
accountId | string | Required. Account ID to associate the wallet with. |
coin | string | Required. Cryptocurrency coin ID (e.g., BTC, ETH, USDT). |
label | string | Optional. 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
| Status | Message | Meaning |
|---|---|---|
409 | wallet_already_exists | The account already has an active wallet for this coin. |
409 | wallet_address_in_use | The wallet's deposit address is already registered. |
409 | crypto_operation_unsupported | The 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:
- Instagram: BlockWyre Instagram
- Twitter: BlockWyre Twitter
- Facebook: BlockWyre Facebook
- LinkedIn: BlockWyre LinkedIn
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!