Referensi Endpoint

Apa isi halaman ini

Cognivo Developer API memungkinkan kode Anda sendiri mengajukan pertanyaan yang sama kepada Cognivo seperti yang dijawab aplikasi. Setiap endpoint berada di bawah https://api.cognivolabs.io/v1/api.

Gunakan ketika Anda ingin sebuah pemeriksaan Cognivo berjalan di tempat lain selain aplikasi: di dalam bot Anda sendiri, sebuah dasbor, tugas spreadsheet, atau skrip malam yang mengawasi sederet token.

Endpoint intelijen berupa POST dengan body JSON. Itu disengaja: pratinjau tautan, crawler, atau prefetch browser tidak akan pernah bisa memicu eksekusi hanya dengan memuat sebuah URL. GET hanya ada untuk health, me, dan discover.

Di mana menemukan ini di aplikasi

Masuk ke aplikasi Cognivo, buka Developers di sidebar kiri di bawah Account, lalu pilih tab Endpoints.

Tab Endpoints di halaman Developers, tempat setiap endpoint Cognivo dicantumkan beserta izin yang dibutuhkan dan biayanya.Perbesar gambar

Tab ini adalah referensi, bukan alat penjalan. Tab ini mencantumkan setiap endpoint yang live beserta contoh yang bisa disalin, izin yang dibutuhkan key, dan harganya dalam kredit. Kartu Permissions explained mengelompokkan izin tersebut menjadi tiga: Intelligence (kenapa harganya turun, dompet tim, risiko, Wallet PnL, pergerakan persis), Security (approval token), dan Liquidity (Liquidity, lock, dan burn). Berikan setiap key hanya izin yang dibutuhkannya.

Lebih suka versi yang bisa dibaca mesin? Spesifikasi OpenAPI lengkap mencakup semua yang ada di halaman ini.

Amplop respons

Setiap endpoint menjawab dengan amplop yang sama. Id dan stempel waktu pada contoh di bawah adalah nilai placeholder. Berhasil:

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

• data adalah hasilnya sendiri. Bentuknya berbeda-beda per endpoint.
• meta.request_id adalah id unik untuk panggilan ini. Simpanlah, tim Support bisa melacak sebuah panggilan darinya.
• meta.credits_charged adalah biaya panggilan tersebut: harga endpoint pada panggilan berbayar yang berhasil, dan 0 untuk endpoint gratis serta untuk hasil apa pun yang gagal atau yang jujur kosong.
• meta.generated_at adalah waktu hasil itu dihasilkan.
• meta.chain muncul pada panggilan yang spesifik per chain, dan meta.sources muncul ketika hasilnya mengutip sumber.

Gagal:

{ "ok": false, "error": "invalid_chain", "message": "chain must be one of: eth, base, bsc", "request_id": "capi_..." }

error adalah kode stabil yang bisa dibaca mesin. message adalah petunjuk opsional untuk manusia. Daftar lengkapnya ada di Batas laju dan kesalahan.

Field body yang umum

• chain bernilai salah satu dari eth (Ethereum), base (Base), atau bsc (BNB Chain), dan tidak membedakan huruf besar kecil.
• address, wallet, dan token adalah alamat EVM 0x sepanjang 40 karakter heksadesimal.

Setiap contoh menggunakan placeholder YOUR_API_KEY. Pada kode sungguhan, muat key dari variabel lingkungan atau pengelola rahasia. Jangan pernah menuliskannya langsung di kode.

Berapa biaya setiap endpoint

Live key bersifat mandiri dan bayar sesuai pemakaian. Live key baru langsung bisa menjalankan endpoint ini, dan setiap panggilan yang berhasil dibebankan dalam kredit Cognivo dari saldo akun Anda. Panggilan yang gagal tidak pernah dikenakan biaya, dan panggilan yang berhasil dibebankan tepat satu kali, sehingga pengiriman ulang operasi yang sama tidak bisa membebani Anda dua kali.

Setiap akun mendapat 5 kredit gratis per hari, dan kredit itu disetel ulang pada tengah malam UTC. Jika saldo Anda tidak cukup untuk sebuah panggilan, Anda mendapat 402 payment_required dan tidak ada biaya yang dikenakan. Isi ulang di halaman Billing akun Anda lalu coba lagi. Key sandbox (cogv_test_) tidak bisa menjalankan intelijen live. Lihat Billing dan kredit.

Endpoint	Kredit per panggilan berhasil
POST intel/liquidity	2
POST intel/risk	2
POST wallet/approvals	2
POST intel/why-down	3
POST intel/team-wallets	5
POST wallet/exact-movements	5
POST wallet/pnl	10
POST contract/analysis	gratis
GET health, GET me	gratis
GET discover	gratis, dengan batas laju yang ketat

Layanan

GET /v1/api/health

Memeriksa bahwa API Cognivo sedang aktif. Tidak memerlukan API key.

curl 'https://api.cognivolabs.io/v1/api/health'

const res = await fetch("https://api.cognivolabs.io/v1/api/health");
const json = await res.json();

Respons, yang secara sengaja bukan amplop standar:

{ "ok": true, "service": "cognivo-public-api", "version": "v1", "generated_at": "2026-07-09T00:00:00.000Z" }

Jika API publik dimatikan, Anda juga mendapat 404 public_api_disabled di sini, sehingga endpoint ini sekaligus berfungsi sebagai pemeriksaan ketersediaan.

GET /v1/api/me

Menampilkan detail tentang key yang memanggil: tingkatannya, izinnya, dan batas lajunya. Bekerja dengan key aktif mana pun, dan gratis. Untuk live key mandiri, endpoint ini juga menampilkan credits_balance akun pemilik dan panduan top_up, ditambah access_mode key tersebut.

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

const res = await fetch("https://api.cognivolabs.io/v1/api/me", {
  headers: { "X-API-Key": "YOUR_API_KEY" },
});
const json = await res.json();

{
  "ok": true,
  "data": {
    "key": "cogv_live_****abcd",
    "project_id": "…",
    "environment": "live",
    "tier": "basic",
    "access_mode": "live",
    "scopes": ["intel:read", "liquidity:read"],
    "rate_limit_per_hour": 1000,
    "credits_balance": 1250,
    "top_up": "Manage credits from your Cognivo account billing page."
  },
  "meta": { "request_id": "capi_...", "credits_charged": 0, "generated_at": "…" }
}

Keterbatasan: endpoint ini hanya menampilkan key tersamar, tidak pernah materi key yang lengkap. credits_balance bisa kembali sebagai null, yang berarti Cognivo tidak bisa membaca saldo pada saat itu, bukan berarti saldonya nol.

Endpoint selebihnya semuanya mengikuti bentuk panggilan yang sama seperti contoh di bawah. Tukar path dan field body-nya.

Intelijen token

POST /v1/api/intel/why-down, izin Intelligence (intel:read)

Pembacaan dalam bahasa sederhana tentang mengapa harga sebuah token turun, disusun dari aktivitas on-chain terkini: penjualan besar-besaran, likuiditas yang ditarik, dompet pemilik atau tim yang bergerak.

Harga tercantum: 3 kredit per panggilan yang berhasil. Panggilan yang gagal tidak pernah dikenakan biaya. Penagihan untuk panggilan Developer API dimatikan hari ini, jadi panggilan yang berhasil tidak memotong apa pun dan saldo Anda tidak berubah.

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

const res = await fetch("https://api.cognivolabs.io/v1/api/intel/why-down", {
  method: "POST",
  headers: { "X-API-Key": "YOUR_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ chain: "base", address: "0xTOKEN_CONTRACT" }),
});
const json = await res.json();

Respons: amplop standar. data memuat pemicu dominan dan pengamatan on-chain di baliknya, dengan meta.chain terisi.

Keterbatasan: pembacaan ini membutuhkan aktivitas terkini untuk bisa mengatakan sesuatu yang berguna, jadi token dengan riwayat perdagangan yang sangat sedikit memberi jawaban yang tipis. Ini adalah sinyal, bukan nasihat keuangan.

POST /v1/api/intel/team-wallets, izin Intelligence (intel:read)

Memunculkan dompet yang terkait dengan tim atau treasury sebuah token: dompet deployer, pemilik, dan pengendali, ditambah apa yang mereka lakukan belakangan ini.

Harga tercantum: 5 kredit per panggilan yang berhasil. Panggilan yang gagal tidak pernah dikenakan biaya. Penagihan untuk panggilan Developer API dimatikan hari ini, jadi panggilan yang berhasil tidak memotong apa pun dan saldo Anda tidak berubah.

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

Respons: amplop standar. data mencantumkan dompet yang teridentifikasi dan perilaku terkini mereka, sering kali dengan meta.sources.

Keterbatasan: dompet diidentifikasi dari hubungan on-chain seperti deployment, kepemilikan, dan kendali. Cognivo tidak bisa melihat struktur tim di luar chain, jadi daftar yang kosong berarti tidak ada yang bisa dikaitkan di chain, bukan berarti sebuah token tidak punya tim.

POST /v1/api/intel/liquidity, izin Liquidity (liquidity:read)

Memeriksa likuiditas, lock, dan burn sebuah token dengan bukti on-chain: konteks pool, siapa yang memegang token LP, serta konteks lock atau burn.

Harga tercantum: 2 kredit per panggilan yang berhasil. Panggilan yang gagal tidak pernah dikenakan biaya. Penagihan untuk panggilan Developer API dimatikan hari ini, jadi panggilan yang berhasil tidak memotong apa pun dan saldo Anda tidak berubah.

Boolean opsional metadata, locks, dan full menambahkan metadata pool, bukti lock berjangka waktu, dan pembacaan terlengkap yang tersedia.

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":"0xTOKEN_CONTRACT","locks":true}'

Respons: amplop standar. data memuat identitas token, cuplikan pasar, dan kustodi LP beserta konteks lock atau burn.

Keterbatasan: asal usul burn historis yang mendalam tidak dibuka di v1. Konteks lock mencakup pola locker yang dikenali, sehingga locker khusus yang tidak lazim bisa terbaca sebagai kustodi biasa dan bukan sebagai lock. Bacalah itu sebagai "tidak terverifikasi", bukan sebagai "tidak terkunci".

POST /v1/api/intel/risk, izin Intelligence (intel:read)

Cognivo Risk Signals untuk sebuah kontrak token, sadar chain, dengan pembacaan tanda bahaya sebagai cadangan.

Harga tercantum: 2 kredit per panggilan yang berhasil. Panggilan yang gagal tidak pernah dikenakan biaya. Penagihan untuk panggilan Developer API dimatikan hari ini, jadi panggilan yang berhasil tidak memotong apa pun dan saldo Anda tidak berubah.

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

Respons: amplop standar. data memuat sinyal dan tanda bahaya yang ditemukan untuk token tersebut.

Keterbatasan: hasil yang bersih tidak berarti token itu aman. Artinya tidak ada tanda bahaya yang dikenal ditemukan pada saat pembacaan.

POST /v1/api/contract/analysis, izin Contract (contract:read)

Bukti kontrak dan kendali untuk sebuah alamat kontrak: apakah kontraknya ada, siapa pemiliknya, apakah kepemilikannya dilepaskan, apakah ia sebuah proxy dan siapa yang mengelolanya, siapa yang men-deploy-nya, dompet mana yang bisa diatribusikan sebagai pengendali atau tim, dan apakah kode sumbernya terverifikasi.

Biaya: 0 kredit. Endpoint ini gratis berdasarkan keputusan, pada setiap paket. Tidak ada yang dipotong.

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

Respons: amplop standar. data memuat contract, ownership, proxy, deployer, controllers, source_verification, limitations, dan unavailable.

Setiap field memberi tahu Anda dari mana asalnya. meta.provenance memetakan setiap field ke tepat salah satu dari:

Label	Artinya
verified_onchain	Dibaca dari sebuah node untuk jaringan itu pada saat permintaan Anda. Sebuah fakta.
augmented	Cognivo Augmented Intelligence: dipasok oleh sumber luar, diperiksa silang tetapi tidak dibuktikan oleh Cognivo.
interpretation	Pembacaan Cognivo atas fakta yang ada. Sebuah penilaian, bukan fakta.
unavailable	Cognivo tidak bisa memperolehnya. Alasannya ada di data.unavailable.

Tidak ada yang ditebak, diisi dengan nilai bawaan, atau dikembalikan sebagai nol untuk menutupi kekosongan.

meta.chain_data_source.cognivo_grounded memberi tahu Anda apakah Cognivo mengoperasikan infrastruktur asal pembacaan itu. Cognivo menjalankan node Ethereum sendiri, sehingga pembacaan Ethereum bernilai true. Pembacaan Base dan BNB Chain berasal dari infrastruktur RPC luar, sehingga bernilai false. Pembacaan tersebut akurat, tetapi tidak disajikan dari perangkat keras yang dikendalikan Cognivo, dan Cognivo menyatakannya alih-alih membiarkan Anda mengira sebaliknya.

Keterbatasan di Base, yang juga dikembalikan dalam data.limitations:

• Grafik pengendali yang mendalam hanya untuk Ethereum. Di Base, atribusi pengendali dan tim berasal dari pembacaan peran dompet yang lebih sempit.
• Bukti deployer di Base berasal dari sumber luar, bukan dari pembacaan arsip Cognivo. Perlakukan sebagai petunjuk kuat, bukan fakta yang terbukti.
• Jadwal lock likuiditas tidak didekode di Base. Gunakan POST /v1/api/intel/liquidity untuk kustodi LP dan bukti burn, dan jangan membaca lock yang tidak ada sebagai lock yang absen.

Endpoint ini hanya melaporkan bukti kendali kontrak. Ia tidak mengatakan apa pun tentang likuiditas, dan hasil yang bersih tidak pernah berarti kontrak itu aman.

Hanya baca: tidak ada yang ditandatangani, tidak ada transaksi yang dibangun, tidak ada yang disiarkan, dan tidak ada dompet yang didelegasikan.

Intelijen dompet

POST /v1/api/wallet/pnl, izin Intelligence (intel:read)

Laba dan rugi untuk satu dompet pada satu token, dihitung dari swap on-chain yang tergrounded. Baik wallet maupun token wajib diisi.

Harga tercantum: 10 kredit per panggilan yang berhasil. Panggilan yang gagal, dan hasil 422 tanpa data, tidak pernah dikenakan biaya. Penagihan untuk panggilan Developer API dimatikan hari ini, jadi panggilan yang berhasil tidak memotong apa pun dan saldo Anda tidak berubah.

curl -X POST 'https://api.cognivolabs.io/v1/api/wallet/pnl' \
  -H 'X-API-Key: YOUR_API_KEY' -H 'Content-Type: application/json' \
  -d '{"chain":"base","wallet":"0xWALLET","token":"0xTOKEN_CONTRACT"}'

Respons: amplop standar. data memuat angka terealisasi, dan angka belum terealisasi untuk posisi yang masih dipegang bila ada basis biaya yang bisa dipertanggungjawabkan.

Keterbatasan: ketika tidak ada basis biaya yang bisa dipertanggungjawabkan, angka belum terealisasi dikembalikan sebagai null alih-alih angka karangan. Ketika dompet sama sekali tidak punya perdagangan berharga pada token itu, panggilan mengembalikan 422 (misalnya insufficient_data), yang berarti Cognivo tidak bisa menghitung angka yang wajar, bukan berarti labanya nol. Respons 422 tidak pernah dikenakan biaya. Swap yang tidak bisa diberi harga oleh Cognivo ditampilkan sebagai tanpa harga, bukan dibuang.

POST /v1/api/wallet/approvals, izin Security (security:read)

Mencantumkan approval pembelanjaan token yang telah diberikan sebuah dompet, dan menandai allowance yang tidak terbatas.

Harga tercantum: 2 kredit per panggilan yang berhasil. Panggilan yang gagal tidak pernah dikenakan biaya. Penagihan untuk panggilan Developer API dimatikan hari ini, jadi panggilan yang berhasil tidak memotong apa pun dan saldo Anda tidak berubah.

limit dan offset opsional untuk menelusuri kumpulan approval yang besar halaman demi halaman.

curl -X POST 'https://api.cognivolabs.io/v1/api/wallet/approvals' \
  -H 'X-API-Key: YOUR_API_KEY' -H 'Content-Type: application/json' \
  -d '{"chain":"eth","address":"0xWALLET"}'

Respons: amplop standar. data memuat daftar approval beserta konteks spender, token, dan allowance.

Keterbatasan: ini hanya baca. Cognivo tidak pernah memindahkan dana dan tidak bisa mencabut sebuah approval untuk Anda. Pencabutan selalu dilakukan dari dompet Anda sendiri. Daftar kosong adalah jawaban berhasil yang sah, dan tidak dikenakan biaya.

POST /v1/api/wallet/exact-movements, izin Intelligence (intel:read)

Mencantumkan pergerakan token persis sebuah dompet: pembelian, penjualan, dan transfer. token bersifat opsional dan mempersempit pembacaan ke satu token.

Harga tercantum: 5 kredit per panggilan yang berhasil. Panggilan yang gagal tidak pernah dikenakan biaya. Penagihan untuk panggilan Developer API dimatikan hari ini, jadi panggilan yang berhasil tidak memotong apa pun dan saldo Anda tidak berubah.

curl -X POST 'https://api.cognivolabs.io/v1/api/wallet/exact-movements' \
  -H 'X-API-Key: YOUR_API_KEY' -H 'Content-Type: application/json' \
  -d '{"chain":"base","wallet":"0xWALLET"}'

Respons: amplop standar. data memuat daftar pergerakan beserta jumlahnya.

Keterbatasan: panggilan mengembalikan pergerakan terbaru, hingga 25 per panggilan. Dompet tanpa pergerakan yang cocok mengembalikan 422 alih-alih riwayat karangan.

Discover

GET /v1/api/discover

Feed Discover publik: kartu intelijen on-chain teranonimkan terkini, masing-masing dengan identitas token, sebuah kail, dan poin-poin. Bekerja dengan key aktif mana pun. Gratis, dengan batas harian yang ketat.

Parameter kueri: limit (1 sampai 50, bawaan 20) dan chain opsional (eth, base, bsc).

curl 'https://api.cognivolabs.io/v1/api/discover?limit=10&chain=base' \
  -H 'X-API-Key: YOUR_API_KEY'

{
  "ok": true,
  "data": { "cards": [ { "...": "public intelligence card" } ], "total": 10 },
  "meta": { "request_id": "capi_...", "credits_charged": 0, "generated_at": "…" }
}

Keterbatasan: nilai limit di luar 1 sampai 50 dijepit ke dalam rentang. Feed hanya berisi intelijen yang dipilih pengguna untuk dipublikasikan, jadi ini adalah sampel, bukan cakupan penuh.

Belum tersedia

Berikut ini dicantumkan demi transparansi dan saat ini tidak mengembalikan apa pun:

• Penelusuran dompet mendalam melalui API (wallet/trace). Alur pekerjaan asinkronnya untuk saat ini hanya di chat dan aplikasi.
• Pengambilan laporan berdasarkan id (reports/:id).
• Webhook.
• Endpoint Solana.

Langkah berikutnya

Lakukan panggilan pertama Anda dengan Panduan Cepat, buat dan tentukan cakupan sebuah key di Autentikasi dan key, dan baca Batas laju dan kesalahan sebelum Anda menjadwalkan apa pun.