Saltar al contenido principal
En resumen
La API de AML te permite verificar cualquier dirección de billetera contra las listas de bloqueo de OFAC, FBI, Tether y Circle antes de enviar o recibir fondos. Úsala para marcar contrapartes de alto riesgo y cumplir con tus obligaciones de cumplimiento sin construir tu propia infraestructura de verificación.

Requisitos Previos

1

Clave API

Obtén tu clave API desde el Dashboard de Blockradar. Ve a Desarrolladores para generar una.

Cómo Funciona

Antes de enviar fondos a una dirección externa — o antes de acreditar un depósito proveniente de una — puedes ejecutar una verificación AML en tiempo real. Blockradar verifica la dirección contra múltiples listas de bloqueo y devuelve una evaluación de riesgo que puedes usar para decidir si proceder.

Sanciones OFAC

Verifica contra la lista de sanciones de la Oficina de Control de Activos Extranjeros de EE.UU., que cubre personas y entidades sujetas a sanciones económicas.

Lista de Vigilancia del FBI

Comprueba direcciones marcadas por el FBI en relación con ciberdelincuencia, ransomware y otras actividades ilícitas.

Lista de Bloqueo de Tether

Identifica direcciones que Tether ha bloqueado y congelado para transacciones en USDT.

Lista de Bloqueo de Circle

Identifica direcciones que Circle ha bloqueado y congelado para transacciones en USDC.

Verificar una Dirección

GET /v1/aml/lookup?address={address}
const result = await fetch(
  `https://api.blockradar.co/v1/aml/lookup?address=0xabc123...`,
  {
    headers: { 'x-api-key': apiKey }
  }
).then(r => r.json());

if (result.isBlacklisted) {
  console.log('Dirección de alto riesgo — no proceder');
} else {
  console.log('Dirección sin restricciones');
}

Respuesta

{
  "isBlacklisted": false,
  "provider": "ofac, fbi, tether, circle",
  "status": "success",
  "message": "Address is not sanctioned"
}
Si la dirección está marcada, isBlacklisted será true y el message indicará la fuente de la sanción.

Cuándo Verificar

Antes de Enviar Fondos

Verifica la dirección de destino antes de ejecutar un retiro para evitar enviar a una billetera sancionada o bloqueada.

Antes de Acreditar Depósitos

Verifica la dirección del remitente cuando llega un depósito antes de acreditar los fondos en tu sistema.

Mejores Prácticas

  • Verifica antes de cada transferencia saliente — ejecuta una verificación antes de cualquier retiro a una dirección externa que no hayas examinado previamente.
  • Verifica depósitos entrantes — usa la dirección del remitente de tu payload de webhook para verificar depósitos antes de acreditarlos.
  • Registra los resultados de verificación — almacena el resultado de la verificación AML junto a cada transacción para fines de auditoría y cumplimiento.
  • Ten una política de escalación clara — decide con anticipación qué ocurre cuando se marca una dirección: bloquear la transacción, retener para revisión, o alertar a tu equipo de cumplimiento.

Referencia de API

EndpointDescripción
AML LookupVerifica una dirección de billetera contra listas de bloqueo globales