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

> Verificações AML de wallets e transações com o Gu1 AML Crypto: rótulos, pontuações de risco, atividade, dark web e histórico.

## Visão geral

O Gu1 AML Crypto permite analisar **endereços de wallets** e **hashes de transações** para detectar sinais de risco AML (rótulos, pontuação de risco, atividade suspeita e presença na dark web).

O Gu1 realiza a consulta em seu nome. Os integradores **não** chamam diretamente o serviço externo.

<Info>
  Requer que o módulo **AML Crypto** esteja habilitado para sua organização e as permissões `aml_crypto:execute` (executar verificações) ou `aml_crypto:read` (consultar histórico).
</Info>

## Rota base

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

## Endpoints

| Endpoint                                                                                | Permissão            | Salva histórico       | Descrição                                                  |
| --------------------------------------------------------------------------------------- | -------------------- | --------------------- | ---------------------------------------------------------- |
| [Status do serviço](/pt/api-reference/aml-crypto/health)                                | `aml_crypto:read`    | Não                   | Disponibilidade do serviço                                 |
| [Rótulos de um endereço](/pt/api-reference/aml-crypto/address-label)                    | `aml_crypto:execute` | Sim (se houver dados) | Categorias e rótulos de uma wallet                         |
| [Risco de um endereço](/pt/api-reference/aml-crypto/address-risk-score)                 | `aml_crypto:execute` | Sim (se houver dados) | Pontuação e nível de risco de uma wallet                   |
| [Atividade de risco de um endereço](/pt/api-reference/aml-crypto/address-risk-activity) | `aml_crypto:execute` | Sim (sanitizado)      | Atividade suspeita de uma wallet                           |
| [Wallet na dark web](/pt/api-reference/aml-crypto/dark-web-wallet)                      | `aml_crypto:execute` | Sim                   | Indicador de presença na dark web                          |
| [Risco de uma transação](/pt/api-reference/aml-crypto/transaction-risk-score)           | `aml_crypto:execute` | Sim                   | Pontuação de risco de um hash de transação (somente `eth`) |
| [Listar verificações](/pt/api-reference/aml-crypto/list-checks)                         | `aml_crypto:read`    | —                     | Histórico paginado da organização                          |
| [Obter uma verificação](/pt/api-reference/aml-crypto/get-check)                         | `aml_crypto:read`    | —                     | Verificação individual por ID                              |

## Estrutura da resposta

As execuções bem-sucedidas usam esta estrutura:

```json theme={null}
{
  "success": true,
  "data": {
    "checkId": "uuid-ou-ausente",
    "...": "campos-do-serviço"
  }
}
```

`checkId` só está presente quando o Gu1 salvou um snapshot porque a consulta retornou dados úteis. Resultados vazios não criam uma linha no histórico.

## Protocolos de endereços

`btc`, `eth`, `xrp`, `egld`, `algo`, `sol`, `trx`, `flow`, `one`, `ltc`, `bch`, `zec`, `dash`, `bsv`, `bnb`, `xvg`, `btg`, `matic`, `avax`, `xlm`, `klay`

Protocolo para transações: **somente `eth`**.

Protocolos para a dark web: `btc`, `eth`, `xmr`, `doge`.

## Códigos de erro frequentes

| Código                        | HTTP    | Significado                                                               |
| ----------------------------- | ------- | ------------------------------------------------------------------------- |
| `AML_CRYPTO_*_FAILED`         | 4xx/5xx | Falha no serviço ou na validação da operação                              |
| `AML_CRYPTO_CHECK_NOT_FOUND`  | 404     | O ID da verificação não foi encontrado nesta organização                  |
| `PLATFORM_MODULE_NOT_ENABLED` | 403     | O módulo AML Crypto não está habilitado (quando a verificação está ativa) |

## Autenticação

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