Referencia de la API

Accede programáticamente a las señales de anomalía y datos de mercado de SHARKNET.

Autenticación

Todas las solicitudes a endpoints protegidos requieren un header X-API-Key con tu clave de API válida.

Ejemplo de solicitud:

curl -H "X-API-Key: TU_API_KEY" \
  https://api.sharknet.pages.dev/signals?limit=10

GET /signals

Devuelve las últimas señales de anomalía detectadas por el Sonar.

Parámetros de query:

  • limit (opcional): Cantidad de señales a devolver (máx. 100). Default: 10.

Respuesta ejemplo:

[
  {
    "asset": "PEPE",
    "signal_type": "bearish_divergence",
    "confidence": "high",
    "sentiment": {
      "bullish_pct": 0,
      "bearish_pct": 100,
      "total_mentions": 0
    },
    "market": {
      "price_usd": 0.00000513,
      "change_24h_pct": 1.38,
      "source": "binance"
    },
    "reason": "Sentimiento bajista 100.0% con precio lateral/alcista",
    "generated_at": "2026-11-10 19:24:50 UTC"
  }
]

GET /anomalies

Alias de /signals. Mismos parámetros y respuesta.

GET /history

Devuelve el historial completo de señales con parámetro de paginación.

Parámetros de query:

  • limit (opcional): Cantidad de señales (máx. 500). Default: 50.

Webhooks

Registra URLs para recibir notificaciones automáticas cuando se emita una nueva señal.

POST /webhooks

curl -X POST https://api.sharknet.pages.dev/webhooks \
  -H "X-API-Key: TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://tu-servidor.com/webhook","events":["signal"],"secret":"opcional"}'

Códigos de respuesta

Código Significado
200 Éxito
401 API Key inválida o faltante
422 Error de validación en los parámetros
429 Límite de llamadas excedido

¿Necesitas una API Key?

Contacta a ventas para crear tu clave de acceso y activar tu plan (Starter $199/mes, Pro $499/mes o Enterprise $1,500/mes).

Solicitar acceso a la API