> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gu1.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# AML Crypto

> Consultas AML de wallets y transacciones con Gu1 AML Crypto: etiquetas, puntuaciones de riesgo, actividad, dark web e historial.

## 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.

<Info>
  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).
</Info>

## Ruta base

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

## Endpoints

| Endpoint                                                                                   | Permiso              | Guarda historial  | Descripción                                                 |
| ------------------------------------------------------------------------------------------ | -------------------- | ----------------- | ----------------------------------------------------------- |
| [Estado del servicio](/es/api-reference/aml-crypto/health)                                 | `aml_crypto:read`    | No                | Disponibilidad del servicio                                 |
| [Etiquetas de una dirección](/es/api-reference/aml-crypto/address-label)                   | `aml_crypto:execute` | Sí (si hay datos) | Categorías y etiquetas de una wallet                        |
| [Riesgo de una dirección](/es/api-reference/aml-crypto/address-risk-score)                 | `aml_crypto:execute` | Sí (si hay datos) | Puntuación y nivel de riesgo de una wallet                  |
| [Actividad de riesgo de una dirección](/es/api-reference/aml-crypto/address-risk-activity) | `aml_crypto:execute` | Sí (sanitizado)   | Actividad sospechosa de una wallet                          |
| [Wallet en la dark web](/es/api-reference/aml-crypto/dark-web-wallet)                      | `aml_crypto:execute` | Sí                | Indicador de presencia en la dark web                       |
| [Riesgo de una transacción](/es/api-reference/aml-crypto/transaction-risk-score)           | `aml_crypto:execute` | Sí                | Puntuación de riesgo de un hash de transacción (solo `eth`) |
| [Listar consultas](/es/api-reference/aml-crypto/list-checks)                               | `aml_crypto:read`    | —                 | Historial paginado de la organización                       |
| [Obtener una consulta](/es/api-reference/aml-crypto/get-check)                             | `aml_crypto:read`    | —                 | Consulta individual por ID                                  |

## Estructura de la respuesta

Las ejecuciones exitosas usan esta estructura:

```json theme={null}
{
  "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

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
```