Ocean ofrece una API REST para acceder de forma programática a datos de escaneo, información de usuario, puntuaciones de riesgo y sistemas de detección. Todos los endpoints usan claves de API y tienen un límite de 1.000 peticiones por hora.
La API de Ocean solo está disponible para usuarios con una licencia activa o membresía de Enterprise. Los usuarios gratis no pueden crear ni usar claves de API.
La única excepción es /v1/version, que es público y no necesita clave de API.
URL base: https://api.anticheat.ac/v1
Autenticación: Pasa tu clave de API en la cabecera x-api-key
Opcional: Envía x-server-name para etiquetar cuál de tus servidores hizo la llamada
/v1/scanned-users/lookup/:discordIdConsulta el historial de escaneos, detecciones, bans o avisos y cuentas relacionadas de un usuario de Discord
Permiso:scanned-users:lookup/v1/users/:discordId/risk-scoreObtén la puntuación y el nivel de riesgo calculados de un usuario de Discord
Permiso:user:risk-score/v1/pins/:pinCode/resultsObtén de forma programática los resultados de tus propios PIN
Permiso:pins:results/v1/pins/:pinCode/statusObtén el progreso en tiempo real, el porcentaje y un resumen del resultado de tus PIN
Permiso:pins:status/v1/pins/createCrea PIN de escaneo por la API. Solo dueños de Enterprise.
Permiso:pins:create (dueño de Enterprise)/v1/db/query/:discordIdBusca en la base de tramposos por ID de Discord: perfil de la comunidad, consulta de red y coincidencias de escaneos de Ocean
Permiso:db:query (acceso a la base)/v1/versionLee la versión activa del cliente de Ocean. Ideal para un comprobador de versión
Permiso: ninguno, este endpoint es públicohttps://api.anticheat.ac/mcpServidor MCP remoto que expone los mismos datos que la API REST a agentes de IA por Streamable HTTP
Autenticación:OAuth 2.1Registro de uso
Cada llamada autenticada queda registrada: qué clave se usó, qué endpoint pegó, la IP y la cabecera opcional x-server-name . Los registros se guardan 90 días y sirven para detectar claves compartidas y abuso. Nunca incluyen la clave completa, solo los primeros 12 caracteres.
Si una clave atiende varios servidores, envía un x-server-name distinto desde cada uno. Es la forma más rápida de mostrar qué servidor hizo una llamada.
Límite de peticiones
Todos los endpoints comparten un límite global de 1.000 peticiones por hora por clave de API. Las cabeceras de límite (X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset) van en cada respuesta.