---
title: 'List incoming deposits to managed wallets'
description: 'A new endpoint and MCP tool list the stablecoin deposits that land in a managed wallet, and the wallet.inbound webhook now carries the deposit id and transaction hash.'
date: 2026-10-15
category: Product Update
categoryType: update
contributors:
  - ericViana
isChangelog: true
---

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

<!--more-->

## 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:

| Status | Meaning |
| --- | --- |
| `processing` | The deposit arrived and is still being checked |
| `completed` | The deposit is final |
| `on_hold` | The funds are held and cannot be spent yet |
| `refunded` | The 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.
