Mulai Cepat

Dari nol ke hasil intelijen nyata pertama Anda dalam waktu sekitar satu menit: buat key, tempel satu perintah, baca jawabannya.

1. Buat API key

1. Buka portal Developer dan masuk dengan akun Cognivo Anda.
2. Buat sebuah proyek (misalnya "Bot trading saya").
3. Buat sebuah API key. Pilih izin (scope) yang dibutuhkan - untuk mulai cepat ini, berikan Intelijen token dan dompet (intel:read) dan Pembacaan likuiditas (liquidity:read).
4. Salin key sekarang juga. Key hanya ditampilkan tepat satu kali; setelah itu hanya versi tersamar (cogv_live_****abcd) yang terlihat. Kalau hilang, rotasi key tersebut.

Key hadir dalam dua lingkungan:

• cogv_test_... - key sandbox untuk pengujian integrasi terhadap data chain live. Dibatasi ketat (25 permintaan/jam, 100/hari); hanya bisa menjalankan jatah demo live kecil saat diaktifkan oleh admin.
• cogv_live_... - key produksi. Endpoint intelijen live membutuhkan akses trial, partner, berbayar, atau enterprise; lihat mode akses.

2. Periksa key Anda

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

Anda akan menerima kembali key tersamar Anda, proyek, lingkungan, scope, dan batas laju per jam.

3. Coba satu endpoint live (curl)

Endpoint intelijen menggunakan POST dengan body JSON. Perintah persis ini menjalankan pemeriksaan likuiditas sungguhan pada token Base sungguhan (RWA Inc, kontrak publik yang kami pakai dalam demo). Perintah ini tereksekusi untuk key yang punya akses: key sandbox yang jatah demo live-nya sudah diaktifkan admin, atau key dengan akses trial, partner, berbayar, atau 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"}'

Dengan akses, Anda seharusnya melihat "ok": true dengan identitas token (nama/simbol), snapshot pasar, dan konteks LP/lock di dalam data. meta.credits_charged menunjukkan biaya panggilan itu: 0 pada jatah demo sandbox atau trial, atau harga kredit endpoint tersebut (2 kredit untuk liquidity) pada penggunaan berbayar - panggilan yang gagal tidak pernah ditagih. Tanpa akses, panggilan tidak berjalan gratis: panggilan mengembalikan error 403 yang jelas seperti access_required, dan Anda bisa mengajukan akses trial atau enterprise dari portal. Ganti address dengan kontrak token mana pun di eth, base, atau bsc saat Anda siap.

Jaga kerahasiaan key Anda

Jangan pernah menempelkan API key sungguhan ke repo publik, chat, atau kode sisi klien. Key hanya ditampilkan satu kali saat pembuatan; kalau bocor, rotasi di portal.

4. Panggilan yang sama dalam 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. Bentuk respons

Setiap endpoint menjawab dengan amplop yang sama:

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

Saat gagal:

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

Jaga keamanan key Anda

• Panggil API dari server, jangan pernah dari kode browser atau klien mobile.
• Simpan key di environment variable atau secret manager.
• Kalau key mungkin sudah bocor, cabut atau rotasi di portal - key lama berhenti berfungsi dalam satu menit.