Saltar al contenido principal

Visión general de la Developer API

Qué es la Developer API​

La Cognivo Developer API te permite llamar desde tu propio código a la misma inteligencia on-chain que impulsa Cognivo Chat, la dApp y el bot de Telegram. Creas un proyecto, creas una clave de API y envías peticiones por HTTPS normal.

  1. El área de Desarrolladores es donde creas proyectos y gestionas tus claves de la API de Cognivo.
  2. Selecciona Iniciar sesión para abrir el portal de desarrolladores. Tus claves permanecen privadas de tu cuenta.
La página de Desarrolladores en la dApp de Cognivo.Ampliar imagen

Cuándo usarla​

Úsala cuando quieras respuestas de Cognivo dentro de algo que estás construyendo en lugar de dentro de Cognivo. Casos habituales:

  • Un bot de comunidad donde alguien pega una dirección de contrato y recibe señales de riesgo, contexto de liquidez y locks, y una lectura de por qué un token está cayendo.
  • Un panel de monitoreo para una tesorería, un equipo o una billetera ballena: exposición por aprobaciones, movimientos recientes, ganancias y pérdidas realizadas por token.
  • Un notebook de investigación que lleva datos de tokens y billeteras a Python o JavaScript para un estudio o un post mortem.

No es acceso crudo a nodos ni a RPC. Siempre llamas a endpoints curados de Cognivo. No hay trading, ejecución de órdenes ni herramientas de MEV. Los resultados son señales de inteligencia, no asesoramiento financiero, y un resultado limpio nunca significa que un token sea seguro.

Dónde encontrarla​

En la dApp, abre la barra lateral, luego Cuenta y luego Developers. El enlace directo es dapp.cognivolabs.io/en/developers. Necesitas haber iniciado sesión con tu cuenta normal de Cognivo. Con la sesión cerrada, la página muestra solo una pantalla de orientación, sin proyectos ni claves.

La parte superior de la página Developers en la dApp, donde encuentras la URL base y cómo enviar tu clave de API.Ampliar imagen

La tarjeta de la parte superior de la página lleva las tres cosas que necesitas para hacer una primera llamada:

  • URL base: https://api.cognivolabs.io. Añádele la ruta de un endpoint para hacer una petición.
  • Autenticación: envía tu clave de API en la cabecera X-API-Key en cada petición. Guarda la clave en tu servidor, nunca en código de navegador.
  • Redes: la página muestra Ethereum, Base y BSC activas, y Más redes próximamente. Algunos endpoints admiten menos redes que otros, y la Referencia de endpoints indica cuáles.

La misma tarjeta enlaza a esta documentación y a la especificación OpenAPI legible por máquinas, que puedes importar en Postman, Insomnia o un generador de SDK.

La página en sí tiene cuatro pestañas: Quickstart, Claves, Endpoints y Usage. Endpoints es una referencia con ejemplos copiables y el precio de cada llamada. La página no tiene ejecutor en vivo, así que nada de lo que leas allí gasta nada.

Acceso, claves y costo​

Las claves live son de autoservicio. Creas una y funciona de inmediato, sin solicitud ni cola de aprobación. El portal expone el modelo con claridad: algunos endpoints son gratuitos con cualquier clave activa, y otros requieren acceso de pago o Enterprise y se cobran por llamada exitosa desde tu saldo de créditos de Cognivo.

  • Las claves live (cogv_live_) hacen llamadas reales. Cada llamada exitosa se cobra en créditos de Cognivo al precio publicado para ese endpoint. Las llamadas fallidas nunca se cobran. El cobro por las llamadas a la Developer API está desactivado hoy, así que una llamada exitosa no descuenta nada y tu saldo no cambia.
  • Las claves de prueba (cogv_test_) aparecen etiquetadas como Test en el portal. Tienen límites estrictos y sirven para probar la API, no para tráfico real.
  • Cada clave muestra su modo de acceso en la pestaña de claves, por ejemplo Paid, Trial, Partner, Sandbox, Enterprise o Request access. Una clave en Request access tiene que aprobarse antes de poder ejecutar los endpoints de pago, y una clave Suspended no puede llamar a nada. El portal muestra el motivo.
  • Enterprise es la única vía en la que solicitas acceso, para precios y límites personalizados. El botón de acceso Enterprise abre el flujo de soporte.

Los créditos salen del mismo saldo que usas en todo lo demás en Cognivo, y cada cuenta recibe 5 créditos gratuitos al día que se reinician a medianoche UTC. Si tu saldo no puede cubrir una llamada, recibes un error 402 con el código payment_required, y no se cobra nada. Recarga y vuelve a intentarlo. Consulta Facturación y créditos para saber cómo funciona el saldo.

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

Qué llega de vuelta y qué significa una respuesta en blanco​

Las respuestas llevan únicamente inteligencia pública on-chain. Nunca incluyen identificadores de cuenta de Cognivo, correos, saldos ni otros datos privados de cuenta, ni tuyos ni de nadie. La única excepción es GET /v1/api/me, que informa del saldo de créditos de la propia clave que llama para que puedas vigilar tu gasto.

Un campo vacío o un valor desconocido significa que Cognivo no pudo verificar ese elemento para este token o billetera en esta red. No significa que el elemento no exista, y no significa que el sujeto esté limpio. Trata un resultado ausente como no verificado, y usa el ID de petición de la respuesta si necesitas darle seguimiento.

Siguientes pasos​

  1. Inicia sesión y crea un proyecto, luego crea una clave live. La clave completa se muestra una sola vez, así que cópiala de inmediato.
  2. Ejecuta tu primera llamada con el Quickstart.
  3. Lee Autenticación y claves de API para permisos, rotación y seguridad de claves.