Skip to main content

Cognivo Developer API

The Cognivo Developer API lets you call the same on-chain intelligence that powers Cognivo Chat, the dApp and the Telegram bot from your own app, bot, dashboard or backend.

  • Base URL: https://api.cognivolabs.io
  • Auth: scoped API keys you create yourself in the Developer portal
  • Chains live today: Ethereum (eth), Base (base), BNB Smart Chain (bsc)
  • Solana: coming soon (not live yet)
  • Webhooks: planned (not live yet)
  • OpenAPI spec: cognivo-public-api.yaml - the full machine-readable spec; import it into Postman, Insomnia, or an SDK generator

What can I build?​

Anything that needs a fast, honest read on a token or wallet. Some concrete ideas:

  • Token safety checker bots - a bot where users paste a contract address and get back risk signals, liquidity and lock context, and "why is it down" in one message
  • Wallet monitoring dashboards - watch a treasury, whale, or team wallet: approval exposure, exact recent movements, realized PnL per token
  • Community Telegram or Discord tools - give your community a /check <token> command backed by the same intelligence that powers Cognivo Chat
  • Portfolio PnL views - show users their realized profit and loss per token, computed from grounded on-chain activity instead of self-reported numbers
  • Research notebooks - pull risk, liquidity, team-wallet, and movement data into Python or JavaScript notebooks for token studies and post-mortems
  • Discovery feeds - surface recent high-quality public intelligence cards from the Discover feed in your own app or site

What this API is not​

  • It is not raw node/RPC access. You always call curated Cognivo intelligence endpoints; raw chain RPC is never exposed or resold.
  • It does not include trading, order execution, or MEV tooling.
  • Results are intelligence signals, not financial advice and not a guarantee. A clean result never means "safe".

Access model and pricing​

Live keys are self-serve and pay-as-you-go. Create a key and it works immediately: no application, no approval queue, no sales call. Each successful call is charged in Cognivo credits from your account's credit balance at the published per-endpoint prices; failed calls are never charged.

  • Live (cogv_live_) keys are the standard way to use the API. They are billed pay-as-you-go from the same Cognivo credit balance you use elsewhere. If your balance cannot cover a call, you get a 402 error with code payment_required and nothing is charged: top up on your Cognivo account billing page and try again.
  • Sandbox (cogv_test_) keys are clearly labelled Sandbox and exist for limited demos and integration testing only. They cannot run live intelligence.
  • Trial is an optional, admin-granted evaluation allowance. You never need it for ordinary paid use.
  • Partner is an admin-managed arrangement.
  • Enterprise is the one path where you request access: custom pricing, custom limits and volume. Request it from the Developer portal.
  • A suspended key cannot execute anything; the portal shows the reason.

Per-endpoint credit prices are published on the Endpoint reference and Rate limits, errors and billing pages. GET /v1/api/health is free and needs no key, GET /v1/api/me is free with any valid key, and GET /v1/api/discover is free with a tight rate cap.

Privacy and data safety​

The API returns public on-chain intelligence only. Responses never include Cognivo account identifiers, emails, balances, or other private account data - yours or anyone else's. The one exception is GET /v1/api/me, which shows the calling key its own account's credit balance so you can monitor spend.

Getting started​

  1. Sign in at dapp.cognivolabs.io/en/developers with your normal Cognivo account.
  2. Create a project and a live API key (the full key is shown exactly once - copy it immediately). It works right away.
  3. Follow the Quickstart - your first call in 30 seconds.