Saltar al contenido principal

Cognivo Developer API

La Cognivo Developer API te permite llamar a la misma inteligencia on-chain que impulsa Cognivo Chat, la dApp y el bot de Telegram desde tu propia app, bot, panel o backend.

  • URL base: https://api.cognivolabs.io
  • Autenticación: claves de API con permisos que tú mismo creas en el portal de desarrolladores
  • Cadenas activas hoy: Ethereum (eth), Base (base), BNB Smart Chain (bsc)
  • Solana: próximamente (aún no disponible)
  • Webhooks: planificados (aún no disponibles)
  • Especificación OpenAPI: cognivo-public-api.yaml - la especificación completa legible por máquinas; impórtala en Postman, Insomnia o un generador de SDK

¿Qué puedo construir?​

Cualquier cosa que necesite una lectura rápida y honesta de un token o billetera. Algunas ideas concretas:

  • Bots de verificación de seguridad de tokens - un bot donde los usuarios pegan una dirección de contrato y reciben señales de riesgo, contexto de liquidez y locks, y "por qué está cayendo" en un solo mensaje
  • Paneles de monitoreo de billeteras - vigila una tesorería, una ballena o una billetera del equipo: exposición por aprobaciones, movimientos recientes exactos, PnL realizado por token
  • Herramientas comunitarias de Telegram o Discord - dale a tu comunidad un comando /check <token> respaldado por la misma inteligencia que impulsa Cognivo Chat
  • Vistas de PnL de portafolio - muestra a los usuarios su ganancia y pérdida realizada por token, calculada a partir de actividad on-chain verificada en lugar de cifras autoinformadas
  • Notebooks de investigación - lleva datos de riesgo, liquidez, billeteras del equipo y movimientos a notebooks de Python o JavaScript para estudios de tokens y post-mortems
  • Feeds de descubrimiento - muestra en tu propia app o sitio las tarjetas de inteligencia pública de alta calidad más recientes del feed Discover

Lo que esta API no es​

  • No es acceso crudo a nodos/RPC. Siempre llamas a endpoints de inteligencia curados de Cognivo; el RPC crudo de la cadena nunca se expone ni se revende.
  • No incluye trading, ejecución de órdenes ni herramientas de MEV.
  • Los resultados son señales de inteligencia, no asesoramiento financiero ni una garantía. Un resultado limpio nunca significa "seguro".

Modelo de acceso y precios​

Las claves live son de autoservicio y de pago por uso. Crea una clave y funciona de inmediato: sin solicitud, sin cola de aprobación, sin llamada comercial. Cada llamada exitosa se cobra en créditos de Cognivo desde el saldo de créditos de tu cuenta, a los precios por endpoint publicados; las llamadas fallidas nunca se cobran.

  • Las claves live (cogv_live_) son la forma estándar de usar la API. Se facturan por uso desde el mismo saldo de créditos de Cognivo que usas en el resto de la plataforma. Si tu saldo no puede cubrir una llamada, obtienes un error 402 con código payment_required y no se cobra nada: recarga en la página de facturación de tu cuenta de Cognivo e inténtalo de nuevo.
  • Las claves sandbox (cogv_test_) están claramente etiquetadas como Sandbox y existen solo para demos limitadas y pruebas de integración. No pueden ejecutar inteligencia en vivo.
  • Trial es una asignación de evaluación opcional otorgada por un administrador. Nunca la necesitas para el uso de pago ordinario.
  • Partner es un acuerdo gestionado por un administrador.
  • Enterprise es la única vía en la que solicitas acceso: precios a medida, límites a medida y volumen. Solicítalo desde el portal de desarrolladores.
  • Una clave suspendida no puede ejecutar nada; el portal muestra el motivo.

Los precios en créditos por endpoint están publicados en las páginas de Referencia de endpoints y Límites de tasa, errores y facturación. GET /v1/api/health es gratis y no necesita clave, GET /v1/api/me es gratis con cualquier clave válida, y GET /v1/api/discover es gratis con un tope de tasa estricto.

Privacidad y seguridad de los datos​

La API devuelve únicamente inteligencia on-chain pública. Las respuestas nunca incluyen identificadores de cuentas de Cognivo, correos electrónicos, saldos ni otros datos privados de cuenta - ni tuyos ni de nadie más. La única excepción es GET /v1/api/me, que muestra a la clave que llama el saldo de créditos de su propia cuenta para que puedas monitorear el gasto.

Primeros pasos​

  1. Inicia sesión en dapp.cognivolabs.io/en/developers con tu cuenta normal de Cognivo.
  2. Crea un proyecto y una clave de API live (la clave completa se muestra exactamente una vez - cópiala de inmediato). Funciona desde el primer momento.
  3. Sigue el Inicio rápido - tu primera llamada en 30 segundos.