Blog · 21 de maio de 2026

API de Análise de Carteira: Risco On-Chain por R$0,10 (BYOK) (PT-BR)

Analise qualquer carteira de criptomoedas ou hash de transação quanto a riscos on-chain — sanções, mixers, darknet, ransomware — com uma pontuação de 0 a 100 e detalhamento da origem dos fundos, por R$0,10 com sua própria chave.

Por Didit21 de maio de 2026Atualizado 21 de mai. de 2026

Uma verificação KYC informa que o proprietário de uma carteira é uma pessoa real. Não informa nada sobre o histórico das moedas nessa carteira. On-chain, uma carteira que parece comum pode estar a um salto de um endereço sancionado, a dois saltos de um mercado darknet, ou recém-saída de um mixer. A análise de carteira — Know Your Transaction (KYT) — é a camada que lê esse histórico antes de permitir que o valor se mova.

A API de Análise de Carteira da Didit pontua qualquer endereço de carteira de criptomoedas ou hash de transação com base em inteligência de risco on-chain. Você envia um endereço, ela retorna uma pontuação de risco de 0 a 100, uma faixa BAIXO/MÉDIO/ALTO/CRÍTICO e um detalhamento das categorias de risco às quais os fundos estão expostos — sanções, mixers, mercados darknet, ransomware, fundos roubados e muito mais. Custa R$0,10 por análise com sua própria chave (BYOK), aproximadamente 10 vezes mais barato do que comprar uma assinatura direta de análise de blockchain.

Este guia aborda o que a API analisa, como funciona a pontuação e como integrá-la em um fluxo de depósito ou retirada.

Principais pontos

Uma chamada, risco on-chain. Envie um endereço de carteira (pré-transferência) ou um hash de transação (pós-transferência) e receba um veredito de risco.
Pontuação de risco de 0 a 100 mapeada para quatro faixas — BAIXO / MÉDIO / ALTO / CRÍTICO — para que a política seja um único limite, não um projeto de pesquisa.
Mais de 14 categorias de origem de fundos — SANCTIONED (SANCIONADO), TERRORIST_FINANCING (FINANCIAMENTO AO TERRORISMO), RANSOMWARE, DARKNET_MARKET (MERCADO DARKNET), MIXER, STOLEN_FUNDS (FUNDOS ROUBADOS), SCAM (GOLPE) e mais — cada uma mostrada por tipo de exposição.
Tabela de exposição + grafo de rede — exposição direta e indireta (múltiplos saltos) para que você veja não apenas a contraparte, mas também a origem de seus fundos.
BYOK por R$0,10 por análise. Traga sua própria chave Crystal ou Merkle Science; Chainalysis e Elliptic em breve. Preços gerenciados também estão disponíveis.
Integrado ao Monitoramento de Transações — transações cripto podem acionar a análise de carteira automaticamente, sem necessidade de configuração extra.

O que a análise de carteira faz

Blockchains são livros-razão públicos, mas dados brutos de transação não são dados de risco. Transformar um endereço em um veredito de risco requer uma camada de agrupamento e rotulagem que mapeia endereços para entidades do mundo real — exchanges, mixers, carteiras sancionadas, operadores de ransomware, mercados darknet — e então rastreia como o valor flui entre eles.

A API de Análise de Carteira da Didit se baseia nessa inteligência. Você fornece um endereço de carteira e ela analisa a exposição do endereço: quanto de seu valor de entrada e saída se conecta a entidades de risco, direta ou indiretamente, através de saltos intermediários. Ela retorna uma única pontuação de risco, a faixa em que essa pontuação se enquadra e as categorias que impulsionam o risco — para que uma política de conformidade possa ser expressa como "bloquear CRÍTICO, revisar ALTO, aprovar o restante".

Por que isso importa

Para qualquer negócio que lide com criptomoedas — uma exchange, uma plataforma on/off-ramp, um custodiante, uma carteira, um VASP — aceitar fundos é aceitar seu histórico. A exposição a sanções é o ponto mais crítico: mover valor para ou de uma carteira em uma lista de sanções é uma violação, independentemente da intenção. Mas o risco prático é mais amplo. Fundos lavados por um mixer, produtos de um pagamento de ransomware ou moedas drenadas em um exploit aparecem como exposição on-chain muito antes de surgirem em qualquer outro lugar.

O problema clássico é o custo. Plataformas de análise de blockchain são vendidas como assinaturas corporativas com mínimos anuais de cinco e seis dígitos — uma barreira real para uma equipe que apenas precisa analisar carteiras no ponto de depósito. A Didit remove essa barreira com BYOK: você traz sua própria chave de provedor, paga R$0,10 por análise através da API unificada da Didit, e pula completamente as licenças de usuário.

Detalhes técnicos

A análise de carteira é executada dentro do Monitoramento de Transações na API unificada /v3/. Ao enviar uma transação cripto, o motor pode analisar a contraparte automaticamente; você também pode analisar explicitamente definindo currency_kind: "crypto" com uma direção.

curl -X POST https://verification.didit.me/v3/transactions/ \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transaction_id": "txn_5b21fa",
    "category": "finance",
    "amount": 12500,
    "currency": "USDT",
    "currency_kind": "crypto",
    "direction": "INBOUND",
    "wallet_address": "0x9f1c...e3a2",
    "include_crypto_screening": true,
    "subject": { "vendor_data": "user_7781", "role": "RECEIVER" }
  }'

A resposta contém o veredito da análise — uma pontuação numérica, a faixa e o detalhamento da exposição:

{
  "transaction_id": "txn_5b21fa",
  "status": "IN_REVIEW",
  "wallet_screening": {
    "risk_score": 78,
    "risk_band": "HIGH",
    "provider": "crystal",
    "exposure": [
      { "category": "MIXER", "type": "INDIRECT", "hops": 2, "share": 0.34 },
      { "category": "DARKNET_MARKET", "type": "INDIRECT", "hops": 3, "share": 0.11 }
    ]
  }
}

Pontuação e faixas de risco. Toda análise retorna uma pontuação de 0 a 100 mapeada para quatro faixas:

Faixa	Pontuação	Política Típica
`BAIXO`	0–24	Aprovar
`MÉDIO`	25–49	Aprovar com registro / revisão suave
`ALTO`	50–79	Aguardar revisão do analista
`CRÍTICO`	80–100	Recusar / congelar

Categorias de origem de fundos. A exposição é atribuída a categorias específicas — SANCTIONED (SANCIONADO), TERRORIST_FINANCING (FINANCIAMENTO AO TERRORISMO), CHILD_EXPLOITATION (EXPLORAÇÃO INFANTIL), RANSOMWARE, STOLEN_FUNDS (FUNDOS ROUBADOS), DARKNET_MARKET (MERCADO DARKNET), MIXER, SCAM (GOLPE), HIGH_RISK_EXCHANGE (EXCHANGE DE ALTO RISCO), HIGH_RISK_JURISDICTION (JURISDIÇÃO DE ALTO RISCO), GAMBLING_UNLICENSED (JOGOS DE AZAR NÃO LICENCIADOS), P2P_EXCHANGE (EXCHANGE P2P), EXCHANGE e UNNAMED_SERVICE (SERVIÇO NÃO NOMEADO) — para que você veja o motivo de uma pontuação, não apenas o número.

Tipo de exposição e grafo de rede. Cada categoria é relatada como direta (a carteira transacionou com a entidade de risco) ou indireta (o valor a alcançou através de saltos intermediários), com a contagem de saltos. Um grafo de rede rastreia o caminho para que um analista possa ver como os fundos se conectam.

Preço. R$0,10 por análise com BYOK (Crystal ou Merkle Science). O preço gerenciado — onde a Didit fornece os dados — é R$0,90 por análise com Crystal e R$0,75 com Merkle Science.

Análise pré-transferência e pós-transferência

A análise de carteira funciona em dois pontos do fluxo. A análise pré-transferência utiliza um endereço de carteira e avalia seu risco antes de você aceitar um depósito ou liberar uma retirada — a decisão acontece antes que o valor se mova. A análise pós-transferência utiliza um hash de transação (passado como payment_reference_id) e avalia uma transação liquidada após o fato, para fins de registro e revisão contínua. A maioria das equipes executa ambas: pré-transferência para controlar o fluxo, pós-transferência para manter um rastro auditável.

Casos de uso

Exchanges de criptomoedas — analise cada endereço de depósito na entrada e cada destino de retirada na saída; recuse automaticamente CRÍTICO, encaminhe ALTO para um analista.
Plataformas On/Off-ramp — controle as conversões de fiat para cripto e de cripto para fiat com base na exposição da carteira da contraparte antes de liquidar.
Custodiantes — analise carteiras na entrada e reanalise no movimento, com o grafo de rede como evidência para qualquer ativo congelado.
Carteiras — proteja os usuários alertando ou bloqueando transferências para endereços com alta exposição a sanções ou golpes.
VASPs — combine a análise de carteiras com a troca de dados da Regra de Viagem do FATF para que o risco da contraparte e da origem sejam avaliados juntos.

Como integrar com a Didit

Defina seu provedor e padrão. No Console de Negócios em Transações → Configurações, escolha Crystal ou Merkle Science, adicione sua chave BYOK e defina se as transações cripto são analisadas por padrão.
Envie transações cripto. POST /v3/transactions/ com currency_kind: "crypto" e uma direção. Use include_crypto_screening para substituir o padrão por chamada.
Leia o veredito. Aja com base na risk_band e no detalhamento da exposição — aprove BAIXO/MÉDIO, segure ALTO, recuse CRÍTICO.
Trabalhe com alertas no Console. Uma análise de alto risco abre um alerta com o grafo de rede anexado, pronto para investigação e registro de SAR.

Como tudo está na API unificada /v3/, a análise de carteira, o monitoramento de transações, o KYC e o AML se combinam em uma plataforma de identidade e fraude — uma carteira sinalizada pode pausar uma transação e acionar uma etapa de remediação automaticamente.

Perguntas frequentes

Quanto custa a análise de carteira?

R$0,10 por análise com sua própria chave (Crystal ou Merkle Science) — aproximadamente 10 vezes mais barato do que comprar uma assinatura direta de análise de blockchain. O preço gerenciado é R$0,90 (Crystal) ou R$0,75 (Merkle Science) por análise.

Quais provedores de análise de blockchain são suportados?

Crystal e Merkle Science hoje, via BYOK ou gerenciado. Chainalysis e Elliptic estão chegando em breve, também por R$0,10 BYOK.

Qual a diferença entre a pontuação de risco e a faixa de risco?

A pontuação é um número de 0 a 100; a faixa (BAIXO/MÉDIO/ALTO/CRÍTICO) é a categoria em que ela se enquadra, para que você possa escrever a política com base em um rótulo em vez de ajustar os limites numéricos você mesmo.

Posso analisar uma carteira sem enviar dinheiro?

Sim. A análise pré-transferência leva um endereço de carteira e retorna o risco antes que qualquer valor se mova, para que você possa decidir se aceita um depósito ou libera uma retirada.

Abrange exposição indireta, não apenas a contraparte direta?

Sim. A exposição é relatada como direta ou indireta com contagem de saltos, e um grafo de rede rastreia como os fundos alcançaram uma entidade de risco através de intermediários.

Pronto para começar?

Leia a visão geral da Análise de Carteira na documentação, veja como ela se encaixa na plataforma na página do produto Análise de Carteira e verifique os preços transparentes por chamada na página de preços. Quando estiver pronto, comece gratuitamente — 500 verificações KYC gratuitas todos os meses e análise de carteira por R$0,10 por análise com BYOK.