Skip to main content
Em resumo
A API Withdraw da Blockradar permite enviar ativos stablecoin de suas carteiras para endereços blockchain externos. Suporta saques individuais, saques em lote para múltiplos destinatários e fornece estimativa de taxas antes da execução.
Interface Withdraw da Blockradar

Pré-requisitos

Antes de usar a API Withdraw, certifique-se de ter:
1

Chave de API

Obtenha sua chave de API no Dashboard da Blockradar. Vá até Developers para gerar uma.
2

Carteira criada

Crie uma carteira pela API Create Wallet ou pelo dashboard. Você precisará do walletId para as operações de saque.
3

ID do ativo

Obtenha o assetId do token que deseja sacar em Assets no dashboard ou pela API Get Assets.
4

Saldo suficiente

Garanta que sua carteira tenha saldo suficiente do ativo a ser sacado, além do token nativo (ETH, BNB, MATIC, etc.) para cobrir as taxas de rede.

Como funciona

A API Withdraw envia ativos stablecoin de sua carteira Blockradar para qualquer endereço blockchain externo:

Saque individual

Envie ativos para um endereço destinatário com uma única chamada de API.

Saque em lote

Envie ativos para múltiplos destinatários em uma única chamada de API, reduzindo overhead e simplificando pagamentos em massa.

Estimativa de taxas

Calcule as taxas de rede antes da execução para garantir saldo suficiente e exibir os custos aos usuários.

Modo Sign-Only

Assine transações sem transmiti-las para casos de uso avançados como assinatura offline ou envio personalizado.

Master Wallet vs Child Address

A API Withdraw está disponível em dois níveis:

Master Wallet

Saque diretamente de sua master wallet. Ideal para operações de tesouraria e gestão centralizada de fundos.

Child Address

Saque de child addresses individuais. Perfeito para operações específicas de usuário e gestão segregada de fundos.

Endpoints


Saque individual

Envie ativos para um único endereço destinatário.

Parâmetros da requisição

Os parâmetros marcados com * são obrigatórios para saques individuais, mas não são necessários se você estiver usando o array assets para saques em lote.

Exemplo de saque individual

Resposta do saque individual


Saques em lote

Envie ativos para múltiplos destinatários em uma única chamada de API. Os saques em lote são executados sequencialmente, e cada saque é processado como uma transação blockchain independente.

Quando usar saques em lote

  • Pagamentos em massa: Pague vários funcionários, fornecedores ou parceiros de uma vez
  • Distribuições: Envie ativos para múltiplos endereços
  • Transferências multidestinatário: Envie valores diferentes para endereços diferentes
  • Eficiência operacional: Reduza chamadas de API e simplifique a lógica de pagamento

Parâmetros da requisição em lote

Para saques em lote, use o array assets em vez de parâmetros individuais: Cada item no array assets:

Exemplo de saque em lote

Resposta do saque em lote

Tratamento de falhas parciais

Os saques em lote suportam sucesso parcial. Se alguns saques falharem, os demais ainda serão executados:

Regras de saque em lote


Estimando taxas de rede

Sempre estime as taxas antes de executar saques para garantir saldo suficiente do token nativo e exibir custos precisos aos usuários.

Estimativa de taxa individual

Resposta de taxa individual

Estimativa de taxa em lote

Estime taxas para múltiplos saques de uma vez:

Resposta de taxa em lote

Campos da resposta de taxa


Modo Sign-Only

Assine transações sem transmiti-las à blockchain. Útil para:
  • Assinatura offline: Prepare transações para envio posterior
  • Fluxos multi-assinatura: Colete assinaturas antes do envio
  • Inspeção de transações: Revise os detalhes da transação antes de transmiti-la

Exemplo de Sign-Only

Resposta de Sign-Only


Saques de Child Address

Saque de child addresses individuais em vez da master wallet:
Os saques de child address também suportam operações em lote usando o array assets, seguindo o mesmo formato dos saques em lote da master wallet.

Eventos de Webhook

Monitore a conclusão dos saques por meio de webhooks:

Payload do Webhook


Exemplo de fluxo completo

A seguir, uma implementação completa do fluxo: estimativa de taxa → confirmação do usuário → saque:

Respostas de erro


Boas práticas

Segurança

  • Valide endereços: Sempre verifique os endereços dos destinatários antes de iniciar saques
  • Use referências: Rastreie saques com IDs de referência únicos para conciliação
  • Implemente webhooks: Escute os eventos withdraw.success e withdraw.failed para confirmar o status
  • Verifique AML: A Blockradar faz triagem automática dos endereços; revise quaisquer transações sinalizadas

Gestão de taxas

  • Estime antes de executar: Sempre chame o endpoint network-fee antes dos saques
  • Monitore o saldo nativo: Garanta ETH/BNB/MATIC suficientes para as taxas de gas
  • Use lotes para mais eficiência: Agrupe vários saques para reduzir chamadas de API e overhead operacional

Tratamento de erros

  • Trate falhas parciais: Em saques em lote, verifique tanto o array success quanto errors
  • Implemente retentativas: Use backoff exponencial para falhas transitórias
  • Registre todas as transações: Armazene IDs e hashes de transações para depuração e conciliação

Desempenho

  • Use tamanhos de lote adequados: Lotes maiores reduzem chamadas de API, mas aumentam o tempo de cada requisição
  • Cache os IDs de ativos: Armazene os IDs de ativos localmente para evitar consultas repetidas
  • Implemente limitação de taxa: Respeite os limites de taxa da API para evitar throttling

Referência da API

Endpoints da Master Wallet

Endpoints de Child Address


Suporte

A API Withdraw fornece uma interface flexível para enviar ativos stablecoin para endereços externos. Comece com saques individuais e estimativa de taxas e, em seguida, incorpore operações em lote para pagamentos em massa conforme suas necessidades crescerem.