API de Análise de Carteiras: Risco On-Chain a €0.02 (BYOK) (PT-PT)

Uma verificação KYC informa que o proprietário de uma carteira é uma pessoa real. Não diz nada sobre por onde as moedas dessa carteira passaram. Na blockchain, 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 carteiras — 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 Carteiras da Didit avalia qualquer endereço de carteira de cripto ou hash de transação quanto à inteligência de risco on-chain. Envia um endereço, e ela retorna uma pontuação de risco de 0–100, uma banda BAIXA/MÉDIA/ALTA/CRÍTICA, e um detalhe das categorias de risco a que os fundos estão expostos — sanções, mixers, mercados darknet, ransomware, fundos roubados e muito mais. Custa €0.02 por análise com a sua própria chave (BYOK), aproximadamente 10× mais barato do que comprar uma subscrição de análise de blockchain diretamente.

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

Principais conclusões

• 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 veredicto de risco.
• Pontuação de risco de 0–100 mapeada para quatro bandas — BAIXA / MÉDIA / ALTA / CRÍTICA — para que a política seja um único limiar, não um projeto de pesquisa.
• Mais de 14 categorias de origem de fundos — SANCTIONED, TERRORIST_FINANCING, RANSOMWARE, DARKNET_MARKET, MIXER, STOLEN_FUNDS, SCAM, e mais — cada uma mostrada por tipo de exposição.
• Tabela de exposição + gráfico de rede — exposição direta e indireta (múltiplos saltos) para que veja não apenas a contraparte, mas também de onde vieram os seus fundos.
• BYOK a €0.02 por análise. Traga a sua própria chave Crystal ou Merkle Science; Chainalysis e Elliptic estarão disponíveis em breve. Preços geridos também estão disponíveis.
• Integrado na Monitorização de Transações — transações cripto podem acionar a análise de carteiras automaticamente, sem necessidade de infraestrutura adicional.

O que faz a análise de carteiras

Blockchains são registos públicos, mas os dados brutos das transações não são dados de risco. Transformar um endereço num veredicto 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 depois rastreia como o valor flui entre eles.

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

Porque é que é importante

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

O problema clássico é o custo. As plataformas de análise de blockchain são vendidas como subscrições empresariais com mínimos anuais de cinco e seis dígitos — uma verdadeira barreira para uma equipa que apenas precisa de analisar carteiras no momento do depósito. A Didit remove essa barreira com BYOK: traz a sua própria chave de fornecedor, paga €0.02 por análise através da API unificada da Didit e evita completamente as licenças de utilizador.

Detalhes técnicos

A análise de carteiras é executada dentro da Monitorização de Transações na API unificada /v3/. Quando submete uma transação cripto, o motor pode analisar a contraparte automaticamente; 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 veredicto da análise — uma pontuação numérica, a banda e o detalhe 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 bandas de risco. Cada análise retorna uma pontuação de 0–100 mapeada para quatro bandas:

Banda	Pontuação	Política típica
LOW	0–24	Aprovar
MEDIUM	25–49	Aprovar com registo / revisão suave
HIGH	50–79	Aguardar revisão do analista
CRITICAL	80–100	Recusar / congelar

Categorias de origem de fundos. A exposição é atribuída a categorias específicas — SANCTIONED, TERRORIST_FINANCING, CHILD_EXPLOITATION, RANSOMWARE, STOLEN_FUNDS, DARKNET_MARKET, MIXER, SCAM, HIGH_RISK_EXCHANGE, HIGH_RISK_JURISDICTION, GAMBLING_UNLICENSED, P2P_EXCHANGE, EXCHANGE, e UNNAMED_SERVICE — para que veja o motivo de uma pontuação, não apenas o número.

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

Preço. €0.02 por análise com BYOK (Crystal ou Merkle Science). O preço gerido — onde a Didit fornece os dados — é de €0.18 por análise com Crystal e €0.15 com Merkle Science.

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

A análise de carteiras funciona em dois pontos do fluxo. A análise pré-transferência recebe um endereço de carteira e avalia o seu risco antes de aceitar um depósito ou libertar um levantamento — a decisão ocorre antes de o valor se mover. A análise pós-transferência recebe um hash de transação (passado como payment_reference_id) e avalia uma transação liquidada após o facto, para registo e revisão contínua. A maioria das equipas executa ambos: pré-transferência para controlar o fluxo, pós-transferência para manter um rasto auditável.

Casos de uso

• Exchanges de cripto — analisam cada endereço de depósito na entrada e cada destino de levantamento na saída; recusam automaticamente o CRÍTICO, encaminham o ALTO para um analista.
• On/off-ramps — controlam as conversões fiat-para-cripto e cripto-para-fiat com base na exposição da carteira da contraparte antes de liquidar.
• Custodiantes — analisam carteiras na entrada e reanalisam no movimento, com o gráfico de rede como prova para qualquer ativo congelado.
• Carteiras — protegem os utilizadores alertando ou bloqueando transferências para endereços com alta exposição a sanções ou scams.
• VASPs — combinam a análise de carteiras com a troca de dados da Regra de Viagem da FATF para que o risco da contraparte e da origem sejam avaliados em conjunto.

Como integrar com a Didit

1. Defina o seu fornecedor e padrão. Na Consola de Negócios em Transações → Definições, escolha Crystal ou Merkle Science, adicione a sua chave BYOK e defina se as transações cripto são analisadas por padrão.
2. 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.
3. Leia o veredicto. Aja com base na risk_band e no detalhe da exposição — passe BAIXO/MÉDIO, retenha ALTO, recuse CRÍTICO.
4. Trabalhe os alertas na Consola. Uma análise de alto risco abre um alerta com o gráfico de rede anexado, pronto para investigação e apresentação de SAR.

Como tudo está na API unificada /v3/, a análise de carteiras, a monitorização de transações, KYC e AML compõem uma plataforma única 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 carteiras?

€0.02 por análise com a sua própria chave (Crystal ou Merkle Science) — aproximadamente 10× mais barato do que comprar uma subscrição de análise de blockchain diretamente. O preço gerido é de €0.18 (Crystal) ou €0.15 (Merkle Science) por análise.

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

Crystal e Merkle Science hoje, via BYOK ou gerido. Chainalysis e Elliptic estarão disponíveis em breve, também a €0.02 BYOK.

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

A pontuação é um número de 0–100; a banda (BAIXA/MÉDIA/ALTA/CRÍTICA) é o balde em que se insere, para que possa escrever políticas contra um rótulo em vez de ajustar os limiares numéricos por si mesmo.

Posso analisar uma carteira sem enviar dinheiro?

Sim. A análise pré-transferência recebe um endereço de carteira e retorna o risco antes de qualquer valor se mover, para que possa decidir se aceita um depósito ou liberta um levantamento.

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

Sim. A exposição é reportada como direta ou indireta com contagens de saltos, e um gráfico de rede traça como os fundos chegaram a uma entidade de risco através de intermediários.

Pronto para começar?

Leia a visão geral da Análise de Carteiras na documentação, veja como se encaixa na plataforma na página do produto Análise de Carteiras, 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 carteiras a €0.02 por análise com BYOK.