Ringkasan Developer API

Apa itu Developer API

Cognivo Developer API memungkinkan Anda memanggil intelijen on-chain yang sama yang menggerakkan Cognivo Chat, dApp dan bot Telegram dari kode Anda sendiri. Anda membuat sebuah proyek, membuat sebuah API key, lalu mengirim permintaan melalui HTTPS biasa.

1. Area Developers adalah tempat Anda membuat proyek dan mengelola API key Cognivo Anda.
2. Pilih Sign in untuk membuka portal developer. Key Anda tetap privat untuk akun Anda.

Halaman Developers di dApp Cognivo.Perbesar gambar

Kapan menggunakannya

Gunakan ketika Anda ingin jawaban Cognivo berada di dalam sesuatu yang sedang Anda bangun, bukan di dalam Cognivo. Kasus umum:

• Bot komunitas tempat seseorang menempelkan alamat kontrak dan menerima sinyal risiko, konteks likuiditas dan lock, serta pembacaan tentang mengapa sebuah token turun.
• Dasbor pemantauan untuk treasury, tim atau dompet whale: paparan approval, pergerakan terbaru, serta untung dan rugi terealisasi per token.
• Notebook riset yang menarik data token dan dompet ke Python atau JavaScript untuk sebuah studi atau post mortem.

Ini bukan akses node atau RPC mentah. Anda selalu memanggil endpoint Cognivo yang telah dikurasi. Tidak ada perangkat trading, eksekusi order atau MEV. Hasilnya adalah sinyal intelijen, bukan nasihat keuangan, dan hasil yang bersih tidak pernah berarti sebuah token itu aman.

Di mana menemukannya

Di dApp, buka sidebar, lalu Account, lalu Developers. Tautan langsungnya adalah dapp.cognivolabs.io/en/developers. Anda harus masuk dengan akun Cognivo Anda yang biasa. Saat keluar dari akun, halaman hanya menampilkan layar orientasi, tanpa proyek atau key.

Bagian atas halaman Developers di dApp, tempat Anda menemukan base URL dan cara mengirimkan kunci API Anda.Perbesar gambar

Kartu di bagian atas halaman memuat tiga hal yang Anda butuhkan untuk melakukan panggilan pertama:

• Base URL: https://api.cognivolabs.io. Tambahkan jalur endpoint padanya untuk membuat sebuah permintaan.
• Auth: kirim API key Anda di header X-API-Key pada setiap permintaan. Simpan key di server Anda, jangan pernah di kode peramban.
• Chains: halaman menampilkan Ethereum, Base, and BSC live, dan More chains coming soon. Sebagian endpoint mendukung lebih sedikit chain dibanding yang lain, dan Referensi endpoint menyebutkan yang mana.

Kartu yang sama menautkan ke dokumentasi ini dan ke spesifikasi OpenAPI yang bisa dibaca mesin, yang dapat Anda impor ke Postman, Insomnia atau sebuah generator SDK.

Halaman ini sendiri punya empat tab: Quickstart, Keys, Endpoints dan Usage. Endpoints adalah referensi berisi contoh yang bisa disalin dan harga setiap panggilan. Tidak ada penjalan langsung di halaman itu, jadi tidak ada yang Anda baca di sana yang mengeluarkan biaya.

Akses, key dan biaya

Live key bersifat swalayan. Buat satu dan langsung berfungsi, tanpa pengajuan dan tanpa antrean persetujuan. Portal menyatakan modelnya secara gamblang: sebagian endpoint gratis dengan key aktif mana pun, dan sebagian lain memerlukan akses berbayar atau Enterprise serta ditagih per panggilan yang berhasil dari saldo kredit Cognivo Anda.

• Live key (cogv_live_) melakukan panggilan sungguhan. Setiap panggilan yang berhasil ditagih dalam kredit Cognivo dengan harga yang diterbitkan untuk endpoint tersebut. Panggilan yang gagal tidak pernah ditagih. Penagihan untuk panggilan Developer API dimatikan hari ini, jadi panggilan yang berhasil tidak memotong apa pun dan saldo Anda tidak berubah.
• Test key (cogv_test_) diberi label Test di portal. Key ini punya batas ketat dan ditujukan untuk mencoba API, bukan untuk trafik sungguhan.
• Setiap key menampilkan mode akses-nya di tab Keys, misalnya Paid, Trial, Partner, Sandbox, Enterprise atau Request access. Key dengan status Request access harus disetujui sebelum bisa menjalankan endpoint berbayar, dan key dengan status Suspended tidak bisa memanggil apa pun. Portal menampilkan alasannya.
• Enterprise adalah satu-satunya jalur yang mengharuskan Anda mengajukan akses, untuk harga dan batas khusus. Tombol akses Enterprise membuka alur dukungan.

Kredit berasal dari saldo yang sama dengan yang Anda pakai di seluruh bagian Cognivo lainnya, dan setiap akun mendapat 5 kredit gratis per hari yang diatur ulang pada tengah malam UTC. Jika saldo Anda tidak mencukupi untuk sebuah panggilan, Anda menerima error 402 dengan kode payment_required, dan tidak ada yang ditagih. Isi ulang lalu coba lagi. Lihat Penagihan dan kredit untuk memahami cara kerja saldo.

GET /v1/api/health gratis dan tidak memerlukan key. GET /v1/api/me gratis dengan key valid mana pun. GET /v1/api/discover gratis dengan batas harian yang ketat. Harga per endpoint ada di Referensi endpoint dan Batas laju, error dan penagihan.

Apa yang kembali, dan arti jawaban kosong

Respons hanya memuat intelijen on-chain publik. Respons tidak pernah menyertakan identifier akun Cognivo, email, saldo atau data akun privat lainnya, baik milik Anda maupun milik orang lain. Satu-satunya pengecualian adalah GET /v1/api/me, yang melaporkan saldo kredit milik key pemanggil itu sendiri sehingga Anda bisa memantau pengeluaran Anda.

Kolom kosong atau nilai unknown berarti Cognivo tidak bisa memverifikasi item tersebut untuk token atau dompet ini pada chain ini. Itu tidak berarti item tersebut tidak ada, dan tidak berarti subjeknya bersih. Perlakukan hasil yang hilang sebagai belum terverifikasi, dan gunakan request ID di dalam respons jika Anda perlu menindaklanjutinya.

Langkah berikutnya

1. Masuk dan buat sebuah proyek, lalu buat sebuah live key. Key lengkap hanya ditampilkan satu kali, jadi salin segera.
2. Jalankan panggilan pertama Anda dengan Mulai Cepat.
3. Baca Autentikasi dan API key untuk izin, rotasi dan keamanan key.