Wallets and top-ups
Every team has a wallet. Top it up with USDT, ETH or SOL on Base or Solana, and every request is paid from its balance, per token.
How the wallet works
Your wallet holds a balance in USD terms. Each request reserves its estimated cost, then settles the exact amount when the response finishes. Unused reservations are released instantly.
Top up
- 01
Open the wallet
In the dashboard, open Wallet and choose Top up. Pick a currency and a chain.
- 02
Send funds
Send to your team's deposit address. It is unique to your team and never changes, so you can save it in your own wallet.
- 03
Wait for confirmations
Funds are credited after the confirmations below. You get an email and a
wallet.creditedwebhook when they land.
| Currency | Chains | Credited after | Typical time | Minimum |
|---|---|---|---|---|
| USDT | Base, Solana | 3 blocks on Base, finalized on Solana | 6 s to 13 s | $5 |
| ETH | Base | 3 blocks | 6 s | $5 |
| SOL | Solana | Finalized | 13 s | $5 |
| TOPO | Base, Solana | 3 blocks on Base, finalized on Solana | 6 s to 13 s | $5 |
Check your balance
curl https://api.topolabs.ai/v1/wallet \ -H "Authorization: Bearer $TOPO_API_KEY"{ "object": "wallet", "balance": "2418.52", "currency": "USDT", "reserved": "1.84", "spend_30d": "1206.14", "default_pay_with": "usdt", "deposit_addresses": { "base": "0x8f3a…c21e", "solana": "7xKq…p3Vd" }}Auto top-up
Connect a wallet and approve a USDT allowance to top up automatically when your balance drops below a threshold. You choose the threshold, the top-up amount and a monthly cap.