Skip to main content

​
Deposits & Webhooks

This is usually a temporary indexing delay. Use the Deposit Finder to manually trigger indexing:
  • Dashboard: Go to your Master Wallet → Overview → Click “Deposit Finder”
  • API: POST /v1/wallets/{walletId}/rescan/blocks with the transactionHash
Deposit Finder Documentation →
Webhook delays can occur due to blockchain network congestion, temporary node indexing delays, or your webhook endpoint returning errors.To check webhook logs:
  • Dashboard: Master Wallet → Developers → Webhook Logs
  • API: GET /v1/wallets/{walletId}/webhooks

​
Auto-Sweep

By default, disableAutoSweep is set to false, meaning auto-sweep is enabled. When a deposit arrives at a child address, it automatically sweeps to your master wallet.To keep funds in child addresses:
  • Set disableAutoSweep: true when creating the address via API
  • Or toggle Disable Auto Sweep in the address settings on the dashboard
Check both configuration levels:
  • Master wallet level — sets the default for all addresses
  • Address level — overrides the master wallet setting
The address-level setting always takes priority. Verify the specific address has disableAutoSweep: true.
Yes. You can configure sweep thresholds so funds only auto-sweep once a certain balance is reached.Wallet Configuration →

​
Gas Fees & Network Costs

Gas fees are paid directly to the blockchain in the native token:
ChainNative Token
Ethereum / Base / Polygon / etc.ETH
TronTRX
SolanaSOL
Blockradar does not charge additional fees on top of network costs.
Tron network fees are typically $1–6 per transaction due to how Tron handles bandwidth and energy. This is a blockchain-level cost, not a Blockradar charge.Lower-cost alternatives:
  • Solana: ~$0.01–0.30 per transaction
  • Base: ~$0.01–0.10 per transaction
  • Polygon: ~$0.01–0.10 per transaction
The /withdraw/network-fee endpoint returns a conservative estimate to ensure transactions succeed even during high network congestion. You are only charged the actual network fee, which is typically lower than the estimate.
No, blockchain gas fees must be paid in the chain’s native token. However, you can enable gasless withdrawals so your master wallet sponsors gas for child address transactions.

​
Gasless Transactions

When gasless is enabled, the master wallet pays gas fees on behalf of child address withdrawals.To enable:
  • Master wallet level: Dashboard → Master Wallet Settings → Enable Gasless Transactions
  • Address level: Set enableGaslessWithdraw: true when creating or updating an address
You can also set thresholds so only withdrawals above or below certain amounts are covered.Gasless Transactions → · Address Parameters →
It depends on the enableGaslessWithdraw setting:
  • Enabled (true): Master wallet pays gas
  • Disabled (false, default): Child address needs its own gas

​
Swaps & Bridges

Blockradar supports stablecoin-to-stablecoin swaps only: USDT, USDC, DAI, BUSD, cUSD, cNGN, EURC, IDRX.Native token swaps (e.g. USDT → TRX, USDC → ETH) are not supported.
This usually means the swap pair isn’t supported (e.g. swapping to a native token), or the amount is too small or too large for available liquidity.
This error usually means you’re using the wrong asset ID. You need to use the wallet-specific asset ID, not a general asset ID.To find the correct ID:
  • Dashboard: Go to your wallet → Assets → Copy the asset ID from there
  • API: Use the asset IDs returned from your wallet details endpoint
Yes. You can swap and bridge assets across different blockchains via the dashboard or API. For cross-chain swaps via API, pass the destination master wallet’s asset ID as the toAssetId.Swap Documentation →

​
Wallet Setup & Configuration

  • EVM chains (Ethereum, Base, Polygon, Arbitrum, Optimism, etc.): 1 wallet covers all
  • Tron (TRC20): Separate wallet required
  • Solana: Separate wallet required
No. Addresses cannot be deleted due to blockchain limitations. You can only deactivate them in the dashboard. Deactivated addresses won’t receive new deposits or be monitored.
Use the showPrivateKey: true parameter when fetching wallet or address details via API.
Only use this in secure, trusted environments.

​
Withdrawals & Transfers

Use the withdrawal API endpoint: POST /v1/wallets/{walletId}/addresses/{addressId}/withdrawWithdrawal Documentation →
Common causes:
  • Insufficient gas in the master wallet (if using gasless) or child address
  • Queue processing — transactions process sequentially due to blockchain nonces
  • Node issues — temporary delays
If stuck for more than 30 minutes, contact support with the transaction ID.
All on-chain fund movements use the withdrawal endpoint. There is no separate “transfer” endpoint.
  • Master to child: POST /v1/wallets/{walletId}/withdraw with child address as destination
  • Child to master: POST /v1/wallets/{walletId}/addresses/{addressId}/withdraw with master wallet address as destination
  • Child to external: Same endpoint, external address as destination
Withdrawal Documentation →
Use the transactions endpoint with the address query parameter:
    GET /v1/wallets/{walletId}/transactions?address={addressId}
Transactions Documentation →

​
Asset Recovery

Use Asset Recovery in the dashboard. Currently supported for master wallets only.Asset Recovery →
Blockradar only indexes stablecoins by design. Native token deposits (ETH, TRX, SOL, etc.) won’t appear in the dashboard transaction history. However, the funds are still in your wallet and can be viewed on the blockchain explorer or withdrawn via API or dashboard.

​
Testnet vs. Mainnet

No, your funds are not lost. Mainnet and testnet are separate networks, but addresses are cryptographically linked. You can recover funds using Asset Recovery.Asset Recovery →
Always check the environment indicator in the dashboard (shows “Testnet” or “Live”) before transacting.
  1. Use the environment toggle in your dashboard (usually top-right or in wallet settings)
  2. Switch from Testnet to Live
  3. Create a new master wallet for mainnet
  4. Update your API keys — testnet keys won’t work on mainnet
Testnet addresses cannot receive mainnet funds and vice versa.
ChainFaucet
Ethereum (Sepolia)Sepolia Faucet or Alchemy
BNB ChainBNB Testnet Faucet
Polygon (Amoy)Polygon Faucet
BaseAlchemy Faucet
Tron (Nile)Nile Testnet
SolanaSolana Faucet
Circle USDCCircle Faucet

​
API Errors & Troubleshooting

Common causes:
  • Wrong wallet ID
  • Wrong API key (doesn’t match the wallet)
  • Using a general asset ID instead of a wallet-specific asset ID
Usually a temporary issue. If it persists, contact support with the endpoint you’re calling, the blockchain/network, and the full error response.
Your API key is invalid or doesn’t match the wallet you’re trying to access. Check that:
  • The API key is correct (no extra spaces)
  • The API key belongs to this wallet
  • You’re not using a testnet key on mainnet (or vice versa)
  • The API key hasn’t been rotated or regenerated
The resource (wallet, address, or asset) doesn’t exist or you’re using the wrong ID. Common causes include a wrong wallet ID or address ID, using a general asset ID instead of a wallet-specific one, or a typo in the endpoint URL.

​
Virtual Accounts & cNGN

Virtual Accounts allow your users to deposit NGN (Nigerian Naira), which automatically converts to stablecoins on-chain.Requirements:
  • Must be on mainnet/Live mode (not testnet)
  • Must complete KYB verification
Virtual Accounts Documentation →
Virtual Accounts only appear if you’re in Live mode, your account has completed KYB verification, and the feature has been enabled for your account.
cNGN is a Nigerian Naira-pegged stablecoin. Blockradar supports cNGN transactions and swaps with other stablecoins.

​
Fiat On/Off Ramps

Use Virtual Accounts for NGN:
  1. Generate a Virtual Account for the user
  2. User deposits NGN via bank transfer
  3. Funds automatically convert to stablecoins and appear on-chain
Virtual Accounts Documentation →
Currently, Virtual Accounts support NGN only. For other currencies, you would need to integrate with third-party fiat on-ramp providers.

​
Feature Requests

No. Blockradar focuses on stablecoins. Bitcoin is not currently supported.
Blockradar is blockchain and stablecoin agnostic — additional networks and assets can be integrated upon request. Contact us to discuss your requirements.

​
Billing & Subscriptions

Yes. You can pay via the payment link sent to your email, or withdraw from your master wallet to the payment link address.
Currently, we only support stablecoin payments for subscriptions.

​
Supported Blockchains & Assets

Ethereum, BNB Chain, Polygon, Tron, Base, Arbitrum, Optimism, Solana, Celo, Lisk, Avalanche, Asset Chain, Plasma.Blockradar is blockchain and stablecoin agnostic — additional networks can be integrated upon request.
USDT, USDC, DAI, BUSD, cUSD, cNGN, EURC, IDRX.Additional assets can be integrated upon request.

​
Developer Tips

  • Wallet ID: Identifies your master wallet
  • Address ID: Identifies a specific child address within a wallet
  • Asset ID: Identifies a specific asset (USDT, USDC, etc.) within your wallet
Always use the wallet-specific asset ID from your wallet’s asset list, not a general asset ID.
  • Always use mainnet/Live mode for real transactions
  • Store wallet IDs and address IDs in your database
  • Implement webhook handlers for real-time transaction updates
  • Use Deposit Finder as a backup for missed transactions
  • Monitor master wallet balance for gas (native tokens)
  • Enable gasless withdrawals if your users shouldn’t need to hold native tokens

​
Need Help?

Documentation

docs.blockradar.co

Dashboard

dashboard.blockradar.co

Book a Support Call

Schedule here