Démarrage rapide

De zéro à votre premier vrai résultat d'intelligence en une minute environ : créez une clé, collez une commande, lisez la réponse.

1. Créez une clé d'API

1. Ouvrez le portail développeur et connectez-vous avec votre compte Cognivo.
2. Créez un projet (par exemple "Mon bot de trading").
3. Créez une clé d'API. Choisissez les permissions (scopes) dont elle a besoin - pour ce démarrage rapide, accordez Intelligence de tokens et de wallets (intel:read) et Lectures de liquidité (liquidity:read).
4. Copiez la clé maintenant. Elle n'est affichée qu'une seule fois ; ensuite seule une version masquée (cogv_live_****abcd) est visible. Si vous la perdez, effectuez une rotation de la clé.

Les clés existent dans deux environnements :

• cogv_test_... - des clés sandbox pour les tests d'intégration sur des données de chaîne en direct. Strictement plafonnées (25 requêtes/heure, 100/jour) ; elles ne peuvent exécuter qu'une petite allocation de démo en direct quand un administrateur l'active.
• cogv_live_... - des clés de production. Les endpoints d'intelligence en direct nécessitent un accès trial, partenaire, payant ou enterprise ; voir les modes d'accès.

2. Vérifiez votre clé

curl 'https://api.cognivolabs.io/v1/api/me' \
  -H 'X-API-Key: YOUR_API_KEY'

Vous recevez en retour votre clé masquée, le projet, l'environnement, les scopes et la limite de débit horaire.

3. Essayez un endpoint en direct (curl)

Les endpoints d'intelligence utilisent POST avec un corps JSON. Cette commande exacte exécute une vraie vérification de liquidité sur un vrai token Base (RWA Inc, un contrat public que nous utilisons dans les démos). Elle s'exécute pour les clés disposant d'un accès : une clé sandbox dont un administrateur a activé l'allocation de démo en direct, ou une clé avec un accès trial, partenaire, payant ou enterprise :

curl -X POST 'https://api.cognivolabs.io/v1/api/intel/liquidity' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"chain":"base","address":"0xe2b1dc2d4a3b4e59fdf0c47b71a7a86391a8b35a"}'

Avec un accès, vous devriez voir "ok": true avec l'identité du token (nom/symbole), un instantané de marché et le contexte LP/verrouillage dans data. meta.credits_charged indique ce que l'appel a coûté : 0 sur les allocations de démo sandbox ou de trial, ou le prix en crédits de l'endpoint (2 crédits pour la liquidité) en usage payant - les appels échoués ne sont jamais facturés. Sans accès, l'appel ne s'exécute pas gratuitement : il renvoie une erreur 403 claire comme access_required, et vous pouvez demander un accès trial ou enterprise depuis le portail. Remplacez l'address par n'importe quel contrat de token sur eth, base ou bsc quand vous êtes prêt.

Gardez votre clé secrète

Ne collez jamais une vraie clé d'API dans un dépôt public, un chat ou du code côté client. La clé n'est affichée qu'une seule fois à la création ; si elle fuit, effectuez une rotation dans le portail.

4. Le même appel en JavaScript / TypeScript

const res = await fetch("https://api.cognivolabs.io/v1/api/intel/liquidity", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.COGNIVO_API_KEY, // never hardcode keys
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ chain: "base", address: "0xTOKEN_CONTRACT" }),
});
const json = await res.json();
if (json.ok) {
  console.log(json.data);        // the intelligence result
  console.log(json.meta.request_id); // keep for support/debugging
} else {
  console.error(json.error);
}

5. Forme de la réponse

Chaque endpoint répond avec la même enveloppe :

{
  "ok": true,
  "data": { "...": "the result" },
  "meta": {
    "chain": "base",
    "request_id": "capi_...",
    "credits_charged": 0,
    "generated_at": "2026-07-08T00:00:00.000Z"
  }
}

En cas d'échec :

{ "ok": false, "error": "invalid_chain", "request_id": "capi_..." }

Gardez votre clé en sécurité

• Appelez l'API depuis un serveur, jamais depuis du code de navigateur ou de client mobile.
• Stockez la clé dans une variable d'environnement ou un gestionnaire de secrets.
• Si une clé a pu fuiter, révoquez-la ou effectuez une rotation dans le portail - l'ancienne clé cesse de fonctionner en moins d'une minute.