Saltar al contenido principal
Cuando evalúas ChainPatrol por primera vez a través de la API, las preguntas suelen ser conteos: cuántas amenazas confirmadas, cuántas Suspected Threats (amenazas sospechosas detectadas automáticamente, todavía sin confirmar), cuántas en seguimiento, cuántas por encima de un umbral de confianza. Cada una de las que siguen es una sola solicitud con includeTotal: true, así que obtienes el número sin tener que paginar todos los resultados.
No agregues un rango de fechas a menos que realmente lo necesites. Todo filtro de fecha deja fuera el historial más antiguo, y cada endpoint filtra según una marca de tiempo distinta:
En todos los casos, excluye las suspected threats eliminadas con { "property": "deleted", "operator": "notIn", "value": ["deleted"] }, porque /detection/list las incluye de forma predeterminada.

¿Cuántas amenazas confirmadas tenemos?

Una amenaza confirmada es un Asset (activo digital: URL, dirección, perfil, app, etc.) que ChainPatrol revisó y bloqueó. Si la protección no está activa para tu organización, las amenazas confirmadas quedan como Pending Blocked (bloqueo pendiente) en lugar de aplicarse, pero igual están confirmadas. Incluye ambas.
metrics.newThreats es el conteo de todo el historial, con domainThreats, twitterThreats, telegramThreats y otherThreats como desglose. Para listar las confirmadas entre tus suspected threats:
Los dos números pueden diferir: newThreats también cuenta las amenazas que tú mismo reportaste y que ningún detector produjo. Para listar todas las amenazas confirmadas sin importar la fuente, usa /threats/list con includePending: true y un startDate antiguo.

¿Cuántas suspected threats en dominios tenemos?

total cuenta suspected threats. Varias suspected threats pueden apuntar al mismo dominio, así que elimina los duplicados por asset.id si necesitas dominios únicos.

¿Cuántos dominios hay en la Watchlist?

Omite assetType para obtener toda la Watchlist (lista de seguimiento de assets sospechosos que se siguen monitoreando). Ese total coincide con threatsWatchlisted en /metrics/summary. El campo reason de cada elemento indica por qué está en seguimiento (DEAD, PARKING, NOT_ENOUGH_EVIDENCE, …).

¿Cuántas suspected threats superan el 80% (o el 90%) de confianza?

Usa el umbral sobre el score sin procesar, no el filtro confidence. Los niveles de confianza se agrupan a partir del puntaje según los umbrales propios de tu organización, así que "high" no es un porcentaje fijo.
minScore es inclusivo. Cámbialo a 0.9 para la pregunta del 90%, y pagina con nextCursor para listar todas las coincidencias.

Desde la CLI o un agente de IA

Las mismas preguntas con la CLI de ChainPatrol:
La CLI no tiene una opción para excluir las suspected threats eliminadas, así que los totales de su detections list las incluyen. Usa las solicitudes a la API de arriba cuando el número exacto sea importante. El servidor MCP de ChainPatrol incluye un prompt detection_evaluation que ejecuta todas estas consultas para una organización y reporta los conteos.