Simulate static wallet deposit

POST/v1/static-wallets/{staticWalletId}/simulate

Drive a synthetic deposit through its lifecycle (no on-chain activity, no balance credit). Available for test-coin assets only.

Example request

A minimal request you can copy and run.

curl -X POST https://api.suward.com/v1/static-wallets/<static_wallet_id>/simulate \
  -H "X-Api-Key: $SUWARD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount":"1000000","asset":"USDT_ETHEREUM"}'

Path Parameters

Name	Type	Required	Description
staticWalletId	string	yes	Static wallet ID

Request body

Name	Type	Required	Description
amount	string	no	Deposited amount to simulate, an integer string in the asset's smallest unit (see CreatePaymentRequest.amount).
asset		no	Asset id-string of the simulated deposit (see GET /v1/assets), e.g. USDT_ARBITRUM.
status		no	Target lifecycle stage to drive the simulated deposit to.
transferIndex	string	no	Optional index of the transfer within the transaction, as a string-encoded integer.
txHash	string	no	Optional synthetic transaction hash; a random one is generated when omitted.

Request · JSON

{
  "amount": "1000000",
  "asset": "USDT_ETHEREUM"
}

Response

Name	Type	Required	Description
acceptedAt	integer	no	Unix-milliseconds timestamp when the deposit reached the accepted (safe confirmations) tier. Null before acceptance.
address	string	no	On-chain address that received the deposit (the static wallet's address).
amount	string	no	Gross deposited amount, an integer string in the asset's smallest unit (see CreatePaymentRequest.amount).
asset		no	Asset of the deposit, as an asset id-string (see GET /v1/assets).
confirmedAt	integer	no	Unix-milliseconds timestamp when the deposit reached finality (confirmed). Null before confirmation.
createdAt	integer	no	Unix-milliseconds timestamp when the deposit record was created.
detectedAt	integer	no	Unix-milliseconds timestamp when the deposit was first detected on-chain.
externalId	string	no	ExternalID is the static wallet's externalId, denormalized onto the deposit.
fee	string	no	Platform fee on this deposit, integer string in the asset's smallest unit: max(0.4% of the amount, $1 equivalent). The $1 floor is 0 for assets without a published USD price.
id	string	no	Unique Suward identifier of the deposit.
invalidatedAt	integer	no	Unix-milliseconds timestamp when the deposit was invalidated (e.g. dropped by a chain reorg). Null unless invalidated.
netAmount	string	no	Amount credited to the merchant after fees (amount - fee - networkFee), integer string in the asset's smallest unit.
networkFee	string	no	Estimated on-chain (gas) cost deducted from the deposit, integer string in the asset's smallest unit.
projectId	string	no	Identifier of the project that owns this deposit.
staticWalletId	string	no	Identifier of the static wallet that received this deposit.
status		no	Deposit lifecycle status. detected: seen on-chain, awaiting confirmations. accepted: safe confirmations reached, credited (non-final). confirmed: finalized (terminal). ignored: the asset is not on the wallet's allow-list, so the deposit is not credited. invalidated: dropped after detection, e.g. by a chain reorg.
transferIndex	string	no	Index of this transfer within its transaction, as a string-encoded integer. Distinguishes multiple transfers to the same address in one transaction.
txHash	string	no	On-chain transaction hash of the deposit.
updatedAt	integer	no	Unix-milliseconds timestamp when the deposit was last updated.

Response · JSON

{
  "acceptedAt": 0,
  "address": "0xabc…def",
  "amount": "100000000",
  "asset": "USDT_ETHEREUM",
  "confirmedAt": 0,
  "createdAt": 0,
  "detectedAt": 0,
  "externalId": "order_abc123",
  "fee": "1000000",
  "id": "obj_abc123",
  "invalidatedAt": 0,
  "netAmount": "100000000",
  "networkFee": "150000",
  "projectId": "obj_abc123",
  "staticWalletId": "obj_abc123",
  "status": "detected",
  "transferIndex": "0",
  "txHash": "0x1234…abcd",
  "updatedAt": 0
}

Get static wallet deposit