API de Detección de Carteras: Riesgo en Cadena por $0.02 (BYOK) (ES)

Una verificación KYC le indica que el propietario de una billetera es una persona real. No le dice nada sobre dónde han estado las monedas en esa billetera. En la cadena, una billetera que parece ordinaria puede estar a un salto de una dirección sancionada, a dos saltos de un mercado darknet, o recién salida de un mezclador. La detección de billeteras — Know Your Transaction (KYT) — es la capa que lee ese historial antes de que usted permita que el valor se mueva.

La API de Detección de Carteras de Didit puntúa cualquier dirección de billetera cripto o hash de transacción contra inteligencia de riesgo en cadena. Usted envía una dirección, y devuelve una puntuación de riesgo de 0 a 100, una banda BAJA/MEDIA/ALTA/CRÍTICA, y un desglose de las categorías de riesgo a las que están expuestos los fondos — sanciones, mezcladores, mercados darknet, ransomware, fondos robados y más. Cuesta $0.02 por detección con su propia clave (BYOK), aproximadamente 10 veces más barato que comprar una suscripción directa de análisis de blockchain.

Esta guía cubre lo que la API detecta, cómo funciona la puntuación y cómo conectarla a un flujo de depósito o retiro.

Puntos clave

• Una llamada, riesgo en cadena. Envíe una dirección de billetera (pre-transferencia) o un hash de transacción (post-transferencia) y obtenga un veredicto de riesgo.
• Puntuación de riesgo de 0 a 100 mapeada a cuatro bandas — BAJA / MEDIA / ALTA / CRÍTICA — para que la política sea un umbral único, no un proyecto de investigación.
• Más de 14 categorías de origen de fondos — SANCIONADO, FINANCIAMIENTO_TERRORISTA, RANSOMWARE, MERCADO_DARKNET, MEZCLADOR, FONDOS_ROBADOS, ESTAFA, y más — cada una mostrada por tipo de exposición.
• Tabla de exposición + grafo de red — exposición directa e indirecta (varios saltos) para que vea no solo la contraparte sino de dónde provienen sus fondos.
• BYOK a $0.02 por detección. Traiga su propia clave de Crystal o Merkle Science; Chainalysis y Elliptic estarán disponibles pronto. También hay precios gestionados disponibles.
• Integrado en la Monitorización de Transacciones — las transacciones cripto pueden activar la detección de billeteras automáticamente, sin necesidad de configuración adicional.

Qué hace la detección de billeteras

Las blockchains son libros de contabilidad públicos, pero los datos brutos de las transacciones no son datos de riesgo. Convertir una dirección en un veredicto de riesgo requiere una capa de agrupación y etiquetado que mapea las direcciones a entidades del mundo real — intercambios, mezcladores, billeteras sancionadas, operadores de ransomware, mercados darknet — y luego rastrea cómo fluye el valor entre ellas.

La API de Detección de Carteras de Didit se basa en esa inteligencia. Se le da una dirección de billetera y analiza la exposición de la dirección: cuánto de su valor de entrada y salida se conecta a entidades riesgosas, directa o indirectamente a través de saltos intermedios. Devuelve una única puntuación de riesgo, la banda en la que cae esa puntuación y las categorías que impulsan el riesgo, de modo que una política de cumplimiento puede expresarse como "bloquear CRÍTICO, revisar ALTO, pasar el resto".

Por qué es importante

Para cualquier negocio que toca las criptomonedas — un intercambio, una rampa de entrada/salida, un custodio, una billetera, un VASP — aceptar fondos es aceptar su historial. La exposición a sanciones es el filo más agudo: mover valor hacia o desde una billetera en una lista de sanciones es una violación, independientemente de la intención. Pero el riesgo práctico es más amplio. Fondos lavados a través de un mezclador, ganancias de un pago de ransomware o monedas drenadas en una explotación, todo esto aparece como exposición en cadena mucho antes de que aparezca en cualquier otro lugar.

El problema clásico es el costo. Las plataformas de análisis de blockchain se venden como suscripciones empresariales con mínimos anuales de cinco y seis cifras, una barrera real para un equipo que solo necesita detectar billeteras en el punto de depósito. Didit elimina esa barrera con BYOK: usted trae su propia clave de proveedor, paga $0.02 por detección a través de la API unificada de Didit y se salta por completo las licencias por puesto.

Detalles técnicos

La detección de billeteras se ejecuta dentro de la Monitorización de Transacciones en la API unificada /v3/. Cuando envía una transacción cripto, el motor puede detectar a la contraparte automáticamente; también puede detectar explícitamente configurando currency_kind: "crypto" con una dirección.

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 respuesta lleva el veredicto de detección — una puntuación numérica, la banda y el desglose de la exposición:

{
  "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ón y bandas de riesgo. Cada detección devuelve una puntuación de 0 a 100 mapeada a cuatro bandas:

Banda	Puntuación	Política típica
BAJA	0–24	Aprobar
MEDIA	25–49	Aprobar con registro / revisión suave
ALTA	50–79	Retener para revisión del analista
CRÍTICA	80–100	Rechazar / congelar

Categorías de origen de fondos. La exposición se atribuye a categorías específicas — SANCIONADO, FINANCIAMIENTO_TERRORISTA, EXPLOTACIÓN_INFANTIL, RANSOMWARE, FONDOS_ROBADOS, MERCADO_DARKNET, MEZCLADOR, ESTAFA, INTERCAMBIO_ALTO_RIESGO, JURISDICCIÓN_ALTO_RIESGO, JUEGOS_SIN_LICENCIA, INTERCAMBIO_P2P, INTERCAMBIO y SERVICIO_SIN_NOMBRE — para que vea la razón de una puntuación, no solo el número.

Tipo de exposición y grafo de red. Cada categoría se reporta como directa (la billetera interactuó con la entidad riesgosa) o indirecta (el valor llegó a través de saltos intermedios), con el conteo de saltos. Un grafo de red traza la ruta para que un analista pueda ver cómo los fondos se conectan.

Precio. $0.02 por detección con BYOK (Crystal o Merkle Science). El precio gestionado — donde Didit proporciona los datos — es de $0.18 por detección con Crystal y $0.15 con Merkle Science.

Detección pre-transferencia y post-transferencia

La detección de billeteras funciona en dos puntos del flujo. La detección pre-transferencia toma una dirección de billetera y evalúa su riesgo antes de que usted acepte un depósito o libere un retiro — la decisión ocurre antes de que el valor se mueva. La detección post-transferencia toma un hash de transacción (pasado como payment_reference_id) y evalúa una transacción ya liquidada después del hecho, para el mantenimiento de registros y la revisión continua. La mayoría de los equipos ejecutan ambos: pre-transferencia para controlar el flujo, post-transferencia para mantener un rastro auditable.

Casos de uso

• Intercambios de criptomonedas — detecte cada dirección de depósito al ingresar y cada destino de retiro al salir; rechace automáticamente CRÍTICO, dirija ALTO a un analista.
• Rampas de entrada/salida — controle las conversiones de fiat a cripto y de cripto a fiat según la exposición de la billetera de la contraparte antes de liquidar.
• Custodios — detecte billeteras al ingresar y vuelva a detectar al mover, con el grafo de red como evidencia para cualquier activo congelado.
• Billeteras — proteja a los usuarios advirtiendo o bloqueando transferencias a direcciones con alta exposición a sanciones o estafas.
• VASPs — combine la detección de billeteras con el intercambio de datos de la Regla de Viaje de FATF para que el riesgo de la contraparte y el origen se evalúen conjuntamente.

Cómo integrar con Didit

1. Configure su proveedor y valor predeterminado. En la Consola de Negocios, en Transacciones → Configuración, elija Crystal o Merkle Science, agregue su clave BYOK y configure si las transacciones cripto se detectan por defecto.
2. Envíe transacciones cripto. POST /v3/transactions/ con currency_kind: "crypto" y una dirección. Use include_crypto_screening para anular el valor predeterminado por llamada.
3. Lea el veredicto. Actúe sobre la risk_band y el desglose de la exposición — pase BAJO/MEDIO, retenga ALTO, rechace CRÍTICO.
4. Trabaje las alertas en la Consola. Una detección de alto riesgo abre una alerta con el grafo de red adjunto, lista para investigación y presentación de SAR.

Dado que todo está en la API unificada /v3/, la detección de billeteras, la monitorización de transacciones, KYC y AML se combinan en una única plataforma de identidad y fraude — una billetera marcada puede pausar una transacción y activar un paso de remediación automáticamente.

Preguntas frecuentes

¿Cuánto cuesta la detección de billeteras?

$0.02 por detección con su propia clave (Crystal o Merkle Science) — aproximadamente 10 veces más barato que comprar una suscripción directa de análisis de blockchain. El precio gestionado es de $0.18 (Crystal) o $0.15 (Merkle Science) por detección.

¿Qué proveedores de análisis de blockchain son compatibles?

Crystal y Merkle Science actualmente, a través de BYOK o gestionado. Chainalysis y Elliptic estarán disponibles pronto, también a $0.02 BYOK.

¿Cuál es la diferencia entre la puntuación de riesgo y la banda de riesgo?

La puntuación es un número de 0 a 100; la banda (BAJA/MEDIA/ALTA/CRÍTICA) es el grupo en el que cae, para que pueda escribir políticas contra una etiqueta en lugar de ajustar usted mismo los umbrales numéricos.

¿Puedo detectar una billetera sin enviar dinero?

Sí. La detección pre-transferencia toma una dirección de billetera y devuelve el riesgo antes de que se mueva cualquier valor, para que pueda decidir si acepta un depósito o libera un retiro.

¿Cubre la exposición indirecta, no solo la contraparte directa?

Sí. La exposición se reporta como directa o indirecta con conteos de saltos, y un grafo de red traza cómo los fondos llegaron a una entidad riesgosa a través de intermediarios.

¿Listo para empezar?

Lea la descripción general de la Detección de Carteras en la documentación, vea cómo encaja en la plataforma en la página del producto Detección de Carteras, y consulte los precios transparentes por llamada en la página de precios. Cuando esté listo, comience gratis — 500 verificaciones KYC gratuitas cada mes y detección de billeteras a $0.02 por detección con BYOK.