Skip to main content

Get a Deposit Wallet

One deposit wallet, by id. A wallet created through v2 can be read too, by its id in TypeID form.

Beta

Part of crypto v3, in beta. This endpoint is open whether or not crypto v3 is enabled for the workspace.

A workspace-scoped key reads any wallet of the workspace; an account-scoped key reads only its own account's, and another account's reads as 404.

Replaces GET /api/v2/crypto/wallets/{id}.

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

GET

/v3/crypto/wallets/{wallet_id}

Path parameters​

ParameterTypeDescription
wallet_idstring (wlt_…)Required. The wallet.

Query parameters​

ParameterTypeDescription
includestringcustomer adds the holder's customer object.

Response Sample​

{
"id": "wlt_01k8y2c7d3e5f7g9h1j3k5m7n9",
"customer_id": "cst_01h455vb4pex5vsknk084sn02q",
"coin": "BTC",
"address": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
"label": "Savings",
"status": "active",
"created_at": "2026-10-20T14:10:42Z",
"updated_at": "2026-10-20T14:10:42Z"
}

Response Schema​

The wallet, with the fields of a List Deposit Wallets row.

Errors​

StatusmessageWhen
400failed to parse requestwallet_id is not a wlt_… id, or include is not customer.
401unauthorizedMissing or invalid signature.
404wallet_not_foundNo such wallet, it belongs to another account, or the id is a counterparty's. With include=customer, also when the wallet's account was deleted.

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!