Saltar para o conteúdo principal

​
Depósitos e Webhooks

Isso geralmente é um atraso temporário de indexação. Use o Localizador de Depósitos para acionar a indexação manualmente:
  • Painel: Vá para sua Carteira Principal → Visão Geral → Clique em “Localizador de Depósitos”
  • API: POST /v1/wallets/{walletId}/rescan/blocks com o transactionHash
Documentação do Localizador de Depósitos →
Atrasos em webhooks podem ocorrer devido à congestionamento da rede blockchain, atrasos temporais de indexação de nós, ou erros no seu endpoint de webhook.Para verificar os registros de webhooks:
  • Painel: Carteira Principal → Desenvolvedores → Registros de Webhooks
  • API: GET /v1/wallets/{walletId}/webhooks

​
Varredura Automática

Por padrão, disableAutoSweep está definido como false, o que significa que a varredura automática está habilitada. Quando um depósito chega a um endereço secundário, ele é automaticamente varrido para sua carteira principal.Para manter os fundos em endereços secundários:
  • Defina disableAutoSweep: true ao criar o endereço via API
  • Ou ative Desabilitar Varredura Automática nas configurações do endereço no painel
Verifique ambos os níveis de configuração. A configuração no nível do endereço sempre tem prioridade.
  • Nível da carteira principal — define o padrão para todos os endereços
  • Nível do endereço — substitui a configuração da carteira principal
Verifique se o endereço específico tem disableAutoSweep: true.
Sim. Você pode configurar limites de varredura para que os fundos só sejam varridos automaticamente após atingir determinado saldo.Configuração de Carteira →

​
Taxas de Gas e Custos de Rede

As taxas de gas são pagas diretamente à blockchain no token nativo:
RedeToken Nativo
Ethereum / Base / Polygon / etc.ETH
TronTRX
SolanaSOL
O Blockradar não cobra taxas adicionais sobre os custos de rede.
As taxas de rede da Tron são tipicamente de $1–6 por transação devido à forma como a Tron gerencia largura de banda e energia. Este é um custo a nível de 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 congestionamento. Você só é cobrado pela taxa de rede real, que normalmente é menor que a estimativa.
Não, as taxas de gas da blockchain devem ser pagas no token nativo da rede. No entanto, você pode habilitar saques sem gas para que sua carteira principal patrocine o gas para transações de endereços secundários.

​
Transações Sem Gas

Quando o modo sem gas está habilitado, a carteira principal paga as taxas de gas em nome dos saques de endereços secundários.Para habilitar:
  • Nível da carteira principal: Painel → Configurações da Carteira Principal → Habilitar Transações Sem Gas
  • Nível do endereço: Defina enableGaslessWithdraw: true ao criar ou atualizar um endereço
Transações Sem Gas → · Parâmetros de Endereço →
Depende da configuração enableGaslessWithdraw:
  • Habilitado (true): A carteira principal paga o gas
  • Desabilitado (false, padrão): O endereço secundário precisa do seu próprio gas

​
Trocas e Pontes

O Blockradar suporta apenas trocas de stablecoin para stablecoin: USDT, USDC, DAI, BUSD, cUSD, cNGN, EURC, IDRX.Trocas de tokens nativos (ex.: USDT → TRX, USDC → ETH) não são suportadas.
Isso geralmente significa que o par de troca não é suportado, ou que o valor é muito pequeno ou grande para a liquidez disponível.
Este erro geralmente significa que você está usando o ID de ativo incorreto. Você precisa usar o ID de ativo específico da carteira, não um ID de ativo geral.
  • Painel: Vá para sua carteira → Ativos → Copie o ID do ativo de lá
  • API: Use os IDs de ativos retornados pelo endpoint de detalhes da sua carteira
Sim. Você pode trocar e transferir ativos entre diferentes blockchains via painel ou API. Para trocas entre redes via API, passe o ID de ativo da carteira principal de destino como toAssetId.Documentação de Trocas →

​
Configuração de Carteira

  • Redes EVM (Ethereum, Base, Polygon, Arbitrum, Optimism, etc.): 1 carteira cobre todas
  • Tron (TRC20): Carteira separada necessária
  • Solana: Carteira separada necessária
Não. Os endereços não podem ser excluídos devido às limitações da blockchain. Você só pode 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 buscar detalhes da carteira ou endereço via API.
Use isso apenas em ambientes seguros e confiáveis.

​
Saques e Transferências

Use o endpoint de saque: POST /v1/wallets/{walletId}/addresses/{addressId}/withdrawDocumentação de Saques →
Causas comuns:
  • Gas insuficiente na carteira principal (se usar sem gas) ou no endereço secundário
  • Fila de processamento — as 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.
Todos os movimentos de fundos on-chain usam o endpoint de saque. Não existe um endpoint de “transferência” separado.
  • Principal para secundário: POST /v1/wallets/{walletId}/withdraw com o endereço secundário como destino
  • Secundário para principal: POST /v1/wallets/{walletId}/addresses/{addressId}/withdraw com o endereço da carteira principal como destino
  • Secundário 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 de endereço:
GET /v1/wallets/{walletId}/transactions?address={addressId}
Documentação de Transações →

​
Recuperação de Ativos

Use a Recuperação de Ativos no painel. Atualmente suportada apenas para carteiras principais.Recuperação de Ativos →
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.

​
Testnet vs. Mainnet

Não, seus fundos não estão perdidos. 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 “Testnet” ou “Live”) antes de realizar transações.
  1. Use o seletor 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 principal para mainnet
  4. Atualize suas chaves de API — as chaves de testnet não funcionarão na mainnet
Endereços de testnet não podem receber fundos de mainnet e vice-versa.
RedeFaucet
Ethereum (Sepolia)Sepolia Faucet
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:
  • ID de carteira incorreto
  • Chave de API incorreta (não corresponde à carteira)
  • Uso de ID de ativo geral em vez de ID específico da carteira
Geralmente é um problema temporário. Se persistir, entre em contato com o suporte com o endpoint que está chamando, a blockchain/rede e a resposta de erro completa.
Sua chave de API é inválida ou não corresponde à carteira. Verifique que:
  • 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 não existe ou você está usando o ID incorreto. Causas comuns: ID de carteira ou endereço incorreto, uso de ID de ativo geral em vez de específico da carteira, ou erro de digitação na URL do endpoint.

​
Contas Virtuais e cNGN

As Contas Virtuais permitem que seus usuários depositem NGN (Naira nigeriana), que é automaticamente convertida 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 →
As 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 vinculada à Naira nigeriana. O Blockradar suporta transações e trocas de cNGN com outras stablecoins.

​
Rampas Fiat de Entrada/Saída

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
  3. Os fundos são automaticamente convertidos em stablecoins e aparecem on-chain
Documentação de Contas Virtuais →
Atualmente, as Contas Virtuais suportam apenas NGN. Para outras moedas, você precisaria integrar provedores externos de rampa fiat.

​
Solicitações de Recursos

Não. O Blockradar foca 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 solicitação. Fale conosco para discutir seus requisitos.

​
Faturamento e Assinaturas

Sim. Você pode pagar pelo link de pagamento enviado ao seu e-mail, ou sacar da sua carteira principal para o endereço do link de pagamento.
Atualmente, suportamos 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.O Blockradar é agnóstico em relação a blockchains e stablecoins — redes adicionais podem ser integradas sob solicitação.
USDT, USDC, DAI, BUSD, cUSD, cNGN, EURC, IDRX. Ativos adicionais podem ser integrados sob solicitação.

​
Dicas para Desenvolvedores

  • ID de carteira: Identifica sua carteira principal
  • ID de endereço: Identifica um endereço secundário específico dentro de uma carteira
  • ID de ativo: Identifica um ativo específico (USDT, USDC, etc.) dentro da sua carteira
Sempre use o ID de ativo específico da carteira da lista de ativos da sua carteira, não um ID de ativo geral.
  • Sempre use o modo mainnet/Live para transações reais
  • Armazene IDs de carteira e endereço no seu banco de dados
  • Implemente manipuladores de webhook para atualizações de transações em tempo real
  • Use o Localizador de Depósitos como backup para transações perdidas
  • Monitore o saldo da carteira principal para gas (tokens nativos)
  • Habilite saques sem gas se seus usuários não precisarem ter tokens nativos

​
Precisa de Ajuda?

Documentação

docs.blockradar.co

Painel

dashboard.blockradar.co

Agendar uma Chamada de Suporte

Agende aqui