Saltar para o conteúdo principal
Em resumo
A API de Saques permite enviar stablecoins das suas carteiras principais ou endereços secundários para qualquer endereço externo. Suporta saques individuais e em lote, estimativa de taxas de rede e modo somente-assinatura para fluxos de custódia personalizada.

​
Pré-requisitos

1

Chave de API

Obtenha sua chave de API no Dashboard do Blockradar.
2

Carteira com Saldo

Certifique-se de que sua carteira tem saldo suficiente do ativo que deseja enviar, mais o token nativo para taxas de gas.
3

ID do Ativo

Obtenha o assetId específico da carteira em GET /v1/wallets/{walletId}/assets.

​
Carteira Principal vs Endereço Secundário

Carteira Principal

Saque diretamente da sua carteira principal. Ideal para operações de tesouraria e pagamentos de saída.

Endereço Secundário

Saque de endereços individuais de usuário. Ideal para liquidar fundos de usuários específicos.

​
Endpoints

OperaçãoCarteira PrincipalEndereço Secundário
Taxa de RedePOST /v1/wallets/{walletId}/withdraw/network-feePOST /v1/wallets/{walletId}/addresses/{addressId}/withdraw/network-fee
SacarPOST /v1/wallets/{walletId}/withdrawPOST /v1/wallets/{walletId}/addresses/{addressId}/withdraw

​
Passo 1: Estimar a Taxa de Rede

const fee = await fetch(
  `https://api.blockradar.co/v1/wallets/${walletId}/withdraw/network-fee`,
  {
    method: 'POST',
    headers: { 'Content-Type': 'application/json', 'x-api-key': apiKey },
    body: JSON.stringify({
      assetId: 'asset_usdc_base_mainnet',
      amount: '100',
      recipientAddress: '0xDestinoExterno'
    })
  }
).then(r => r.json());

​
Passo 2: Executar o Saque

const withdrawal = await fetch(
  `https://api.blockradar.co/v1/wallets/${walletId}/withdraw`,
  {
    method: 'POST',
    headers: { 'Content-Type': 'application/json', 'x-api-key': apiKey },
    body: JSON.stringify({
      assetId: 'asset_usdc_base_mainnet',
      amount: '100',
      recipientAddress: '0xDestinoExterno',
      reference: 'pagamento-123',
      metadata: { userId: 'usuario_abc' }
    })
  }
).then(r => r.json());

​
Eventos Webhook

EventoDescrição
withdrawal.successSaque confirmado on-chain
withdrawal.failedSaque falhou

​
Referência de API

EndpointDescrição
Taxa de Rede - Carteira PrincipalEstimar gas da carteira principal
Sacar - Carteira PrincipalExecutar saque da carteira principal
Taxa de Rede - Endereço SecundárioEstimar gas do endereço secundário
Sacar - Endereço SecundárioExecutar saque do endereço secundário