ASCN.AI API — Документация

✨ Введение

Добро пожаловать в ASCN.AI Assistant API! Наша цель — предоставить программный доступ к крипто-аналитике институционального уровня в реальном времени. API преобразует сложные on-chain данные с более чем 20 блокчейнов, а также данные социальных сетей и новостных источников, в готовые к применению инсайты — через простые запросы на естественном языке. Строите торговых ботов, трекеры портфеля или AI-инструменты для управления сообществом — наш API даёт скорость, точность и глубину, которые нужны, чтобы быть на шаг впереди.

🚀 Начало работы

Шаг 1. Получите API-ключ

Быстрый вариант — запросить напрямую в поддержке в Telegram. Более полезный вариант — зарегистрироваться на B2B-платформе, ознакомиться с планами и выбрать Free. Так вы получите доступ к подробным логам запросов, информации о расходе кредитов и возможности мгновенно перейти на платный план.

Шаг 2. Выполните первый запрос

Откройте терминал и выполните команду. Замените YOUR_API_KEY на ваш ключ.

curl --request POST \
  --url 'https://b2b.api.ascn.ai/api/ai-assistant/v2/invoke_assistant' \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --data '{
    "message": "Сделай краткий анализ PEPE: цена, объём, настроения",
    "model": "ascn_v1.2"
  }'

Шаг 3. Посмотрите ответ

Вы получите JSON с анализом монеты PEPE в реальном времени: рыночные метрики, on-chain активность и оценку настроений. Полная структура ответа описана в разделе Схема ответа.

🔓 Аутентификация

Все запросы к API должны быть аутентифицированы. Передавайте ключ в заголовке X-API-Key каждого запроса.

X-API-Key: YOUR_API_KEY

API-ключ — секрет. Не публикуйте его в клиентском коде (браузеры, мобильные приложения). Все запросы к API должны выполняться с защищённого сервера.

🟢 Коды ответов

Код	Значение	Описание
`200`	OK	Запрос успешен.
`400`	Bad Request	Неверный формат запроса или отсутствуют обязательные параметры.
`401`	Unauthorized	Неверный или отсутствующий API-ключ.
`403`	Forbidden	У ключа нет прав на это действие.
`429`	Too Many Requests	Превышен лимит запросов — см. Лимиты запросов.
`500`	Internal Server Error	Ошибка на сервере. Попробуйте позже.

Пример ответа с ошибкой:

{ "detail": "Authentication credentials were not provided." }

🧠 Возможности

Рыночные данные в реальном времени

Данные с более чем 20 блокчейнов: ценовые графики, объём, капитализация и технический анализ любого токена.

Анализ токена

Потоки токенов (CEX), балансы холдеров (топ-адреса, киты, фонды), крупнейшие переводы, активность покупателей и продавцов.

On-chain анализ

Мониторинг DeFi-позиций, трекинг DEX-сделок и выявление прибыльных кошельков на 20+ блокчейнах, включая EVM-сети и Solana.

Бессрочные контракты (DEX)

Инсайты по DEX-фьючерсному рынку в реальном времени. Отслеживайте топ-трейдеров на Hyperliquid, их стратегии, открытые позиции, плечо, P/L и историю сделок.

Анализ настроений

Анализ Telegram-сообществ и новостных медиа — чёткая картина позитивных и негативных настроений по любой монете.

Веб-поиск

AI-ассистент выполняет расширенные поиски для сбора публичной информации о проектах, командах и рыночных трендах.

📜 Шаблоны использования

Сценарий	Описание	Используемые функции
Торговый бот	Бот, торгующий на основе рыночных данных, on-chain событий и анализа настроений.	`Рыночные данные`, `On-chain анализ`, `Настроения`
Трекер портфеля	Обзор криптоактивов, DeFi-позиций и исторической доходности с AI-инсайтами.	`On-chain анализ`
Дашборд настроений	Визуализация настроений рынка по конкретным монетам.	`Анализ настроений`
Управление сообществом	AI-ассистент для Telegram/Discord, отвечающий на вопросы о рынке.	`Веб-поиск`, `Рыночные данные`
Инструмент due diligence	Глубокий анализ новых токенов: распределение холдеров, потоки умных денег.	`Анализ токена`
Исследовательский ассистент	Объединяет on-chain данные, метрики, настроения и веб-информацию.	`Анализ токена`, `Веб-поиск`

📚 API Reference

Base URL: https://b2b.api.ascn.ai

Метод	Эндпоинт	Назначение
`POST`	`/api/ai-assistant/v2/invoke_assistant`	Полный ответ одним запросом.
`POST`	`/api/ai-assistant/v2/invoke_assistant_stream`	Потоковый ответ через SSE.

POST /invoke_assistant

Отправляет сообщение AI-ассистенту и возвращает полный структурированный анализ за один запрос. Тело запроса

Параметр	Тип	Описание
`message`	string	Вопрос или сообщение для AI-ассистента на естественном языке. Обязателен во всех запросах, кроме ответа на HIL-запрос — там достаточно `chat_id` + `hil_response`.
`chat_id`	uuid	Опционально. ID существующего чата для продолжения разговора. Обязателен при ответе на HIL-запрос.
`model`	string	Опционально. Модель AI. По умолчанию: `ascn_v1.2`.
`auto_hil`	bool	Опционально. По умолчанию `false`. При `true` сервис сам разрешает неоднозначность (берёт первый вариант) и возвращает готовый `content`. Только для sync-режима.
`hil_response`	object	Опционально. Ответ пользователя на HIL-запрос — см. Продолжение диалога после HIL.

Пример запроса

{
  "message": "Сделай глубокий on-chain и рыночный анализ DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263 (BONK)",
  "model": "ascn_v1.2"
}

Схема ответа

Поле	Тип	Когда приходит
`chat_id`	uuid	Всегда.
`chat_title`	string	Всегда.
`message_id`	string \| null	При финальном ответе.
`content`	string \| null	Когда ответ готов.
`hil`	object \| null	Когда ассистент ждёт выбор пользователя — см. HIL.
`error`	string \| null	При ошибке.

В одном ответе приходит либо content (ответ готов), либо hil (нужен ввод пользователя) — но не оба одновременно.

Пример: ответ готов

{
  "chat_id": "6f1c2a9e-0b3d-4f27-9c51-8ad2e7b4c910",
  "chat_title": "Анализ BONK",
  "message_id": "msg_01H9Z7",
  "content": "BONK торгуется на уровне ...",
  "hil": null,
  "error": null
}

Пример: требуется выбор пользователя

{
  "chat_id": "6f1c2a9e-0b3d-4f27-9c51-8ad2e7b4c910",
  "chat_title": "Анализ PEPE",
  "message_id": null,
  "content": null,
  "hil": {
    "type": "token_select",
    "description": "Найдено несколько токенов с тикером PEPE. Выберите нужный.",
    "choices": [
      {
        "name": "Pepe",
        "symbol": "PEPE",
        "main_chain": "ethereum",
        "price_usd": 0.0000112,
        "market_cap_usd": 4700000000
      },
      {
        "name": "Pepe on Solana",
        "symbol": "PEPE",
        "main_chain": "solana",
        "price_usd": 0.0000004,
        "market_cap_usd": 1200000
      }
    ]
  },
  "error": null
}

HIL (Human-in-the-Loop)

Ассистент может приостановить обработку и запросить у пользователя уточнение — например, выбрать конкретный токен, когда тикер неоднозначен. В этом случае финального content в ответе нет, вместо него приходит объект hil. Объект hil

Поле	Тип	Описание
`type`	string	Тип запроса. Например, `"token_select"`.
`description`	string	Пояснение для пользователя: что именно нужно выбрать и почему.
`choices`	array of object	Список вариантов на выбор.

Поля элемента choices совпадают с полями элемента hil_response.chosen (см. ниже).

Продолжение диалога после HIL

Чтобы продолжить, отправьте новый запрос на тот же эндпоинт, передав выбор пользователя:

Параметр	Тип	Описание
`chat_id`	uuid	Обязателен. ID чата, в котором пришёл HIL-запрос.
`hil_response.chosen`	array	Выбранные пользователем варианты.
`message`	—	Можно опустить: контекст берётся из чата.

Поля элемента hil_response.chosen (все опциональны — достаточно передать те, что однозначно идентифицируют вариант):

Поле	Тип
`name`	string
`symbol`	string
`logo_url`	string
`main_chain`	string
`contracts`	array
`price_usd`	number
`market_cap_usd`	number
`description`	string

Пример ответа на HIL-запрос

{
  "chat_id": "6f1c2a9e-0b3d-4f27-9c51-8ad2e7b4c910",
  "hil_response": {
    "chosen": [
      {
        "name": "Pepe",
        "symbol": "PEPE",
        "main_chain": "ethereum"
      }
    ]
  }
}

Автоматический выбор: auto_hil

Если интерактивный выбор в вашем сценарии не нужен, передайте auto_hil: true в исходном запросе. Сервис сам возьмёт первый вариант из choices и вернёт готовый content — без промежуточного HIL-ответа.

auto_hil работает только в sync-режиме (/invoke_assistant). В стриминге параметр игнорируется — HIL-события нужно обрабатывать на стороне клиента.

POST /invoke_assistant_stream

Для приложений реального времени — SSE-поток, который отдаёт части ответа по мере генерации. Тело запроса такое же, как у /invoke_assistant, за исключением auto_hil (не применяется). События потока

Событие	Данные	Описание
`chat`	`{"chat_id": "...", "chat_title": "..."}`	Контекст чата в начале потока.
`pending_tool_call`	`{"call_id": "...", "title": {...}}`	Внутренний инструмент вызван для сбора данных.
`finished_tool_call`	`{"call_id": "..."}`	Инструмент завершил работу.
`message_start`	`{"t": "..."}`	Контент сообщения в процессе генерации.
`message_end`	`{"message_id": "..."}`	Текущее сообщение завершено.
`hil`	`{"type": "...", "description": "...", "choices": [ ... ]}`	Ассистент ждёт выбор пользователя.
`finish`	`null`	Завершение всего потока.

Событие hil

event: hil
data: {"type": "token_select", "description": "Найдено несколько токенов с тикером PEPE. Выберите нужный.", "choices": [ ... ]}

Клиент обязан обрабатывать событие hil. Структура data совпадает с полем hil в sync-ответе. После получения события продолжите диалог новым запросом с chat_id и hil_response — так же, как в sync-режиме.

📌 О сервисе

🔴 Лимиты запросов

Тариф	Запросов в минуту
Free	60
Pro	300
Enterprise	Индивидуально

При превышении лимита — HTTP 429 Too Many Requests. Рекомендуем реализовать повторные попытки с экспоненциальной задержкой. Подробности о тарифах и кредитах — на странице цен.

⛓️ Поддерживаемые блокчейны

Категория	Блокчейны
EVM-сети	Ethereum, BNB Chain, Polygon, Arbitrum, Optimism, Avalanche, Base и другие
Solana	Полная поддержка: on-chain данные, DEX-сделки, DeFi-анализ
Другие	Популярные блокчейны вне EVM

🙋 FAQ

Какие языки программирования поддерживаются? API не зависит от языка. Используйте любой, поддерживающий HTTP-запросы. Можно ли использовать API в коммерческих целях? Да. Подробности — в Условиях использования. Чем отличается invoke_assistant от invoke_assistant_stream? invoke_assistant возвращает полный ответ за один запрос. invoke_assistant_stream стримит ответ через SSE — подходит для интерактивных приложений. Почему в ответе нет content? Скорее всего, ассистент запросил уточнение — проверьте поле hil и продолжите диалог с chat_id + hil_response. Если интерактивный выбор не нужен, передавайте auto_hil: true (только в sync-режиме). См. HIL. Есть ли поддержка? Да — info@ascn.ai, Telegram.

🔗 Ссылки

Сайт: https://ascn.ai
B2B-платформа: https://b2b.ascn.ai

​✨ Введение

​🚀 Начало работы

​Шаг 1. Получите API-ключ

​Шаг 2. Выполните первый запрос

​Шаг 3. Посмотрите ответ

​🔓 Аутентификация

​🟢 Коды ответов

​🧠 Возможности

​Рыночные данные в реальном времени

​Анализ токена

​On-chain анализ

​Бессрочные контракты (DEX)

​Анализ настроений

​Веб-поиск

​📜 Шаблоны использования

​📚 API Reference

​POST /invoke_assistant

​Схема ответа

​HIL (Human-in-the-Loop)

​Продолжение диалога после HIL

​Автоматический выбор: auto_hil

​POST /invoke_assistant_stream

​📌 О сервисе

​🔴 Лимиты запросов

​⛓️ Поддерживаемые блокчейны

​🙋 FAQ

​🔗 Ссылки

✨ Введение

🚀 Начало работы

Шаг 1. Получите API-ключ

Шаг 2. Выполните первый запрос

Шаг 3. Посмотрите ответ

🔓 Аутентификация

🟢 Коды ответов

🧠 Возможности

Рыночные данные в реальном времени

Анализ токена

On-chain анализ

Бессрочные контракты (DEX)

Анализ настроений

Веб-поиск

📜 Шаблоны использования

📚 API Reference

POST /invoke_assistant

Схема ответа

HIL (Human-in-the-Loop)

Продолжение диалога после HIL

Автоматический выбор: auto_hil

POST /invoke_assistant_stream

📌 О сервисе

🔴 Лимиты запросов

⛓️ Поддерживаемые блокчейны

🙋 FAQ

🔗 Ссылки