API de Detecció de Carteres: Risc On-Chain per 0,02 $ (BYOK) (CA)

Una comprovació KYC t'indica que el propietari d'una cartera és una persona real. Però no t'informa sobre l'origen de les monedes d'aquesta cartera. A la cadena, una cartera que sembla ordinària pot estar a un salt d'una adreça sancionada, a dos salts d'un mercat de la darknet, o acabada de sortir d'un mesclador. La detecció de carteres — Know Your Transaction (KYT) — és la capa que llegeix aquesta història abans de permetre el moviment de valor.

L'API de Detecció de Carteres de Didit avalua qualsevol adreça de cartera de criptomonedes o hash de transacció contra la intel·ligència de risc a la cadena. Envies una adreça, retorna una puntuació de risc de 0 a 100, una banda BAIX/MITJÀ/ALT/CRÍTIC, i un desglossament de les categories de risc a les quals estan exposats els fons — sancions, mescladors, mercats de la darknet, ransomware, fons robats, i més. Costa 0,02 $ per detecció amb la teva pròpia clau (BYOK), aproximadament 10 vegades més barat que comprar una subscripció directa d'anàlisi de blockchain.

Aquesta guia cobreix què detecta l'API, com funciona la puntuació i com connectar-la a un flux de dipòsit o retirada.

Punts clau

• Una trucada, risc a la cadena. Envia una adreça de cartera (prèvia a la transferència) o un hash de transacció (posterior a la transferència) i obtén un veredicte de risc.
• Puntuació de risc de 0 a 100 mapejada a quatre bandes — BAIX / MITJÀ / ALT / CRÍTIC — de manera que la política és un únic llindar, no un projecte de recerca.
• Més de 14 categories d'origen de fons — SANCIONAT, FINANÇAMENT_TERRORISTA, RANSOMWARE, MERCAT_DARKNET, MESCLADOR, FONS_ROBATS, ESTAFA, i més — cadascuna mostrada per tipus d'exposició.
• Taula d'exposició + gràfic de xarxa — exposició directa i indirecta (multisalt) perquè vegis no només la contrapart sinó també d'on provenien els seus fons.
• BYOK per 0,02 $ per detecció. Porta la teva pròpia clau de Crystal o Merkle Science; Chainalysis i Elliptic estaran disponibles aviat. També hi ha preus gestionats disponibles.
• Integrat en el Monitoratge de Transaccions — les transaccions de criptomonedes poden activar la detecció de carteres automàticament, sense necessitat de configuració addicional.

Què fa la detecció de carteres

Les blockchains són registres públics, però les dades de transacció brutes no són dades de risc. Convertir una adreça en un veredicte de risc requereix una capa de clustering i etiquetatge que mapeja les adreces a entitats del món real — intercanvis, mescladors, carteres sancionades, operadors de ransomware, mercats de la darknet — i després rastreja com flueix el valor entre elles.

L'API de Detecció de Carteres de Didit se situa al damunt d'aquesta intel·ligència. Li dones una adreça de cartera i analitza l'exposició de l'adreça: quanta part del seu valor d'entrada i sortida es connecta a entitats de risc, directament o a través de salts intermediaris. Retorna una única puntuació de risc, la banda en què cau aquesta puntuació i les categories que impulsen el risc — de manera que una política de compliment es pot expressar com a "bloquejar CRÍTIC, revisar ALT, passar la resta".

Per què és important

Per a qualsevol negoci que treballi amb criptomonedes — un intercanvi, una passarel·la d'entrada/sortida, un custodi, una cartera, un VASP — acceptar fons és acceptar la seva història. L'exposició a sancions és l'avantatge més nítid: moure valor cap o des d'una cartera en una llista de sancions és una violació independentment de la intenció. Però el risc pràctic és més ampli. Els fons blanquejats a través d'un mesclador, els guanys d'un pagament de ransomware, o les monedes drenades en una explotació apareixen com a exposició a la cadena molt abans que apareguin en qualsevol altre lloc.

El problema clàssic és el cost. Les plataformes d'anàlisi de blockchain es venen com a subscripcions empresarials amb mínims anuals de cinc i sis xifres — una barrera real per a un equip que només necessita detectar carteres en el moment del dipòsit. Didit elimina aquesta barrera amb BYOK: aportes la teva pròpia clau de proveïdor, pagues 0,02 $ per detecció a través de l'API unificada de Didit i t'estalvies completament les llicències per usuari.

Detalls tècnics

La detecció de carteres s'executa dins del Monitoratge de Transaccions a l'API unificada /v3/. Quan envies una transacció de criptomonedes, el motor pot detectar la contrapart automàticament; també pots detectar explícitament configurant currency_kind: "crypto" amb una direcció.

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" }
  }'

La resposta conté el veredicte de la detecció — una puntuació numèrica, la banda i el desglossament de l'exposició:

{
  "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 }
    ]
  }
}

Puntuació de risc i bandes. Cada detecció retorna una puntuació de 0 a 100 mapejada a quatre bandes:

Banda	Puntuació	Política típica
BAIX	0–24	Passar
MITJÀ	25–49	Passar amb registre / revisió suau
ALT	50–79	Retenir per a revisió de l'analista
CRÍTIC	80–100	Rebutjar / congelar

Categories d'origen de fons. L'exposició s'atribueix a categories específiques — SANCIONAT, FINANÇAMENT_TERRORISTA, EXPLOTACIÓ_INFANTIL, RANSOMWARE, FONS_ROBATS, MERCAT_DARKNET, MESCLADOR, ESTAFA, INTERCANVI_ALT_RISC, JURISDICCIÓ_ALT_RISC, JOCS_D'ATZAR_SENSE_LLICÈNCIA, INTERCANVI_P2P, INTERCANVI i SERVEI_SENSE_NOM — de manera que veus el motiu d'una puntuació, no només el número.

Tipus d'exposició i gràfic de xarxa. Cada categoria s'informa com a directa (la cartera va realitzar transaccions amb l'entitat de risc) o indirecta (el valor hi va arribar a través de salts intermediaris), amb el recompte de salts. Un gràfic de xarxa traça el camí perquè un analista pugui veure com es connecten els fons.

Preu. 0,02 $ per detecció amb BYOK (Crystal o Merkle Science). El preu gestionat — on Didit proporciona les dades — és de 0,18 $ per detecció amb Crystal i 0,15 $ amb Merkle Science.

Detecció prèvia i posterior a la transferència

La detecció de carteres funciona en dos punts del flux. La detecció prèvia a la transferència pren una adreça de cartera i avalua el seu risc abans d'acceptar un dipòsit o alliberar una retirada — la decisió es pren abans que es mogui el valor. La detecció posterior a la transferència pren un hash de transacció (passat com a payment_reference_id) i avalua una transacció liquidada a posteriori, per a manteniment de registres i revisió contínua. La majoria dels equips executen ambdues: prèvia a la transferència per limitar el flux, posterior a la transferència per mantenir un registre auditable.

Casos d'ús

• Intercanvis de criptomonedes — detecta cada adreça de dipòsit a l'entrada i cada destinació de retirada a la sortida; rebutja automàticament els CRÍTICS, dirigeix els ALTS a un analista.
• Passarel·les d'entrada/sortida — limita les conversions de fiat a cripto i de cripto a fiat segons l'exposició de la cartera de la contrapart abans de liquidar.
• Custodis — detecta carteres a l'entrada i torna a detectar-les en moviment, amb el gràfic de xarxa com a evidència per a qualsevol actiu congelat.
• Carteres — protegeix els usuaris advertint o bloquejant les transferències a adreces amb alta exposició a sancions o estafes.
• VASPs — combina la detecció de carteres amb l'intercanvi de dades de la Regla de Viatge de FATF perquè el risc de la contrapart i l'origen s'avaluïn junts.

Com integrar-se amb Didit

1. Estableix el teu proveïdor i valor predeterminat. A la Consola Empresarial a Transaccions → Configuració, tria Crystal o Merkle Science, afegeix la teva clau BYOK i configura si les transaccions de cripto es detecten per defecte.
2. Envia transaccions de cripto. POST /v3/transactions/ amb currency_kind: "crypto" i una direcció. Utilitza include_crypto_screening per anul·lar el valor predeterminat per trucada.
3. Llegeix el veredicte. Actua segons risk_band i el desglossament de l'exposició — passa BAIX/MITJÀ, reté ALT, rebutja CRÍTIC.
4. Gestiona les alertes a la Consola. Una detecció d'alt risc obre una alerta amb el gràfic de xarxa adjunt, a punt per a la investigació i la presentació de SAR.

Com que tot està a l'API unificada /v3/, la detecció de carteres, el monitoratge de transaccions, KYC i AML es combinen en una única plataforma d'identitat i frau — una cartera marcada pot pausar una transacció i activar un pas de reparació automàticament.

Preguntes freqüents

Quant costa la detecció de carteres?

0,02 $ per detecció amb la teva pròpia clau (Crystal o Merkle Science) — aproximadament 10 vegades més barat que comprar una subscripció directa d'anàlisi de blockchain. El preu gestionat és de 0,18 $ (Crystal) o 0,15 $ (Merkle Science) per detecció.

Quins proveïdors d'anàlisi de blockchain són compatibles?

Crystal i Merkle Science avui, mitjançant BYOK o gestionat. Chainalysis i Elliptic estaran disponibles aviat, també per 0,02 $ BYOK.

Quina diferència hi ha entre la puntuació de risc i la banda de risc?

La puntuació és un número de 0 a 100; la banda (BAIX/MITJÀ/ALT/CRÍTIC) és la categoria en què cau, de manera que pots escriure una política contra una etiqueta en lloc d'ajustar tu mateix els llindars numèrics.

Puc detectar una cartera sense enviar diners?

Sí. La detecció prèvia a la transferència pren una adreça de cartera i retorna el risc abans que es mogui qualsevol valor, de manera que pots decidir si acceptar un dipòsit o alliberar una retirada.

Cobreix l'exposició indirecta, no només la contrapart directa?

Sí. L'exposició s'informa com a directa o indirecta amb el recompte de salts, i un gràfic de xarxa traça com els fons van arribar a una entitat de risc a través d'intermediaris.

Llest per començar?

Llegeix la descripció general de la detecció de carteres a la documentació, mira com s'adapta a la plataforma a la pàgina del producte de detecció de carteres, i consulta els preus transparents per trucada a la pàgina de preus. Quan estiguis a punt, comença de franc — 500 comprovacions KYC gratuïtes cada mes i detecció de carteres per 0,02 $ per detecció amb BYOK.