Ana içeriğe geç

Hızlı Başlangıç

Sıfırdan ilk gerçek istihbarat sonucunuza yaklaşık bir dakikada: bir anahtar oluşturun, tek bir komut yapıştırın, cevabı okuyun.

1. Bir API anahtarı oluşturun​

  1. Geliştirici portalını açın ve Cognivo hesabınızla oturum açın.
  2. Bir proje oluşturun (örneğin "Trading botum").
  3. Bir API anahtarı oluşturun. İhtiyaç duyduğu izinleri (kapsamları) seçin - bu hızlı başlangıç için Token ve cüzdan istihbaratı (intel:read) ile Likidite okumaları (liquidity:read) verin.
  4. Anahtarı hemen kopyalayın. Tam olarak bir kez gösterilir; sonrasında yalnızca maskelenmiş bir sürüm (cogv_live_****abcd) görünür. Kaybederseniz anahtarı döndürün (rotate).

Anahtarlar iki ortamda gelir:

  • cogv_test_... - canlı zincir verisine karşı entegrasyon testleri için sandbox anahtarları. Sıkı sınırlıdır (saatte 25, günde 100 istek); yalnızca bir yönetici etkinleştirdiğinde küçük bir canlı demo hakkı çalıştırabilir.
  • cogv_live_... - üretim anahtarları. Canlı istihbarat endpoint'leri deneme (trial), iş ortağı, ücretli veya kurumsal erişim gerektirir; bkz. erişim modları.

2. Anahtarınızı kontrol edin​

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

Karşılığında maskelenmiş anahtarınızı, projenizi, ortamınızı, kapsamlarınızı ve saatlik hız limitinizi alırsınız.

3. Canlı bir endpoint deneyin (curl)​

İstihbarat endpoint'leri JSON gövdeli POST kullanır. Bu komut, gerçek bir Base token'ı üzerinde (RWA Inc, demolarda kullandığımız herkese açık bir kontrat) gerçek bir likidite kontrolü yapar. Erişimi olan anahtarlar için yürütülür: bir yöneticinin canlı demo hakkını etkinleştirdiği bir sandbox anahtarı ya da deneme (trial), iş ortağı, ücretli veya kurumsal erişime sahip bir anahtar:

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"}'

Erişiminiz varsa, data içinde token kimliği (ad/sembol), bir piyasa anlık görüntüsü ve LP/kilit bağlamıyla birlikte "ok": true görmelisiniz. meta.credits_charged çağrının maliyetini gösterir: sandbox demo veya deneme haklarında 0, ücretli kullanımda ise endpoint'in kredi fiyatı (likidite için 2 kredi) - başarısız çağrılar asla ücretlendirilmez. Erişiminiz yoksa çağrı ücretsiz çalışmaz: access_required gibi net bir 403 hatası döndürür ve portaldan deneme veya kurumsal erişim talep edebilirsiniz. Hazır olduğunuzda address alanını eth, base veya bsc üzerindeki herhangi bir token kontratıyla değiştirin.

Anahtarınızı gizli tutun

Gerçek bir API anahtarını asla herkese açık bir repoya, sohbete veya istemci tarafı koda yapıştırmayın. Anahtar yalnızca oluşturulurken bir kez gösterilir; sızarsa portalda döndürün.

4. Aynı çağrının JavaScript / TypeScript hali​

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. Yanıt yapısı​

Her endpoint aynı zarfla yanıt verir:

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

Hata durumunda:

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

Anahtarınızı güvende tutun​

  • API'yi bir sunucudan çağırın; asla tarayıcı veya mobil istemci kodundan çağırmayın.
  • Anahtarı bir ortam değişkeninde veya secret yöneticisinde saklayın.
  • Bir anahtar sızmış olabilirse portalda iptal edin veya döndürün - eski anahtar bir dakika içinde çalışmayı bırakır.