> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ascn.ai/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Программный доступ к крипто-аналитике институционального уровня в реальном времени.

## ✨ Введение

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

Строите торговых ботов, трекеры портфеля или AI-инструменты для управления сообществом — наш API даёт скорость, точность и глубину, которые нужны, чтобы быть на шаг впереди.

***

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

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

**Быстрый вариант** — запросить напрямую в [Поддержку в Telegram](https://t.me/ascnai).

**Более полезный вариант** — зарегистрироваться на [B2B-платформе](https://b2b.ascn.ai), ознакомиться с планами и выбрать Free. Так вы получите доступ к подробным логам запросов, информации о расходе кредитов и возможности мгновенно перейти на платный план.

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

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

```bash theme={null}
curl --request POST \
     --url https://b2b.api.arbitragescanner.io/api/ai-assistant/v1/invoke_assistant \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'X-API-Key: YOUR_API_KEY' \
     --data '{
         "message": "Сделай анализ монеты PEPE: график, рыночные данные и технический анализ"
     }'
```

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

Вы получите JSON с подробным анализом монеты PEPE в реальном времени.

***

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

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

```
X-API-Key: YOUR_API_KEY
```

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

## 🌐 Базовый URL

`https://b2b.api.arbitragescanner.io/api/ai-assistant/v1/`

API построен на принципах REST. Эндпоинты используют стандартные HTTP-методы (`GET`, `POST`) и возвращают JSON.

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

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

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

```json theme={null}
{ "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

### POST /invoke\_assistant

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

**Тело запроса**

| Параметр  | Тип    | Описание                                                                        |
| --------- | ------ | ------------------------------------------------------------------------------- |
| `message` | string | **Обязательный.** Вопрос или сообщение для AI-ассистента на естественном языке. |
| `chat_id` | uuid   | Опционально. ID существующего чата для продолжения разговора.                   |
| `model`   | string | Опционально. Модель AI. По умолчанию: `ascn_v1.2`.                              |

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

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

### POST /invoke\_assistant\_stream

Для приложений реального времени — SSE-поток, который отдаёт части ответа по мере генерации.

**События потока**

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

***

## 📌 О сервисе

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

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

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

Подробности о тарифах и кредитах — на [странице цен](https://arbitragescanner.io/crypto-api).

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

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

***

## 🙋 FAQ

**Какие языки программирования поддерживаются?**
API не зависит от языка. Используйте любой, поддерживающий HTTP-запросы.

**Можно ли использовать API в коммерческих целях?**
Да. Подробности — в [Условиях использования](https://ascn.ai/terms).

**Чем отличается invoke\_assistant от invoke\_assistant\_stream?**
`invoke_assistant` возвращает полный ответ за один запрос. `invoke_assistant_stream` стримит ответ через SSE — подходит для интерактивных приложений.

**Есть ли поддержка?**
Да — [info@ascn.ai](mailto:info@ascn.ai), [Telegram](https://t.me/Ascn_support_bot).

***

## 🔗 Ссылки

* **Сайт:** [https://ascn.ai](https://ascn.ai)
* **B2B-платформа:** [https://b2b.ascn.ai](https://b2b.ascn.ai)
* **Цены:** [https://arbitragescanner.io/crypto-api](https://arbitragescanner.io/crypto-api)

<Card title="Получить бесплатный API-ключ" icon="rocket" href="https://b2b.ascn.ai">
  Зарегистрируйтесь и начните разрабатывать сегодня.
</Card>