---
title: "Simulate inbound transfer on a Deposit Address"
method: POST
path: "/deposit-addresses/{depositAddressId}/simulate/inbound-transfer"
tags: ["Sandbox"]
---

# Simulate inbound transfer on a Deposit Address

`POST /deposit-addresses/{depositAddressId}/simulate/inbound-transfer`

Simulate an inbound stablecoin (blockchain) transfer against a Deposit
Address, for testing webhook and reconciliation flows. Sandbox /
non-production only; returns 404 in production-live. The asset and
network are resolved server-side from the Deposit Address (limited to
ethereum, base, and solana); the caller supplies only the amount.

## Path parameters

- `depositAddressId` string, required

## Headers

- `Idempotency-Key` string, required

## Request body

- SimulateDaInboundTransferRequest — Request body for POST /deposit-addresses/{id}/simulate/inbound-transfer.
  - `amount` string, required — Wire-safe decimal string for financial float values (USD amounts, percentages).

## Response `200`

The request has succeeded.

- SimulateDaInboundTransferResponse — Response for POST /deposit-addresses/{id}/simulate/inbound-transfer.
  - `depositAddressId` string, required — Public TypeID, e.g. `txn_01h455vb4pex5vsknk084sn02q`; legacy UUID suffixes are accepted until non-v7 rows are retired.
  - `asset` 'usdc' | 'usdt' | 'usat', required — Stablecoin currency code accepted for inbound blockchain transfers.
  - `network` 'base' | 'ethereum' | 'solana', required — Blockchain network for inbound Deposit Address transfers. Narrowed to the serviceable subset (base, ethereum, solana); there is no Polygon synthesis. Lowercase, matching how `DepositAddress.expectedSourceNetwork` is cased on the wire.
  - `amount` string, required — Wire-safe decimal string for financial float values (USD amounts, percentages).
  - `status` 'submitted', required — Always "submitted"; sandbox blockchain inbounds settle synchronously.
  - `submittedAt` string, date-time, required — When the simulated transfer was submitted.
  - `transactionHash` string, required — Synthetic on-chain transaction hash for webhook correlation.

---

[API](https://skmtc.net/polygon-technology/apis/polygon-oms-public-api.md) · [All operations](https://skmtc.net/polygon-technology/apis/polygon-oms-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/polygon-technology/polygon-oms-public-api/revisions/18fdaebf64e5/schema)
