Présentation de l'API développeur

Ce qu'est l'API développeur

L'API développeur Cognivo vous permet d'appeler depuis votre propre code la même intelligence on-chain qui alimente Cognivo Chat, la dApp et le bot Telegram. Vous créez un projet, créez une clé d'API, et envoyez des requêtes en HTTPS simple.

1. L'espace Développeurs est l'endroit où vous créez des projets et gérez vos clés d'API Cognivo.
2. Sélectionnez Se connecter pour ouvrir le portail développeur. Vos clés restent privées à votre compte.

La page Développeurs dans la dApp Cognivo.Agrandir l'image

Quand l'utiliser

Utilisez la quand vous voulez des réponses Cognivo à l'intérieur de ce que vous construisez plutôt que dans Cognivo. Cas courants :

• Un bot communautaire où quelqu'un colle une adresse de contrat et récupère des signaux de risque, le contexte de liquidité et de verrouillage, et une lecture des raisons de la baisse d'un token.
• Un tableau de bord de surveillance pour une trésorerie, une équipe ou un portefeuille de baleine : exposition aux approbations, mouvements récents, profits et pertes réalisés par token.
• Un carnet de recherche qui importe des données de tokens et de portefeuilles dans Python ou JavaScript pour une étude ou une analyse post mortem.

Ce n'est pas un accès brut à un nœud ou au RPC. Vous appelez toujours des endpoints Cognivo curatés. Il n'y a ni trading, ni exécution d'ordres, ni outillage MEV. Les résultats sont des signaux d'intelligence, pas des conseils financiers, et un résultat propre ne signifie jamais qu'un token est sûr.

Où la trouver

Dans la dApp, ouvrez la barre latérale, puis Account, puis Developers. Le lien direct est dapp.cognivolabs.io/en/developers. Vous devez être connecté avec votre compte Cognivo habituel. Déconnecté, la page n'affiche qu'un écran d'orientation, sans projets ni clés.

Le haut de la page Developers dans la dApp, où vous trouvez l'URL de base et la façon d'envoyer votre clé d'API.Agrandir l'image

La carte en haut de la page contient les trois éléments nécessaires pour faire un premier appel :

• Base URL : https://api.cognivolabs.io. Ajoutez y un chemin d'endpoint pour effectuer une requête.
• Auth : envoyez votre clé d'API dans l'en tête X-API-Key à chaque requête. Gardez la clé sur votre serveur, jamais dans du code exécuté par le navigateur.
• Chains : la page indique Ethereum, Base, and BSC live, et More chains coming soon. Certains endpoints prennent en charge moins de chaînes que d'autres, et la référence des endpoints précise lesquelles.

La même carte renvoie vers cette documentation et vers la spécification OpenAPI lisible par machine, que vous pouvez importer dans Postman, Insomnia ou un générateur de SDK.

La page elle même comporte quatre onglets : Quickstart, Keys, Endpoints et Usage. Endpoints est une référence avec des exemples copiables et le prix de chaque appel. Il n'y a pas d'exécuteur en direct sur la page, donc rien de ce que vous y lisez ne dépense quoi que ce soit.

Accès, clés et coût

Les clés live sont en libre service. Créez en une et elle fonctionne immédiatement, sans dossier de candidature ni file d'approbation. Le portail énonce clairement le modèle : certains endpoints sont gratuits avec n'importe quelle clé active, et d'autres nécessitent un accès payant ou Enterprise et sont facturés à chaque appel réussi sur votre solde de crédits Cognivo.

• Les clés live (cogv_live_) effectuent de vrais appels. Chaque appel réussi est facturé en crédits Cognivo au prix publié pour cet endpoint. Les appels en échec ne sont jamais facturés. La facturation des appels à la Developer API est désactivée aujourd'hui : un appel réussi ne déduit rien et votre solde ne bouge pas.
• Les clés de test (cogv_test_) portent le libellé Test dans le portail. Elles ont des limites strictes et servent à essayer l'API, pas à supporter du trafic réel.
• Chaque clé affiche son mode d'accès dans l'onglet Keys, par exemple Paid, Trial, Partner, Sandbox, Enterprise ou Request access. Une clé en Request access doit être approuvée avant de pouvoir exécuter les endpoints payants, et une clé Suspended ne peut rien appeler. Le portail en indique la raison.
• Enterprise est le seul parcours où vous demandez un accès, pour une tarification et des limites sur mesure. Le bouton d'accès Enterprise ouvre le parcours de support.

Les crédits proviennent du même solde que vous utilisez partout ailleurs dans Cognivo, et chaque compte reçoit 5 crédits gratuits par jour, réinitialisés à minuit UTC. Si votre solde ne peut pas couvrir un appel, vous recevez une erreur 402 avec le code payment_required, et rien n'est facturé. Rechargez et réessayez. Voir Facturation et crédits pour le fonctionnement du solde.

GET /v1/api/health est gratuit et ne nécessite aucune clé. GET /v1/api/me est gratuit avec toute clé valide. GET /v1/api/discover est gratuit avec un plafond journalier serré. Les prix par endpoint figurent dans la référence des endpoints et dans Limites de débit, erreurs et facturation.

Ce qui revient, et ce que signifie une réponse vide

Les réponses ne contiennent que de l'intelligence on-chain publique. Elles n'incluent jamais d'identifiants de compte Cognivo, d'adresses e mail, de soldes ou d'autres données privées de compte, ni les vôtres ni celles de quelqu'un d'autre. La seule exception est GET /v1/api/me, qui indique le solde de crédits propre à la clé appelante afin que vous puissiez suivre vos dépenses.

Un champ vide ou une valeur inconnue signifie que Cognivo n'a pas pu vérifier cet élément pour ce token ou ce portefeuille sur cette chaîne. Cela ne veut pas dire que l'élément est absent, et cela ne veut pas dire que le sujet est sain. Traitez un résultat manquant comme non vérifié, et utilisez l'identifiant de requête présent dans la réponse si vous avez besoin d'un suivi.

Étapes suivantes

1. Connectez vous et créez un projet, puis créez une clé live. La clé complète n'est affichée qu'une fois, copiez la donc immédiatement.
2. Effectuez votre premier appel avec le Démarrage rapide.
3. Lisez Authentification et clés d'API pour les permissions, la rotation et la sécurité des clés.