Cognivo Developer API
Cognivo Developer API を使うと、Cognivo Chat、dApp、Telegram ボットを支えているのと同じオンチェーンインテリジェンスを、あなた自身のアプリ、ボット、ダッシュボード、バックエンドから呼び出せます。
- ベース URL：
https://api.cognivolabs.io - 認証： Developer ポータルで自分で作成するスコープ付き API キー
- 現在対応中のチェーン： Ethereum（
eth）、Base（base）、BNB Smart Chain（bsc） - Solana： 近日対応予定（まだ利用できません）
- Webhook： 計画中（まだ利用できません）
- OpenAPI 仕様： cognivo-public-api.yaml - 機械可読な完全仕様。Postman、Insomnia、SDK ジェネレーターにインポートできます
何が作れる？
トークンやウォレットについて、素早く正直な読み取りが必要なものなら何でも。具体的なアイデアをいくつか：
- トークン安全性チェッカーボット - ユーザーがコントラクトアドレスを貼り付けると、リスクシグナル、流動性とロックの状況、「なぜ下がっているのか」を 1 つのメッセージで返すボット
- ウォレット監視ダッシュボード - トレジャリー、クジラ、チームウォレットを監視：承認（approval）の露出、直近の正確な動き、トークンごとの実現損益
- コミュニティ向け Telegram / Discord ツール - Cognivo Chat を支えているのと同じインテリジェンスに裏打ちされた
/check <token>コマンドをコミュニティに提供 - ポートフォリオ損益ビュー - 自己申告の数字ではなく、根拠のあるオンチェーン活動から算出したトークンごとの実現損益をユーザーに表示
- リサーチノートブック - リスク、流動性、チームウォレット、資金移動のデータを Python や JavaScript のノートブックに取り込み、トークンの調査やポストモーテムに活用
- ディスカバリーフィード - Discover フィードの高品質な公開インテリジェンスカードを、あなたのアプリやサイトに表示
この API がしないこと
- 生のノード/RPC アクセスではありません。呼び出すのは常にキュレーションされた Cognivo インテリジェンスエンドポイントであり、チェーンの生 RPC が公開・再販されることはありません。
- 取引、注文執行、MEV ツールは含まれません。
- 結果はインテリジェンスシグナルであり、投資助言ではなく、保証でもありません。クリーンな結果は決して「安全」を意味しません。
アクセスモデルと料金
ライブキーは**セルフサービスの従量課金（pay-as-you-go）**です。キーを作成すればすぐに動きます：申請も、承認待ちも、営業への連絡も不要です。成功した呼び出しごとに、公開されているエンドポイント別価格で、アカウントのクレジット残高から Cognivo クレジットが課金されます。失敗した呼び出しには決して課金されません。
- ライブ（
cogv_live_）キーは API を使う標準的な方法です。ほかの場所で使っているのと同じ Cognivo クレジット残高から従量課金されます。残高が呼び出しをカバーできない場合は、コードpayment_requiredの402エラーが返り、何も課金されません。Cognivo アカウントの課金ページでチャージして、もう一度試してください。 - サンドボックス（
cogv_test_）キーは Sandbox と明確にラベル付けされており、限定的なデモとインテグレーションテスト専用です。ライブインテリジェンスは実行できません。 - トライアルは、管理者が付与する任意の評価枠です。通常の有料利用に必要になることは決してありません。
- パートナーは、管理者が管理するアレンジメントです。
- エンタープライズは、アクセスをリクエストする唯一の経路です：カスタム料金、カスタム上限、大量利用。Developer ポータルからリクエストしてください。
- **停止（suspended）**されたキーは何も実行できません。理由はポータルに表示されます。
エンドポイントごとのクレジット価格は、エンドポイントリファレンスとレート制限、エラー、課金のページで公開されています。GET /v1/api/health は無料でキー不要、GET /v1/api/me は有効なキーがあれば無料、GET /v1/api/discover は厳しめのレート上限つきで無料です。
プライバシーとデータの安全性
API が返すのは公開されているオンチェーンインテリジェンスのみです。レスポンスに Cognivo アカウント識別子、メールアドレス、残高、その他の非公開アカウントデータが含まれることはありません。あなたのものも、他の誰のものも含まれません。唯一の例外は GET /v1/api/me で、呼び出しているキー自身のアカウントのクレジット残高を表示し、支出をモニタリングできるようにします。
はじめかた
- dapp.cognivolabs.io/en/developers に、いつもの Cognivo アカウントでサインインします。
- プロジェクトとライブ API キーを作成します（完全なキーが表示されるのは一度だけ。すぐにコピーしてください）。作成した瞬間から使えます。
- クイックスタートに進みましょう。最初の呼び出しまで 30 秒です。