Fund the wallet
- Fetch
GET /v2/wallets/{id}and select the returneddepositAddressesentry for your funding network. See Supported Chains for accepted stablecoins and network keys. - Send the supported stablecoin to that address on the selected network. In the portal, open Deposit funds and select the blockchain.
- Track the deposit through the deposit APIs or webhooks until it reaches
completedand the wallet balance updates.
Address readiness
Supported EVM, Solana, TRON, and Stellar deposit addresses are prepared automatically when the wallet is created, independently of its allocation strategy. Stellar account activation and its USDC trustline run in the background. Its deposit address appears once both are ready and deposit monitoring is active. An address is usable once it appears indepositAddresses. Already returned addresses remain usable while setup continues for other networks.
An idle wallet can still be preparing addresses for additional networks. Poll Get Wallet while your intended network’s address is absent. Deposit only after that address appears in depositAddresses.
See Power Yield for Stellar Balances for the complete Stellar integration flow.
Always validate the token and network before sending. Use the returned address for that network, including when the same EVM address is returned on multiple chains. Supported Chains describes resource funding requirements.
On Tempo, send USDC.e only to
depositAddresses.tempo, not the wallet’s Ethereum address. Tempo is production-only. The API reports these deposits as token: "usdc", chain: "tempo", and, once completed, cashPositionId: "cash:tempo:usdc". Deposit monitoring runs every 60 seconds; allow additional time for confirmation and accounting.
Minimum amounts
There is no minimum deposit amount. Small deposits may remain as withdrawable cash until they can meet the automatic rebalance minimums. Yield sources and routes can impose additional minimums.Sandbox
Use the supported test token for the network-specific address, includingdepositAddresses.ethereum_sepolia, depositAddresses.solana_devnet, depositAddresses.stellar_testnet, or depositAddresses.tron_shasta. See Sandbox funding for faucets and test assets.
Deposit lifecycle
When a wallet has no active Ground-managed workflow, a supported-token transfer
can appear in deposit and activity APIs with
status: "processing" while Ground
checks it and waits for chain finality. During an active rebalance, withdrawal,
or protocol workflow, a deposit may appear only after Ground confirms that the
transfer is an external deposit and credits it.
A processing deposit has completedAt: null and is not included in
balance.totalUsd, balance.withdrawableUsd, or positions. After the transfer
reaches finality and Ground records it in the wallet’s accounting, its status
becomes completed and completedAt is populated. Its deposit id stays the same.
Wallets with automatic rebalancing deploy cash toward percentage targets.
Otherwise deposits stay in cash until the partner calls /allocate.
Deposit response
Ethereum Sepolia
Solana Devnet
Solana responses use base58 addresses and transaction signatures while preserving the same deposit shape:TRON
TRON deposits use the same response shape withtoken: "usdt", chain: "tron" (or "tron_shasta" in sandbox), and a TRON base58 fromAddress. Transaction hashes are hexadecimal without an EVM 0x prefix. Completed deposits identify cash as cash:tron:usdt or cash:tron_shasta:usdt; both belong to the usdt:tron group.
Stellar
Stellar deposits use the same response shape withtoken: "usdc", the environment’s Stellar chain key, and a Stellar G-address. Wait for the Stellar address to appear before sending funds.
List deposits
Fetch a deposit by ID
Look up by transaction hash
Deposit webhooks
Subscribe toportfolio_wallet.deposit.status_changed for real-time deposit tracking. See Webhooks.
Next steps
- Balances and Yield — track how deposits are allocated and earning yield
- Withdraw Funds — withdraw USDC or USDT from the wallet
- Webhooks — subscribe to deposit status events