Saltar para o conteúdo principal

​
Depósitos e Webhooks

Isso geralmente é um atraso temporário de indexação. Use o Deposit Finder para acionar manualmente a indexação:
  • Painel: Acesse sua Carteira Master → Visão Geral → Clique em “Deposit Finder”
  • API: POST /v1/wallets/{walletId}/rescan/blocks com o transactionHash
Documentação do Deposit Finder →
Atrasos em webhooks podem ocorrer devido a congestionamento da rede blockchain, atrasos temporários na indexação de nós ou erros retornados pelo seu endpoint de webhook.Para verificar os logs de webhook:
  • Painel: Carteira Master → Desenvolvedores → Logs de Webhook
  • API: GET /v1/wallets/{walletId}/webhooks
O Blockradar indexa apenas stablecoins por design. Depósitos de tokens nativos (ETH, TRX, SOL, etc.) não aparecerão no histórico de transações do painel. No entanto, os fundos ainda estão na sua carteira e podem ser visualizados no explorador de blockchain ou sacados via API ou painel.

​
Auto-Sweep

Por padrão, disableAutoSweep está definido como false, o que significa que o auto-sweep está ativado. Quando um depósito chega em um endereço filho, ele é automaticamente transferido para sua carteira master.Para manter os fundos nos endereços filhos:
  • Defina disableAutoSweep: true ao criar o endereço via API
  • Ou ative Desabilitar Auto Sweep nas configurações do endereço no painel
Verifique ambos os níveis de configuração:
  • Nível da carteira master — define o padrão para todos os endereços
  • Nível do endereço — sobrescreve a configuração da carteira master
A configuração no nível do endereço sempre tem prioridade. Verifique se o endereço específico tem disableAutoSweep: true.
Sim. Você pode configurar limites de sweep para que os fundos só sejam transferidos automaticamente quando um determinado saldo for atingido.Configuração da Carteira →

​
Taxas de Gas e Custos de Rede

As taxas de gas são pagas diretamente à blockchain no token nativo:
BlockchainToken Nativo
Ethereum / Base / Polygon / etc.ETH
TronTRX
SolanaSOL
O Blockradar não cobra taxas adicionais sobre os custos de rede.
As taxas da rede Tron geralmente ficam entre $1–6 por transação devido à forma como a Tron gerencia largura de banda e energia. Este é um custo no nível da blockchain, não uma cobrança do Blockradar.Alternativas de menor custo:
  • Solana: ~$0.01–0.30 por transação
  • Base: ~$0.01–0.10 por transação
  • Polygon: ~$0.01–0.10 por transação
O endpoint /withdraw/network-fee retorna uma estimativa conservadora para garantir que as transações sejam bem-sucedidas mesmo durante alta congestão da rede. Você é cobrado apenas pela taxa de rede real, que normalmente é inferior à estimativa.
Não, as taxas de gas da blockchain devem ser pagas no token nativo da rede. No entanto, você pode ativar saques gasless para que sua carteira master patrocine o gas para transações de endereços filhos.

​
Transações Gasless

Quando o gasless está ativado, a carteira master paga as taxas de gas em nome dos saques de endereços filhos.Para ativar:
  • Nível da carteira master: Painel → Configurações da Carteira Master → Ativar Transações Gasless
  • Nível do endereço: Defina enableGaslessWithdraw: true ao criar ou atualizar um endereço
Você também pode definir limites para que apenas saques acima ou abaixo de certos valores sejam cobertos.Transações Gasless → · Parâmetros de Endereço →
Depende da configuração enableGaslessWithdraw:
  • Ativado (true): A carteira master paga o gas
  • Desativado (false, padrão): O endereço filho precisa do seu próprio gas

​
Swaps e Bridges

O Blockradar suporta apenas swaps entre stablecoins: USDT, USDC, DAI, BUSD, cUSD, cNGN, EURC, IDRX, JPYC.Swaps de tokens nativos e bridging estão disponíveis em todas as blockchains suportadas, exceto Tron.
Isso geralmente significa que o par de swap não é suportado (ex: swap para um token nativo), ou o valor é muito pequeno ou muito grande para a liquidez disponível.
Este erro geralmente significa que você está usando o asset ID errado. Você precisa usar o asset ID específico da carteira, não um asset ID geral.Para encontrar o ID correto:
  • Painel: Acesse sua carteira → Ativos → Copie o asset ID de lá
  • API: Use os asset IDs retornados do endpoint de detalhes da sua carteira
Sim. Você pode trocar e fazer bridge de ativos entre diferentes blockchains via painel ou API. Para swaps entre blockchains via API, passe o asset ID da carteira master de destino como toAssetId.Documentação de Swap →

​
Configuração de Carteira

O Blockradar permite apenas uma Carteira Master por rede blockchain por conta. Para suportar uma blockchain adicional, você deve criar uma Carteira Master separada para ela. Dentro de uma única Carteira Master, você pode criar quantos endereços filhos forem necessários para segmentar fundos por usuário, aplicação ou finalidade. Criar múltiplas Carteiras Master para a mesma blockchain não é suportado.
Não, endereços não podem ser excluídos devido a limitações da blockchain. Você pode apenas desativá-los no painel. Endereços desativados não receberão novos depósitos nem serão monitorados.
Use o parâmetro showPrivateKey: true ao consultar detalhes da carteira ou endereço via API.
Use apenas em ambientes seguros e confiáveis.

​
Saques e Transferências

Use o endpoint de saque da API: POST /v1/wallets/{walletId}/addresses/{addressId}/withdrawDocumentação de Saques →
Causas comuns:
  • Gas insuficiente na carteira master (se usando gasless) ou no endereço filho
  • Processamento em fila — transações são processadas sequencialmente devido aos nonces da blockchain
  • Problemas de nó — atrasos temporários
Se estiver presa por mais de 30 minutos, entre em contato com o suporte com o ID da transação.
Todas as movimentações de fundos on-chain usam o endpoint de saque. Não há um endpoint separado de “transferência”.
  • Master para filho: POST /v1/wallets/{walletId}/withdraw com o endereço filho como destino
  • Filho para master: POST /v1/wallets/{walletId}/addresses/{addressId}/withdraw com o endereço da carteira master como destino
  • Filho para externo: Mesmo endpoint, endereço externo como destino
Documentação de Saques →
Use o endpoint de transações com o parâmetro de consulta address:
    GET /v1/wallets/{walletId}/transactions?address={addressId}
Documentação de Transações →

​
Recuperação de Ativos

Use a Recuperação de Ativos no painel.Recuperação de Ativos →

​
Testnet vs. Mainnet

Não, seus fundos não foram perdidos. Mainnet e testnet são redes separadas, mas os endereços são criptograficamente vinculados. Você pode recuperar fundos usando a Recuperação de Ativos.Recuperação de Ativos →
Sempre verifique o indicador de ambiente no painel (mostra “Test Mode” ou “Live Mode”) antes de transacionar.
  1. Use o alternador de ambiente no seu painel (geralmente no canto superior direito ou nas configurações da carteira)
  2. Mude de Testnet para Live
  3. Crie uma nova carteira master para a mainnet
  4. Atualize suas chaves de API — chaves de testnet não funcionam na mainnet
Endereços de testnet não podem receber fundos da mainnet e vice-versa.
BlockchainFaucet
Ethereum (Sepolia)Sepolia Faucet ou Alchemy
BNB ChainBNB Testnet Faucet
Polygon (Amoy)Polygon Faucet
BaseAlchemy Faucet
Tron (Nile)Nile Testnet
SolanaSolana Faucet
Circle USDCCircle Faucet

​
Erros de API e Solução de Problemas

Causas comuns:
  • Wallet ID errado
  • Chave de API errada (não corresponde à carteira)
  • Usando um asset ID geral em vez de um asset ID específico da carteira
Geralmente é um problema temporário. Se persistir, entre em contato com o suporte informando o endpoint que você está chamando, a blockchain/rede e a resposta completa do erro.
Sua chave de API é inválida ou não corresponde à carteira que você está tentando acessar. Verifique se:
  • A chave de API está correta (sem espaços extras)
  • A chave de API pertence a esta carteira
  • Você não está usando uma chave de testnet na mainnet (ou vice-versa)
  • A chave de API não foi rotacionada ou regenerada
O recurso (carteira, endereço ou ativo) não existe ou você está usando o ID errado. Causas comuns incluem wallet ID ou address ID errado, uso de um asset ID geral em vez de um específico da carteira, ou erro de digitação na URL do endpoint.

​
Contas Virtuais e cNGN

Contas Virtuais permitem que seus usuários depositem NGN (Naira Nigeriana), que é automaticamente convertido em stablecoins on-chain.Requisitos:
  • Deve estar no modo mainnet/Live (não testnet)
  • Deve completar a verificação KYB
Documentação de Contas Virtuais →
Contas Virtuais só aparecem se você estiver no modo Live, sua conta tiver completado a verificação KYB e o recurso tiver sido habilitado para sua conta.
cNGN é uma stablecoin atrelada à Naira Nigeriana. O Blockradar suporta transações com cNGN e swaps com outras stablecoins.

​
Rampas de Entrada/Saída Fiat

Use Contas Virtuais para NGN:
  1. Gere uma Conta Virtual para o usuário
  2. O usuário deposita NGN via transferência bancária ou mobile money
  3. Os fundos são automaticamente convertidos em stablecoins e aparecem on-chain
Documentação de Contas Virtuais →
Atualmente, Contas Virtuais suportam apenas NGN. Para outras moedas, você precisará integrar com provedores terceiros de off-ramp fiat, isso permitirá que você faça off-ramp para KES, NGN, TZS, UGX, BRL e MWK. Veja Retirar Fiat.

​
Solicitações de Recursos

Não. O Blockradar é focado em stablecoins. Bitcoin não é suportado atualmente.
O Blockradar é agnóstico em relação a blockchains e stablecoins — redes e ativos adicionais podem ser integrados sob demanda. Entre em contato conosco para discutir seus requisitos.

​
Cobrança e Assinaturas

Sim. Você pode pagar via link de pagamento enviado para seu e-mail, ou sacar da sua carteira master para o endereço do link de pagamento.
Atualmente, aceitamos apenas pagamentos com stablecoins para assinaturas.

​
Blockchains e Ativos Suportados

Ethereum, BNB Chain, Polygon, Tron, Base, Arbitrum, Optimism, Solana, Celo, Lisk, Avalanche, Asset Chain, Plasma, e Tempo.O Blockradar é agnóstico em relação a blockchains e stablecoins — redes adicionais podem ser integradas sob demanda.
USDT, USDC, DAI, BUSD, cUSD, cNGN, EURC, IDRX, JPYC.Ativos adicionais podem ser integrados sob demanda.

​
Dicas para Desenvolvedores

  • Wallet ID: Identifica sua carteira master
  • Address ID: Identifica um endereço filho específico dentro de uma carteira
  • Asset ID: Identifica um ativo específico (USDT, USDC, etc.) dentro da sua carteira
Sempre use o asset ID específico da carteira, encontrado na lista de ativos da sua carteira, não um asset ID geral.
  • Sempre use o modo mainnet/Live para transações reais
  • Armazene wallet IDs e address IDs no seu banco de dados
  • Implemente handlers de webhook para atualizações de transações em tempo real
  • Use o Deposit Finder como backup para transações perdidas
  • Monitore o saldo da carteira master para gas (tokens nativos)
  • Ative saques gasless se seus usuários não precisarem manter tokens nativos

​
Precisa de Ajuda?

Documentação

docs.blockradar.co

Painel

dashboard.blockradar.co

Agendar Suporte

Agende aqui