Fund a test balance
Simulate a crypto deposit into an account’s provisioned deposit address.
Credits the ledger immediately and returns a COMPLETED CRYPTO_PAYIN
transaction — no real on-chain transfer is required. Use it to fund test
accounts and exercise the full pay-in → balance → pay-out loop.
Sandbox only. In production this endpoint returns 404 not_found as if
it did not exist. The asset must already be activated on the account (so a
deposit address exists on chainName).
Headers
Bearer token. Format: Bearer <api_key>
Unique key per logical operation. UUID v4 recommended. Max 255 characters.
Body
Request body for funding a test balance via the sandbox faucet.
Account to credit.
Asset code to deposit (e.g. USDC, USDT).
Deposit amount in major units (e.g. "10000.00").
Chain the account's deposit address lives on. Sandbox chains: ETHEREUM_SEPOLIA, ARBITRUM_SEPOLIA, BASE_SEPOLIA, BSC_TESTNET, SOLANA_DEVNET, TRON_NILE.
Response
The request has succeeded.
A simulated crypto deposit produced by the sandbox faucet.
Object type. Always transaction.
transaction Unique transaction identifier.
Transaction type. Always CRYPTO_PAYIN.
CRYPTO_PAYIN Transaction status. Always COMPLETED — the simulated deposit is credited immediately.
COMPLETED Credited account.
Deposit amount in major units.
Asset code.
Chain the deposit was simulated on.
When the transaction was created.