Deposit lifecycle.
Read finalized deposit records, held amounts, processing fees and journal references. Gated testnet receiving is implemented; actual custody/RPC verification remains pending.
01Finality and identity
Independent RPC providers must agree on finalized EVM or solidified TRON blocks, complete receipts and native-transfer data. Contract, decimals, network, recipient and execution success are checked before posting.
02Held and available
Supported external funds are recognized as held customer liabilities. Approved deposit fees and net available funds are posted only when receiving and tariff checks pass. A 100 USDC deposit with a 0.30% tariff releases 99.70 USDC and records 0.30 USDC in fees.
03History and pagination
Use an authenticated workspace session. Filter by walletId, environment or state; pass nextCursor as before to fetch older records. Atomic amounts are strings. Each record identifies rpc, test_fixture or unknown evidence; a fixture is never proof of a live deposit.
04Review and recovery
Inactive receiving, unavailable tariffs and dust remain held for review. Unsupported assets retain raw observations without spendable credit. Operators can queue a recheck; only the worker can revalidate and release funds. Wrong-network recovery, pre-finality observations and incident resolution remain in progress.
GET /v1/workspaces/{workspaceId}/deposits?environment=testnet&walletId=<uuid>
GET /v1/workspaces/{workspaceId}/deposits?before=<nextCursor>
// status: credited | confirmed_held | review_required | retry_queued
// amountAtomic: gross supported amount, or null for unsupported precision
// netAmountAtomic and processingFeeAtomic: populated after release
// recognitionJournalId and releaseJournalId: financial trace
// There is no client deposit-credit endpoint.Open your workspace