Skip to main content

​
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
Para que um webhook seja entregue novamente, use Resend Webhook.
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 da rede — por exemplo, ETH na Ethereum, Base, Arbitrum e Optimism, BNB na BNB Chain, POL (antigo MATIC) na Polygon, TRX na Tron, SOL na Solana e XLM na Stellar.O Blockradar não aplica markup sobre o gas da rede: você paga apenas o que a blockchain cobra. Outros produtos podem ter suas próprias cobranças — veja Taxas e Preços abaixo.
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.

​
Ativação de Endereços (Stellar, Tron, Solana)

Algumas blockchains exigem que um endereço seja ativado ou financiado antes de poder manter tokens. Esta é uma regra da rede, não uma cobrança do Blockradar, e sua carteira não está sendo drenada:Ativação de Endereços →
Emita o endereço como inativo com enableIndexing: false. A ativação é adiada até você ativar a indexação nele, então você só financia a reserva dos endereços que seus clientes realmente usam.
A causa mais comum é uma carteira master sem saldo suficiente. Recarregue sua carteira master Stellar com XLM — as ativações pendentes são tentadas novamente de forma automática assim que os fundos chegam. Verifique configurations.stellar.lastError no endereço para saber o motivo específico.

​
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 swaps entre stablecoins (por exemplo, USDT ↔ USDC) e swaps entre stablecoins e tokens nativos (por exemplo, SOL → USDC ou USDC → TRX), tanto na mesma blockchain quanto entre blockchains diferentes.A liquidez varia conforme o par, a blockchain e o valor, então solicite uma cotação para confirmar uma rota específica antes de oferecê-la aos usuários.Documentação de Swap →
Causas comuns:
  • Não há rota ou liquidez disponível no momento para esse par nessa blockchain
  • O valor é muito pequeno ou muito grande para a liquidez disponível
  • O ativo não está habilitado na sua carteira
Tente um valor diferente ou verifique se ambos os ativos estão habilitados nas carteiras envolvidas.
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

Sim. Cada rede blockchain precisa da sua própria Carteira Master, e isso inclui cada blockchain EVM — uma carteira na Base não cobre Ethereum, Polygon ou Arbitrum. Crie uma Carteira Master para cada blockchain que você deseja suportar.Criar uma Carteira Master →
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.
Sim. A lista de permissões de endereços permite adicionar um endereço externo à sua carteira para que o Blockradar monitore seus depósitos, sem alterar sua configuração atual.Lista de Permissões de Endereços →
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.
Sim:
Sim. O modo sign-only assina a transação e a retorna sem enviá-la para a blockchain — útil para assinatura offline, fluxos de múltiplas assinaturas ou para inspecionar uma transação antes de transmiti-la.
  • Carteira master: POST /v1/wallets/{walletId}/withdraw/sign
  • Endereço filho: POST /v1/wallets/{walletId}/addresses/{addressId}/withdraw/sign
Modo Sign-Only →
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:
Documentação de Transações →

​
Recuperação de Ativos

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

​
Test Mode vs. Live Mode

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 Test Mode para Live Mode
  3. Crie uma nova carteira master para a mainnet
  4. Atualize suas chaves de API — chaves do Test Mode não funcionam no Live Mode
Endereços de testnet não podem receber fundos da mainnet e vice-versa.
Tokens nativos para gas:Para USDC e EURC de testnet na maioria das blockchains, use o Circle Faucet. Os faucets de stablecoins de todas as blockchains estão listados em Ativos Suportados.

​
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 do Test Mode no Live Mode (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.
Você excedeu o limite de requisições da API. Reduza o ritmo e tente novamente após uma breve espera, de preferência com backoff exponencial. Evite polling em loops curtos — use webhooks para atualizações de transações e armazene em cache as respostas dos endpoints de descoberta (ativos, moedas e blockchains suportados) em vez de chamá-los a cada requisição.Erros →

​
Taxas e Preços

Não sobre o gas — o Blockradar repassa as taxas de rede sem markup. Alguns produtos têm suas próprias cobranças:
  • Swaps e conversões fiat podem incluir um markup sobre a taxa de câmbio
  • Depósitos e pagamentos fiat podem ter uma taxa de processamento
  • A criação de contas virtuais pode ter uma taxa fixa
  • Earn cobra sua taxa sobre os rendimentos quando você saca, nunca sobre o seu depósito
As tarifas dependem do seu plano e dos termos comerciais. Os endpoints de cotação mostram a taxa de câmbio e as taxas de uma transação específica antes de você executá-la. Para os preços da sua conta, entre em contato com [email protected].

​
Contas Virtuais e Depósitos Fiat

  • Aprovação de compliance: Conclua o processo de due diligence em My Wallets → Settings → Compliance no painel
  • Ativação do recurso: Após a aprovação de compliance, solicite a ativação de contas virtuais pelo [email protected] ou pelo chat ao vivo no painel
  • Um plano pago com acesso a stablecoins: Depositar fiat e convertê-lo em stablecoins é um recurso pago. Atualize em Dashboard → Settings → Subscription
  • O ambiente correto: Requisições no Test Mode usam apenas rotas e carteiras de testnet; requisições no Live Mode usam apenas rotas e carteiras de mainnet
Documentação de Contas Virtuais →
Contas Virtuais só aparecem depois que seu compliance for aprovado, o recurso for ativado para sua conta e seu plano incluir acesso a stablecoins.
  • Contas Virtuais reutilizáveis são contas bancárias de longa duração vinculadas a uma carteira master ou a um endereço filho. Todo depósito nelas é convertido em stablecoins — ideal para depósitos recorrentes de clientes.
  • Ordens de pagamento de Deposit Fiat criam uma conta virtual de uso único para um único pagamento esperado. A conta é válida apenas para esse pagamento.
Os depósitos estão disponíveis atualmente em ARS, BRL, COP, EUR, KES, MXN e USD.
As contas virtuais em NGN estão inativas no momento. Os pagamentos em NGN via Saque em Fiat não são afetados.
A disponibilidade varia por corredor e carteira, então verifique o que sua carteira suporta antes de apresentar uma opção: use o endpoint de descoberta de Contas Virtuais para contas reutilizáveis, ou Get Supported Currencies para Deposit Fiat.
Não. AUD, CAD, GHS, THB, TRY, TZS, UGX, XOF e ZAR são apenas para pagamento: você pode fazer pagamentos nelas com o Saque em Fiat, mas os usuários não podem depositá-las.
cNGN é uma stablecoin atrelada à Naira Nigeriana. O Blockradar suporta transações com cNGN e swaps com outras stablecoins.

​
Pagamentos Fiat (Saque em Fiat)

Use o Saque em Fiat. Ele converte stablecoins suportadas em fiat e faz o pagamento para contas bancárias, mobile money e outros rails locais, a partir de uma carteira master ou de um endereço filho. O fluxo descobre os métodos de pagamento de um corredor, informa exatamente quais dados do beneficiário cada um exige e, em seguida, cota e executa o pagamento.
Os pagamentos estão disponíveis atualmente em ARS, AUD, BRL, CAD, COP, EUR, GHS, KES, MXN, NGN, THB, TRY, TZS, UGX, USD, XOF e ZAR.A disponibilidade varia por corredor e carteira, então obtenha a lista atualizada com Get Supported Currencies em vez de fixá-la no código.

​
Earn

O Earn permite colocar stablecoins ociosas para render em protocolos DeFi que geram juros (Aave e Compound). Ele é não custodial: os fundos saem da sua própria carteira, o Blockradar nunca os agrupa nem os mantém sob custódia, e não há período de bloqueio.Earn →
O Aave está disponível na Ethereum, Base, Arbitrum, Optimism, Polygon e BNB Smart Chain. O Compound está disponível na Ethereum, Base e Arbitrum. O painel mostra apenas as redes em que o Earn está disponível para sua carteira.
Depositar é gratuito. Ao sacar, você recebe exatamente o valor solicitado — a taxa é descontada dos seus rendimentos, nunca do seu principal. Você pode sacar parte ou a totalidade de uma posição a qualquer momento. As taxas de rendimento são variáveis, e DeFi envolve risco de smart contract, então os retornos não são garantidos.

​
Compliance e Segurança

Sim. A API de AML verifica qualquer endereço de carteira contra as listas de bloqueio da OFAC, FBI, Tether e Circle, para que você possa sinalizar contrapartes de alto risco antes de enviar ou receber fundos.Verificação AML →
Sim. A lista de IPs permitidos restringe as requisições à API aos endereços IP que você autorizar, adicionando mais uma camada de proteção à sua integração.Lista de IPs Permitidos →
Alguns corredores fiat exigem que seus clientes sejam verificados. Crie clientes com a Customer API e, em seguida, envie os dados e documentos deles por meio de solicitações de onboarding de clientes. Colete apenas os campos que o schema de requisitos solicita — veja Dynamic Forms.

​
Outros Produtos

Sim. O Gateway oferece um saldo de USDC unificado e abstraído de blockchain: deposite a partir de qualquer blockchain suportada e saque para qualquer blockchain suportada, sem bridging manual.
Sim. As Liquidações Automáticas convertem os depósitos recebidos no ativo de sua preferência e os encaminham para a sua blockchain de destino, com base em regras que você define uma única vez.
O Liquidity Pool permite que Liquidity Providers aprovados definam taxas de câmbio para pares de ativos. Essas taxas alimentam o motor de swaps do Blockradar, que escolhe a melhor taxa disponível entre os provedores ativos.
Sim. A API de Smart Contracts permite ler e escrever em qualquer smart contract diretamente da sua carteira, sem precisar gerenciar endpoints RPC ou fluxos de assinatura por conta própria.

​
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, Stellar, Celo, Lisk, Avalanche, Asset Chain, Arc, Plasma e TempoO Blockradar é agnóstico em relação a blockchains e stablecoins — redes adicionais podem ser integradas sob demanda.Blockchains Suportadas →
USDT, USDC, DAI, BUSD, cUSD, cNGN, EURC, IDRX, ZARP, JPYC, MXNB, PYUSD, AlphaUSDAtivos adicionais podem ser integrados sob demanda.Ativos Suportados →

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