Skip to main content

Get a Crypto Deposit

One crypto deposit, by id, whether it was recorded through v2 or v3.

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 deposit of the workspace, or narrows to one account with account_id; an account-scoped key reads only its own account's, and another account's reads as 404.

Replaces Get Transaction Details for a crypto deposit.

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/deposits/{deposit_id}

Path parameters​

ParameterTypeDescription
deposit_idstring (wtx_…)Required. The deposit.

Query parameters​

ParameterTypeDescription
account_idstring (cst_…)Optional. Only find the deposit if it is this account's.

Response Sample​

{
"id": "wtx_01k9b2c4d6e8f0g2h4j6k8m0n2",
"account_id": "cst_01h455vb4pex5vsknk084sn02q",
"wallet_id": "wlt_01k8y4p6q8r0s2t4v6w8x0y2z4",
"status": "success",
"coin": "USDC",
"amount": "100",
"fee": "1.5",
"total": "98.5",
"address": "0x2c4e6a8b0d1f3a5c7e9b1d3f5a7c9e1b3d5f7a9c",
"tx_hash": "0x5e7a9c1b3d5f7a9c1e3b5d7f9a1c3e5b7d9f1a3c5e7b9d1f3a5c7e9b1d3f5a7c",
"provider": "fireblocks",
"external_id": "0b1c2d3e-4f5a-4b6c-8d7e-9f0a1b2c3d4e",
"created_at": "2026-10-20T15:12:44Z",
"updated_at": "2026-10-20T15:14:02Z"
}

Response Schema​

The deposit, with the fields described in List Crypto Deposits.

Errors​

StatusmessageWhen
400failed to parse requestdeposit_id is not a wtx_… id, or account_id is not a cst_… id.
401unauthorizedMissing or invalid signature.
403forbiddenAn account-scoped key named another account.
404deposit_not_foundNo such deposit, it belongs to another account, or the id is a withdrawal's.

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!