API AML para direcciones y transacciones cripto
La API de AMLKYC integra la verificación de monederos y transacciones en exchanges, procesadores de pagos y sistemas de cumplimiento. La respuesta incluye risk score, categorías del origen de fondos y exposición a sanciones, fraude, mixers y otros servicios de alto riesgo.
Procesos automatizados
- verificación antes de depósitos o retiros;
- análisis por hash de transacción;
- monitoreo KYT de transferencias;
- informes para cumplimiento;
- umbrales de riesgo personalizados.
Integración
Pruebe el tratamiento de errores, los límites y las reglas de revisión manual antes de producción. La documentación técnica contiene autenticación, métodos y ejemplos de respuesta.
Secuencia de llamadas
La verificación de una dirección se compone de tres llamadas, no de una. La dirección entra en la cola, la comprobación se inicia y el resultado se recoge con el mismo identificador. La separación existe porque el análisis no es instantáneo: la llamada de inicio responde de inmediato, mientras que el informe terminado se recoge aparte.
| Paso | Llamada | Qué ocurre |
|---|---|---|
| Registrar la dirección | PUT /api/fast-check | La dirección se acepta; la respuesta devuelve su identificador |
| Iniciar la comprobación | GET /api/fast-check/{id}/run | El análisis arranca y la llamada responde al instante |
| Recoger el resultado | GET /api/fast-check/{id} | Puntuación de riesgo y su desglose |
| Consultar el historial | GET /api/fast-check | Listado de comprobaciones anteriores |
Además de la verificación rápida existen la consulta de una dirección — GET /api/crypto/address — y la búsqueda — GET /api/crypto/search. El rastreo de una cadena de transferencias se crea como objeto propio: PUT /api/investigations.
Qué devuelve la respuesta
El resultado contiene una puntuación numérica y su justificación. La puntuación es risk.score, en una escala de 0 a 100. La justificación es risk_detail: la lista de categorías de exposición, cada una con una etiqueta como phishing y la proporción que representa en el historial de la dirección.
La puntuación describe una dirección, no a una persona. Un valor alto significa que la dirección ha recibido fondos de categorías de riesgo: es motivo para revisar con más detalle, no una decisión de rechazo ya tomada.
Redes admitidas
La propia API devuelve el listado de activos, así que conviene tomarla como fuente antes que a esta página: la cobertura crece con el tiempo. Según la documentación actual hay 42 combinaciones de activo y red repartidas en siete redes.
| Red | Activos |
|---|---|
| Bitcoin | BTC |
| Ethereum | ETH, USDT, USDC, WETH, WBTC, DAI, BUSD, UNI, ENS, GRT, UST, BNB |
| TRON | USDT, USDC |
| BNB Smart Chain | BNB, WBNB, USDT, USDC, BUSD, ETH, BTCB, DOGE, SHIB, BCH |
| Polygon | MATIC, WMATIC, USDT, USDC, WETH, WBTC, DAI, AAVE, LINK, UNI, SUSHI, UST |
| Avalanche | AVAX, USDT, USDC |
| TON | Toncoin |
Qué decidir antes de integrar
- La clave de acceso. Se emite en el panel y no requiere una solicitud aparte.
- Qué significa la puntuación en su proceso: a partir de qué valor la operación pasa a revisión manual y a partir de cuál se rechaza. El umbral lo fija el negocio; la API no lo impone.
- Dónde se guardan las respuestas. La puntuación describe una dirección en un momento dado y cambia con su uso, así que conviene guardar la fecha junto al veredicto.
- Qué hacer si el servicio no responde. La verificación es una llamada externa, y el escenario «sin respuesta» pertenece al diseño, no al primer incidente.
Preguntas frecuentes
La API AML trabaja con direcciones y transacciones cripto y responde de dónde proceden los fondos. La API KYC trabaja con la persona y sus documentos y responde quién es el cliente. El cumplimiento necesita ambas y ninguna sustituye a la otra.
Iniciar la comprobación y recoger el resultado son llamadas distintas precisamente porque el análisis no es instantáneo. La llamada de inicio responde de inmediato; el informe terminado se recoge después con el identificador de la comprobación.
Es un valor de 0 a 100 en risk.score acompañado de un desglose por categorías con etiquetas como phishing. Describe el historial de una dirección, no a su titular, de modo que conviene tratarlo como motivo de revisión y no como rechazo automático.
Bitcoin, Ethereum, TRON, BNB Smart Chain, Polygon, Avalanche y TON: 42 combinaciones de activo y red según la documentación actual. El listado vigente lo devuelve la propia API y es la fuente que conviene consultar.
Las claves se emiten en el panel. Las condiciones de uso de la API están publicadas como documento independiente en el sitio, y es el punto de partida adecuado si la API va dentro de un producto con usuarios externos.
Verifique sus primeras 5 direcciones gratis
Regístrese y obtenga 5 verificaciones AML gratuitas. Un informe completo con puntuación de riesgo y origen de los fondos — en segundos.
La app AMLKYC — verificaciones a mano
Verifica direcciones y transacciones desde tu teléfono: bot de Telegram, RuStore y App Store.
¿Tienes preguntas? Escríbenos
Rellena el formulario y te responderemos.