Перейти к основному содержимому

Cognivo Developer API

Cognivo Developer API позволяет вызывать ту же on-chain аналитику, на которой работают Cognivo Chat, dApp и Telegram-бот, из вашего собственного приложения, бота, дашборда или бэкенда.

  • Base URL: https://api.cognivolabs.io
  • Аутентификация: API-ключи со скоупами, которые вы создаёте сами в портале разработчика
  • Сети, доступные сегодня: Ethereum (eth), Base (base), BNB Smart Chain (bsc)
  • Solana: скоро (пока не запущена)
  • Вебхуки: в планах (пока не запущены)
  • Спецификация OpenAPI: cognivo-public-api.yaml - полная машиночитаемая спецификация; импортируйте её в Postman, Insomnia или генератор SDK

Что можно построить?​

Всё, чему нужен быстрый и честный взгляд на токен или кошелёк. Несколько конкретных идей:

  • Боты для проверки безопасности токенов - бот, куда пользователь вставляет адрес контракта и получает в одном сообщении сигналы риска, контекст ликвидности и локов, а также ответ на вопрос «почему падает»
  • Дашборды мониторинга кошельков - следите за казначейством, китом или командным кошельком: риски по approvals, точные последние движения, реализованный PnL по каждому токену
  • Инструменты для комьюнити в Telegram или Discord - дайте своему комьюнити команду /check <token>, работающую на той же аналитике, что и Cognivo Chat
  • Портфельные PnL-обзоры - показывайте пользователям реализованную прибыль и убыток по каждому токену, рассчитанные по подтверждённой on-chain активности, а не по самоотчётам
  • Исследовательские ноутбуки - выгружайте данные о рисках, ликвидности, командных кошельках и движениях в Python- или JavaScript-ноутбуки для исследований токенов и разборов инцидентов
  • Ленты Discovery - показывайте свежие качественные публичные аналитические карточки из ленты Discover в собственном приложении или на сайте

Чем этот API не является​

  • Это не сырой доступ к нодам/RPC. Вы всегда обращаетесь к курируемым аналитическим эндпоинтам Cognivo; сырой RPC блокчейна никогда не открывается и не перепродаётся.
  • Он не включает трейдинг, исполнение ордеров или MEV-инструменты.
  • Результаты - это аналитические сигналы, не финансовый совет и не гарантия. Чистый результат никогда не означает «безопасно».

Модель доступа и цены​

Live-ключи работают по модели self-serve и pay-as-you-go. Создайте ключ - и он работает сразу: никакой заявки, никакой очереди на одобрение, никакого звонка отделу продаж. Каждый успешный вызов тарифицируется в кредитах Cognivo с баланса кредитов вашего аккаунта по опубликованным ценам для каждого эндпоинта; неудачные вызовы никогда не тарифицируются.

  • Live-ключи (cogv_live_) - стандартный способ пользоваться API. Они оплачиваются pay-as-you-go с того же баланса кредитов Cognivo, который вы используете в других местах. Если баланса не хватает на вызов, вы получаете ошибку 402 с кодом payment_required, и ничего не списывается: пополните баланс на странице биллинга вашего аккаунта Cognivo и попробуйте снова.
  • Sandbox-ключи (cogv_test_) явно помечены как Sandbox и существуют только для ограниченных демо и интеграционного тестирования. Они не могут выполнять живую аналитику.
  • Trial - необязательная оценочная квота, выдаваемая администратором. Для обычного платного использования она никогда не нужна.
  • Партнёрский режим - соглашение, управляемое администратором.
  • Enterprise - единственный путь, где вы запрашиваете доступ: индивидуальные цены, индивидуальные лимиты и объёмы. Запросите его в портале разработчика.
  • Приостановленный (suspended) ключ не может ничего выполнять; портал показывает причину.

Цены в кредитах для каждого эндпоинта опубликованы на страницах Справочник эндпоинтов и Лимиты, ошибки и биллинг. GET /v1/api/health бесплатен и не требует ключа, GET /v1/api/me бесплатен с любым действительным ключом, а GET /v1/api/discover бесплатен с жёстким лимитом запросов.

Приватность и безопасность данных​

API возвращает только публичную on-chain аналитику. Ответы никогда не содержат идентификаторы аккаунтов Cognivo, email-адреса, балансы или другие приватные данные аккаунтов - ни ваши, ни чьи-либо ещё. Единственное исключение - GET /v1/api/me, который показывает вызывающему ключу баланс кредитов его собственного аккаунта, чтобы вы могли следить за расходами.

С чего начать​

  1. Войдите на dapp.cognivolabs.io/en/developers со своим обычным аккаунтом Cognivo.
  2. Создайте проект и live-ключ API (полный ключ показывается ровно один раз - сразу скопируйте его). Он работает сразу.
  3. Пройдите Быстрый старт - ваш первый вызов за 30 секунд.