Skip to main content
Em resumo
A API de Saque da Blockradar permite que você envie stablecoins das 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 de Saque Blockradar

Pré-requisitos

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

Chave API

Obtenha sua chave API no Painel da Blockradar. Navegue até Configurações → Chaves API para gerar uma.
2

Carteira Criada

Crie uma carteira via API Criar Carteira ou pelo painel. Você precisará do walletId para operações de saque.
3

ID do Ativo

Obtenha o assetId do token que deseja sacar em Ativos no painel ou via API Obter Ativos.
4

Saldo Suficiente

Certifique-se de que sua carteira tenha saldo suficiente do ativo para sacar, além de moeda nativa (ETH, BNB, MATIC, etc.) para cobrir as taxas de rede.

Como Funciona

A API de Saque envia stablecoins da sua carteira Blockradar para qualquer endereço blockchain externo:

Saque Individual

Envie ativos para um endereço de 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 sobrecarga e simplificando pagamentos em massa.

Estimativa de Taxas

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

Modo Apenas Assinatura

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

Carteira Principal vs Endereço Filho

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

Carteira Principal

Saque diretamente da sua carteira principal. Ideal para operações de tesouraria e gerenciamento centralizado de fundos.

Endereço Filho

Saque de endereços filhos individuais. Perfeito para operações específicas de usuários e gerenciamento segregado de fundos.

Endpoints


Saque Individual

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

Parâmetros da Requisição

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 de Saque Individual


Saques em Lote

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

Quando Usar Saques em Lote

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

Parâmetros de Requisição em Lote

Para saques em lote, use o array assets ao invés de parâmetros individuais: Cada item no array assets:

Exemplo de Saque em Lote

Resposta de Saque em Lote

Tratando Falhas Parciais

Saques em lote suportam sucesso parcial. Se alguns saques falharem, outros 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 de token nativo e mostrar 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 de Resposta de Taxa


Modo Apenas Assinatura

Assine transações sem transmiti-las para a 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 detalhes da transação antes de transmitir

Exemplo de Apenas Assinatura

Resposta de Apenas Assinatura


Saques de Endereço Filho

Saque de endereços filhos individuais ao invés da carteira principal:
Saques de endereço filho também suportam operações em lote usando o array assets, seguindo o mesmo formato dos saques em lote da carteira principal.

Eventos de Webhook

Monitore a conclusão de saques através de webhooks:

Payload do Webhook


Exemplo de Fluxo Completo

Aqui está uma implementação completa mostrando o fluxo estimativa de taxa → confirmação do usuário → saque:

Respostas de Erro


Melhores Práticas

Segurança

  • Valide endereços: Sempre verifique os endereços de destinatário antes de iniciar saques
  • Use referências: Rastreie saques com IDs de referência únicos para reconciliação
  • Implemente webhooks: Escute os eventos withdraw.success e withdraw.failed para confirmar status
  • Verifique AML: Blockradar examina automaticamente endereços—revise transações sinalizadas

Gerenciamento de Taxas

  • Estime antes de executar: Sempre chame o endpoint network-fee antes de saques
  • Monitore o saldo nativo: Garanta ETH/BNB/MATIC suficiente para taxas de gas
  • Use lotes para eficiência: Agrupe múltiplos saques para reduzir chamadas de API e sobrecarga operacional

Tratamento de Erros

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

Performance

  • Use tamanhos de lote apropriados: Lotes maiores reduzem chamadas de API mas aumentam tempo de requisição individual
  • Armazene IDs de ativos em cache: Armazene 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 Carteira Principal

Endpoints do Endereço Filho


Suporte

A API de Saque fornece uma interface flexível para enviar stablecoins para endereços externos. Comece com saques individuais e estimativa de taxas, depois incorpore operações em lote para pagamentos em massa conforme suas necessidades crescem.