Go Back

List incoming deposits to managed wallets

Eric Viana
Eric Viana
•

You can now list every stablecoin deposit that lands in a managed wallet, from the API, the MCP server and the dashboard.

New endpoint

GET /v1/instances/{instance_id}/customers/{customer_id}/wallets/{id}/deposits returns the wallet's incoming deposits, newest first, with cursor pagination (starting_after, ending_before, limit). Filter by token or status.

Each deposit includes the network, token, amount in cents, the exact token_amount as a decimal string, the sender address and the transaction hash. status is one of:

StatusMeaning
processingThe deposit arrived and is still being checked
completedThe deposit is final
on_holdThe funds are held and cannot be spent yet
refundedThe deposit was returned to the sender

The MCP server exposes it as GetV1InstancesCustomersWalletsDeposits. The dashboard shows the list in the wallet pane.

History starts on October 9, 2026. Deposits from before that date are not listed.

Webhook

wallet.inbound now includes deposit_id, which matches the id in the deposits list, and transaction_hash. Both fields are additive.

Sandbox

Development instances now record USDB deposits to managed wallets and send wallet.inbound for them, so you can test the list end to end in sandbox.