AML Crypto

Descripción general

Gu1 AML Crypto permite analizar direcciones de wallets y hashes de transacciones para detectar señales de riesgo AML (etiquetas, puntuación de riesgo, actividad sospechosa y presencia en la dark web). Gu1 realiza la consulta en tu nombre. Los integradores no llaman directamente al servicio externo.

Requiere que el módulo AML Crypto esté habilitado para tu organización y los permisos aml_crypto:execute (ejecutar consultas) o aml_crypto:read (consultar historial).

Ruta base

https://api.gu1.ai/api/aml-crypto

Endpoints

Endpoint	Permiso	Guarda historial	Descripción
Estado del servicio	`aml_crypto:read`	No	Disponibilidad del servicio
Etiquetas de una dirección	`aml_crypto:execute`	Sí (si hay datos)	Categorías y etiquetas de una wallet
Riesgo de una dirección	`aml_crypto:execute`	Sí (si hay datos)	Puntuación y nivel de riesgo de una wallet
Actividad de riesgo de una dirección	`aml_crypto:execute`	Sí (sanitizado)	Actividad sospechosa de una wallet
Wallet en la dark web	`aml_crypto:execute`	Sí	Indicador de presencia en la dark web
Riesgo de una transacción	`aml_crypto:execute`	Sí	Puntuación de riesgo de un hash de transacción (solo `eth`)
Listar consultas	`aml_crypto:read`	—	Historial paginado de la organización
Obtener una consulta	`aml_crypto:read`	—	Consulta individual por ID

Estructura de la respuesta

Las ejecuciones exitosas usan esta estructura:

{
  "success": true,
  "data": {
    "checkId": "uuid-o-ausente",
    "...": "campos-del-servicio"
  }
}

checkId solo está presente cuando Gu1 guardó un snapshot porque la consulta devolvió datos útiles. Los resultados vacíos no crean una fila en el historial.

Protocolos de direcciones

btc, eth, xrp, egld, algo, sol, trx, flow, one, ltc, bch, zec, dash, bsv, bnb, xvg, btg, matic, avax, xlm, klay Protocolo para transacciones: solo eth. Protocolos para la dark web: btc, eth, xmr, doge.

Códigos de error frecuentes

Código	HTTP	Significado
`AML_CRYPTO_*_FAILED`	4xx/5xx	Falló el servicio o la validación de la operación
`AML_CRYPTO_CHECK_NOT_FOUND`	404	No se encontró el ID de la consulta en esta organización
`PLATFORM_MODULE_NOT_ENABLED`	403	El módulo AML Crypto no está habilitado (cuando la verificación está activa)

Autenticación

Authorization: Bearer YOUR_API_KEY

⌘I

Comenzando

SDK

Casos de Uso

Webhooks

Workflows

Monitoreo (entidades)

Persona

Mensajería

Empresa

Dispositivos

Eventos

Conozca Su Cliente (KYC)

Transacciones

Métodos de Pago

Reglas

Listas personalizadas

Matriz de Riesgo

Alertas

Investigaciones

Ingesta de Datos

Importaciones masivas

Documentos

Enriquecimiento

AML Crypto

Servicios

Integraciones

Tutoriales Interactivos

AML Crypto

Descripción general

Ruta base

Endpoints

Estructura de la respuesta

Protocolos de direcciones

Códigos de error frecuentes

Autenticación

​Descripción general

​Ruta base

​Endpoints

​Estructura de la respuesta

​Protocolos de direcciones

​Códigos de error frecuentes

​Autenticación

Descripción general

Ruta base

Endpoints

Estructura de la respuesta

Protocolos de direcciones

Códigos de error frecuentes

Autenticación