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

# API de triagem de carteiras: $0.15 por consulta

> A Didit faz triagem de carteiras e hashes de transação por $0.15 a consulta. Veja pontuação de risco, origem dos fundos e relações na rede.

A **Triagem de carteiras** da Didit verifica o risco em blockchain por **\$0.15 por triagem de carteira ou de hash de transação**. Faça a triagem de carteiras antes de uma transferência, de hashes de transação depois dela e envie os resultados para o [motor de regras do Monitoramento de transações](https://docs.didit.me/transaction-monitoring/rules.md).

A aula da Academy sobre o motor de regras chega ao risco de carteira em 3:00: o que significam as faixas da pontuação e como a exposição de uma carteira alimenta a pontuação de risco da transação.

[Risco de carteira e o que significam as faixas da pontuação — Didit Academy](https://www.youtube.com/embed/Yhm63_n7HuU?start=180\&rel=0\&playsinline=1)

A Triagem de carteiras faz parte da etapa de **Monitoramento** do ciclo de vida da Didit: verificações que rodam continuamente, após o onboarding, em cada fluxo de fundos que entra ou sai da sua plataforma.

## Como funciona

1. **Conecte um provedor.** Em **Transações → Configurações → Provider Preferences** no [Business Console](https://business.didit.me), escolha o preço gerenciado ou conecte a chave de API de um provedor existente no **Marketplace** do console. O provedor padrão é a Merkle Science, o único com preço gerenciado.
2. **Envie uma transação com dados cripto.** Defina `transaction_details.currency_kind: "crypto"` e informe um endereço de carteira no participante correspondente à direção da transferência. A Didit faz a triagem da carteira (antes da transferência) ou do hash da transação (depois) automaticamente.
3. **Receba um resultado padronizado.** Pontuação de risco de 0 a 100, severidade (`LOW`, `MEDIUM`, `HIGH`, `CRITICAL`), detalhamento da origem dos fundos, tabela de exposição e grafo de rede. O resultado alimenta o motor de regras e dispara os webhooks correspondentes.

## Blockchains compatíveis

A triagem gerenciada de carteiras e de hashes de transação oferece suporte a 13 redes: Bitcoin (`BTC`), Ethereum (`ETH`), Litecoin (`LTC`), XRP Ledger (`XRP`), Bitcoin Cash (`BCH`), Dogecoin (`DOGE`), Tron (`TRX`), Solana (`SOL`), Polygon (`MATIC`), BNB Smart Chain (`BNB`), Base (`BASE`), Optimism (`OP`) e Arbitrum One (`ARB`).

Use a rede real em cada consulta.
O mesmo endereço pode ter atividade e risco diferentes em cadeias diferentes.
Celo (`CELO`), Mode (`MODE`) e Plume (`PLUME`) não são cobertas pela integração gerenciada; elas passam pela triagem de uma conta TRM Labs conectada.
Os provedores conectados têm cobertura própria, e a Lightning exige um provedor conectado compatível.

Para tokens, incluindo USDT e USDC, mantenha o símbolo do ativo em `transaction_details.currency` e defina a rede em `transaction_details.crypto_params.crypto_chain`.
A cobertura de transferências de tokens personalizados depende de o contrato do token estar indexado naquela rede.
Veja [triagem de carteiras e cobertura de cadeias](https://docs.didit.me/transaction-monitoring/wallet-screening.md#chain-coverage) e [seleção de ativo e rede](https://docs.didit.me/transaction-monitoring/aml-screening.md#asset-and-network-selection).

## Sinais de risco

Toda triagem produz um payload padronizado, independentemente do provedor por trás dela:

* **Pontuação de risco (0-100)** - quanto maior, maior a exposição a entidades de risco.
* **Severidade** - `LOW`, `MEDIUM`, `HIGH`, `CRITICAL`, derivada da pontuação.
* **Origem dos fundos** - detalhamento percentual em 14+ categorias (sancionados, financiamento do terrorismo, exploração infantil, ransomware, fundos roubados, mercados da darknet, mixers, golpes, exchanges de alto risco, jogos de azar, exchanges regulamentadas, P2P, serviços não identificados).
* **Tabela de exposição** - entidades contraparte com distância direta vs. indireta em saltos, valores recebidos e enviados e nível de risco por entidade.
* **Grafo de rede** - visão de nós e arestas das relações de transação da carteira, com métricas de centralidade e profundidade. Visualizado no [Business Console](https://docs.didit.me/transaction-monitoring/console.md).
* **Sinalizações de sanções, darknet e mixers** - apresentadas como sinais discretos para que as regras possam recusar de imediato.

## Provedores

| Provedor | Status | Preço gerenciado | Preço com chave conectada |
| - | - | - | - |
| **Merkle Science** | Disponível | \$0.15 / triagem | **\$0.02 / triagem** |
| **Crystal** | Conecte uma chave de provedor pelo Marketplace | Não disponível | **\$0.02 / triagem** |
| **Chainalysis** | Conecte uma chave de provedor pelo Marketplace | Não disponível | **\$0.02 / triagem** |
| **Elliptic** | Conecte uma chave de provedor pelo Marketplace | Não disponível | **\$0.02 / triagem** |
| **TRM Labs** | Conecte uma chave de provedor pelo Marketplace | Não disponível | **\$0.02 / triagem** |

> [!TIP]
>
> **Conectar a chave do seu provedor** permite usar um contrato comercial existente com um provedor de análise de blockchain. A Didit cobra uma taxa de infraestrutura de \$0.02 por cada triagem roteada por um fluxo de verificação (workflow) da Didit.

## Preços

\*\*A Triagem de carteiras custa $0.15 por consulta com o preço gerenciado da Merkle Science.** Se você conectar a chave de um provedor existente, de qualquer um dos listados, a Didit cobra uma taxa de infraestrutura de $0.02 por triagem. Não há mínimos nem contratos. Veja a [página de preços](https://didit.me/pricing) para preços por volume.

## Integração

Toda a superfície da API - payloads de requisição, regras de direção, triagem antes vs. depois da transferência e a integração com o motor de regras - está na [página de Triagem AML do Monitoramento de transações](https://docs.didit.me/transaction-monitoring/aml-screening.md). A Triagem de carteiras é ativada definindo `currency_kind: "crypto"` na transação e habilitando o padrão no nível da aplicação no Console.

> **[API: triagem cripto](https://docs.didit.me/transaction-monitoring/aml-screening.md)**
>
> Payloads antes vs. depois da transferência, campos obrigatórios, formato da resposta.

> **[Regras e pontuação](https://docs.didit.me/transaction-monitoring/rules.md)**
>
> Como os resultados da triagem de carteiras alimentam o motor de regras em tempo real.

> **[Casos e fluxo de SAR](https://docs.didit.me/transaction-monitoring/cases.md)**
>
> Faça a triagem de alertas de carteiras de alto risco, redija SARs e mantenha uma trilha de auditoria.

> **[Travel Rule](https://docs.didit.me/transaction-monitoring/travel-rule.md)**
>
> Suporte à Travel Rule do FATF para VASPs e exchanges de cripto.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.