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
To have a webhook delivered again, use Resend Webhook.
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.

​
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 chain’s native token — for example ETH on Ethereum, Base, Arbitrum and Optimism, BNB on BNB Chain, POL (formerly MATIC) on Polygon, TRX on Tron, SOL on Solana, and XLM on Stellar.Blockradar does not mark up network gas: you pay only what the blockchain charges. Other products can carry their own charges — see Fees & Pricing below.
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.

​
Address Activation (Stellar, Tron, Solana)

Some blockchains require an address to be activated or funded before it can hold tokens. This is a network rule, not a Blockradar charge, and your wallet is not being drained:Address Activation →
Issue the address as dormant with enableIndexing: false. Activation is deferred until you enable indexing on it, so you only fund the reserve for addresses your customers actually use.
The most common cause is an underfunded master wallet. Top up your Stellar master wallet with XLM — pending activations retry automatically once funds arrive. Check configurations.stellar.lastError on the address for the specific reason.

​
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 (for example USDT ↔ USDC) and swaps between stablecoins and native tokens (for example SOL → USDC or USDC → TRX), both on the same chain and across chains.Liquidity varies by pair, chain and amount, so request a quote to confirm a specific route before offering it to users.Swap Documentation →
Common causes:
  • No route or liquidity is currently available for that pair on that chain
  • The amount is too small or too large for available liquidity
  • The asset is not enabled on your wallet
Try a different amount, or check that both assets are enabled on the wallets involved.
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

Yes. Each blockchain network needs its own Master Wallet, and that includes each EVM chain — a Base wallet does not cover Ethereum, Polygon or Arbitrum. Create one Master Wallet per chain you want to support.Create a Master Wallet →
Blockradar allows only one Master Wallet per blockchain network per account. To support an additional blockchain, you must create a separate Master Wallet for it. Within a single Master Wallet, you can create as many child addresses as needed to segment funds by user, application, or purpose. Creating multiple Master Wallets for the same blockchain is not supported.
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.
Yes. Address whitelisting lets you add an external address to your wallet so Blockradar monitors its deposits, without changing your existing setup.Address Whitelisting →
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.
Yes:
Yes. Sign-only mode signs the transaction and returns it without submitting it to the blockchain — useful for offline signing, multi-signature workflows, or inspecting a transaction before broadcasting.
  • Master wallet: POST /v1/wallets/{walletId}/withdraw/sign
  • Child address: POST /v1/wallets/{walletId}/addresses/{addressId}/withdraw/sign
Sign-Only Mode →
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:
Transactions Documentation →

​
Asset Recovery

Use Asset Recovery in the dashboard.Asset Recovery →

​
Test Mode vs. Live Mode

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 “Test Mode” or “Live Mode”) before transacting.
  1. Use the environment toggle in your dashboard (usually top-right or in wallet settings)
  2. Switch from Test Mode to Live Mode
  3. Create a new master wallet for mainnet
  4. Update your API keys — Test Mode keys won’t work in Live Mode
Testnet addresses cannot receive mainnet funds and vice versa.
Native tokens for gas:For testnet USDC and EURC on most chains, use the Circle Faucet. Stablecoin faucets for every chain are listed on Supported Assets.

​
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 Test Mode key in Live Mode (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.
You have exceeded the API rate limit. Slow down and retry after a short wait, ideally with exponential backoff. Avoid polling in tight loops — use webhooks for transaction updates, and cache responses from discovery endpoints (supported assets, currencies, blockchains) instead of calling them on every request.Errors →

​
Fees & Pricing

Not on gas — Blockradar passes network fees through without a markup. Some products carry their own charges:
  • Swaps and fiat conversions can include a markup on the exchange rate
  • Fiat deposits and payouts can carry a processing fee
  • Virtual account creation can carry a fixed fee
  • Earn takes its fee from earnings when you withdraw, never from your deposit
Rates depend on your plan and commercial terms. Quote endpoints show the rate and fees for a specific transaction before you execute it. For your account’s pricing, contact [email protected].

​
Virtual Accounts & Fiat Deposits

  • Compliance approval: Complete the due diligence process under My Wallets → Settings → Compliance in the dashboard
  • Feature activation: After compliance approval, request virtual account activation from [email protected] or via live chat on the dashboard
  • A paid plan with stablecoin access: Depositing fiat and converting it to stablecoins is a paid feature. Upgrade from Dashboard → Settings → Subscription
  • The right environment: Test Mode requests use only testnet routes and wallets; Live Mode requests use only mainnet routes and wallets
Virtual Accounts Documentation →
Virtual Accounts only appear once your compliance has been approved, the feature has been activated for your account, and your plan includes stablecoin access.
  • Reusable Virtual Accounts are long-lived bank accounts tied to a master wallet or child address. Every deposit to them converts to stablecoins — good for recurring customer deposits.
  • Deposit Fiat payment orders create a one-time virtual account for a single expected payment. The account is valid for that one payment only.
Deposits are currently live in ARS, BRL, COP, EUR, KES, MXN and USD.
NGN virtual accounts are temporarily paused. NGN payouts through Withdraw Fiat are not affected.
Availability varies by corridor and wallet, so check what your wallet supports before presenting an option: use the Virtual Accounts discovery endpoint for reusable accounts, or Get Supported Currencies for Deposit Fiat.
No. AUD, CAD, GHS, THB, TRY, TZS, UGX, XOF and ZAR are payout-only: you can pay out to them with Withdraw Fiat, but users cannot deposit them.
cNGN is a Nigerian Naira-pegged stablecoin. Blockradar supports cNGN transactions and swaps with other stablecoins.

​
Fiat Payouts (Withdraw Fiat)

Use Withdraw Fiat. It converts supported stablecoins to fiat and pays out to bank accounts, mobile money and other local rails, from a master wallet or a child address. The flow discovers the payment methods for a corridor, tells you exactly which beneficiary details each one needs, then quotes and executes the payout.
Payouts are currently live in ARS, AUD, BRL, CAD, COP, EUR, GHS, KES, MXN, NGN, THB, TRY, TZS, UGX, USD, XOF and ZAR.Availability varies by corridor and wallet, so fetch the live list with Get Supported Currencies rather than hard-coding it.

​
Earn

Earn lets you put idle stablecoins to work in interest-bearing DeFi protocols (Aave and Compound). It is non-custodial: funds move from your own wallet, Blockradar never pools or holds them, and there is no lock-up period.Earn →
Aave is available on Ethereum, Base, Arbitrum, Optimism, Polygon and BNB Smart Chain. Compound is available on Ethereum, Base and Arbitrum. The dashboard only shows networks where Earn is available for your wallet.
Depositing is free. When you withdraw, you receive exactly the amount you ask for — the fee is drawn from your earnings, never your principal. You can withdraw part or all of a position at any time. Rates are variable, and DeFi carries smart-contract risk, so returns are not guaranteed.

​
Compliance & Security

Yes. The AML API screens any wallet address against OFAC, FBI, Tether and Circle blocklists, so you can flag high-risk counterparties before sending or receiving funds.AML Screening →
Yes. IP whitelisting restricts API requests to the IP addresses you allow, adding another layer of protection to your integration.IP Whitelisting →
Some fiat corridors require your customers to be verified. Create customers with the Customer API, then submit their details and documents through customer onboarding requests. Collect only the fields the requirements schema asks for — see Dynamic Forms.

​
Other Products

Yes. Gateway gives you a unified, chain-abstracted USDC balance: deposit from any supported chain and withdraw to any supported chain, without manual bridging.
Yes. Auto Settlements convert incoming deposits to your preferred asset and route them to your destination chain, based on rules you define once.
The Liquidity Pool lets approved Liquidity Providers set exchange rates for asset pairs. Those rates power Blockradar’s swap engine, which picks the best available rate from active providers.
Yes. The Smart Contract API lets you read from and write to any smart contract directly from your wallet, without managing RPC endpoints or signing flows yourself.

​
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, Stellar, Celo, Lisk, Avalanche, Asset Chain, Arc, Plasma, and TempoBlockradar is blockchain and stablecoin agnostic — additional networks can be integrated upon request.Supported Networks →
USDT, USDC, DAI, BUSD, cUSD, cNGN, EURC, IDRX, ZARP, JPYC, MXNB, PYUSD, AlphaUSDAdditional assets can be integrated upon request.Supported Assets →

​
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 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