Deposit Status Webhooks & GET /deposits/crypto Endpoints

Release Details

Release Date: April 29, 2026

Release Type

Informational, no action required from platforms

Summary

zerohash has launched real-time webhooks and new REST endpoints for blockchain deposits. Platforms can now subscribe to deposit state change notifications and query deposit records directly, eliminating the need to poll for status updates.

Use Case

Platforms tracking blockchain deposits now have a consistent view of deposit state across push (webhook) and pull (REST) access patterns, with both surfaces returning the same canonical data model.

What's New

Deposit Status Webhooks

Deposit status webhooks emit a signed notification on every state transition (i.e. PENDING, CONFIRMED, CREDITED) with a consistent payload, including:

deposit_id - unique deposit identifier
state - current deposit state
participant_code, account_id - account identifiers
asset, amount - deposit asset and amount
transaction_hash, received_address, source_address - on-chain transaction details
timestamp - time of the state change

New REST Endpoints for Deposit Records

In addition, two new public REST endpoints are available for querying deposit records:

GET /deposits/crypto/{deposit_id} - retrieve a single deposit record by its ID
GET /deposits/crypto - retrieve a paginated list of deposit records, with optional filters for deposit IDs, account IDs / account groups, transaction hashes, assets, deposit states, and time range (from / to timestamps)

Please reach out to your zerohash contact if you have any questions.