Skip to main content
POST
Simulate inbound transfer on a Deposit Address

Authorizations

Authorization
string
header
required

Token from POST /auth/token

Headers

Idempotency-Key
string
required

Required on POST and PUT requests. Use a unique value per logical mutation attempt, for example a UUID.

Path Parameters

depositAddressId
string
required

Body

application/json

Request body for POST /deposit-addresses/{id}/simulate/inbound-transfer.

amount
string
required

Must be greater than 0.00 and at most 1000.00 (422 simulationAmountOutOfRange beyond).

Response

200 - application/json

The request has succeeded.

Response for POST /deposit-addresses/{id}/simulate/inbound-transfer.

depositAddressId
string
required

The Deposit Address that received the simulated transfer (da_ prefix).

Pattern: ^[a-z]+_([0-9a-hjkmnp-tv-z]{26}|[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})$
asset
enum<string>
required

The stablecoin that was received, resolved from the Deposit Address.

Available options:
usdc,
usdt,
usat
network
enum<string>
required

The blockchain network the transfer settled on, resolved from the Deposit Address.

Available options:
base,
ethereum,
solana
amount
string
required

The simulated transfer amount.

status
enum<string>
required

Always "submitted"; sandbox blockchain inbounds settle synchronously.

Available options:
submitted
submittedAt
string<date-time>
required

When the simulated transfer was submitted.

transactionHash
string
required

Synthetic on-chain transaction hash for webhook correlation.