Nebula CLI

Запрашивайте аналитику по мировым рынкам — акциям, сырью, индексам, криптовалютам и AI — из терминала, скриптов или CI.

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

УстановкаУстановите CLI глобально с помощью Node.js 18 или более поздней версии. АутентификацияСохраните ключ локально или настройте его для автоматизации. ПримерыВыполняйте типовые запросы аналитики рынков из терминала. CI и автоматизацияИспользуйте структурированный вывод и учётные данные из менеджера секретов в рабочих процессах.

Установка

Для CLI требуется Node.js 18 или более поздней версии.

npm install --global @hiddensystems/nebula-cli

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

nebula auth login --key YOUR_API_KEY

CLI сохраняет ключ в ~/.nebula/config.json с правами доступа только для владельца. Для автоматизации вместо этого задайте NEBULA_API_KEY.

Платежи x402

Вы также можете оплачивать доступные для этого чтения API с помощью USDC в сети Base через отдельный x402 HTTP API — без аккаунта Nebula и ключа API. Каждый платёж авторизуется вашим кошельком. Подключения MCP и CLI по-прежнему используют аутентификацию аккаунта и кредиты; они не выполняют платежи с кошелька автоматически. См. руководство по оплате через x402.

Примеры

nebula api list_assets --asset-class equity --query NVIDIA
nebula api get_sentiment
nebula api get_mindshare --asset-id NVDA --asset-class equity
nebula api create_chat_completion --body '{"messages":[{"content":"What changed in NVIDIA sentiment this week?","role":"user"}],"stream":false,"thinking_mode":"auto"}'

Обзор эндпоинтов

Каждая команда CLI использует то же ценообразование на уровне операции и общий баланс аккаунта, что и REST API, MCP, CLI и Nebula Agent.

Операции с фиксированной стоимостью расходуют указанное число кредитов за запрос.
Параметры не влияют на стоимость операции, кроме случаев, когда в её строке указана цена для конкретного параметра: повторный запуск прогноза доли внимания или настроений с refresh=true стоит 10 кредитов вместо 5. Настроения всегда стоят 1 кредит — с фильтрами по кластерам или без них.
В строке также может быть указана более низкая цена за менее полный ответ: прогноз, который актив не может иметь (not_forecastable), бесплатен — до 30 таких ответов на аккаунт в час; после этого эндпоинт отвечает 429, пока час не истечёт. Запрос, завершившийся ошибкой, не стоит ничего.
Запросы агента используют переменную цену, зависящую от объёма токенов, стоимости модели и вызовов инструментов. В завершённом ответе указывается число использованных кредитов.
Каждая операция доступна на любом тарифе. Тарифы различаются окном истории (Free: 90 дней; Pro: максимум для каждого эндпоинта — год для большинства временных рядов), лимитом запросов (Free: 60 запросов в минуту; Pro: 300) и включёнными месячными кредитами; покупка кредитов продлевает использование, но не изменяет историю или лимиты запросов.

Обнаружение

Команда	Кредиты	Описание
`nebula api screener`	2	Скринер
`nebula api get_top_momentum`	2	Топ по моментуму
`nebula api get_top_trending`	2	Топ по трендам

Поиск

Команда	Кредиты	Описание
`nebula api list_assets`	1	Текст в asset ID
`nebula api search`	1	Поиск
`nebula api list_subjects`	1	Текст в subject ID

Соцсети и настроения

Команда	Кредиты	Описание
`nebula api get_emotions`	1	Распределение эмоций
`nebula api get_mindshare`	2	Доля внимания
`nebula api get_related_subjects`	2	Связанные субъекты
`nebula api get_sentiment`	1	Настроения
`nebula api get_sentiment_timeframes`	1	Сентимент по таймфреймам
`nebula api get_social_momentum`	2	Социальный импульс

Прогнозы

Команда	Кредиты	Описание
`nebula api list_forecast_assets`	1	Прогнозируемые активы
`nebula api get_mindshare_forecast`	5 (10 при refresh=true; бесплатно при not_forecastable, 30 в час)	Прогноз Mindshare
`nebula api get_sentiment_forecast`	5 (10 при refresh=true; бесплатно при not_forecastable, 30 в час)	Прогноз сентимента

Настроения рынка

Команда	Кредиты	Описание
`nebula api get_calls`	2	Сигналы long/short
`nebula api get_call_returns`	2	Распределение исходов сигналов
`nebula api get_conviction_index`	2	Индекс уверенности
`nebula api get_fear_greed_index`	1	Индекс страха и жадности
`nebula api get_price_levels`	2	Упоминаемые в соцсетях ценовые уровни
`nebula api get_social_volume_index`	2	Социальный объём против торгового
`nebula api get_social_volume_profile`	2	Профиль социального объёма

Рыночные данные

Команда	Кредиты	Описание
`nebula api get_price_history`	1	История цен

Аналитика

Команда	Кредиты	Описание
`nebula api list_calendar_events`	5	События календаря
`nebula api list_insights`	5	Аналитика
`nebula api get_insight_attention`	5	Внимание к инсайтам

Кластеры

Команда	Кредиты	Описание
`nebula api list_clusters`	2	Кластеры авторов
`nebula api compare_clusters`	2	Сравнение кластеров
`nebula api get_divisive_assets`	2	Спорные активы
`nebula api compare_hype_cycles`	2	Приходы цикла хайпа
`nebula api compare_cluster_traits`	2	Сравнение признаков кластеров
`nebula api get_cluster_hype_cycles`	2	Циклы хайпа кластеров
`nebula api get_cluster_overlap`	2	Пересечение кластеров
`nebula api get_cluster_profile`	2	Профиль кластера
`nebula api get_cluster_rotation`	2	Ротация кластеров
`nebula api get_cluster_stances`	2	Позиции кластеров

Агент

Команда	Кредиты	Описание
`nebula api create_chat_completion`	Переменная	Завершения чата Nebula Agent

Аккаунт

Команда	Кредиты	Описание
`nebula api get_account`	0	Аккаунт

Сгенерированные команды

Пути, методы, текст справки, значения по умолчанию, ограничения селекторов, схемы запросов и валидация берутся напрямую из OpenAPI.

`nebula api compare_cluster_traits`	Сравнение признаков кластеров
`nebula api compare_clusters`	Сравнение кластеров
`nebula api compare_hype_cycles`	Приходы цикла хайпа
`nebula api create_chat_completion`	Завершения чата Nebula Agent
`nebula api get_account`	Аккаунт
`nebula api get_call_returns`	Распределение исходов сигналов
`nebula api get_calls`	Сигналы long/short
`nebula api get_cluster_hype_cycles`	Циклы хайпа кластеров
`nebula api get_cluster_overlap`	Пересечение кластеров
`nebula api get_cluster_profile`	Профиль кластера
`nebula api get_cluster_rotation`	Ротация кластеров
`nebula api get_cluster_stances`	Позиции кластеров
`nebula api get_conviction_index`	Индекс уверенности
`nebula api get_divisive_assets`	Спорные активы
`nebula api get_emotions`	Распределение эмоций
`nebula api get_fear_greed_index`	Индекс страха и жадности
`nebula api get_insight_attention`	Внимание к инсайтам
`nebula api get_mindshare`	Доля внимания
`nebula api get_mindshare_forecast`	Прогноз Mindshare
`nebula api get_price_history`	История цен
`nebula api get_price_levels`	Упоминаемые в соцсетях ценовые уровни
`nebula api get_related_subjects`	Связанные субъекты
`nebula api get_sentiment`	Настроения
`nebula api get_sentiment_forecast`	Прогноз сентимента
`nebula api get_sentiment_timeframes`	Сентимент по таймфреймам
`nebula api get_social_momentum`	Социальный импульс
`nebula api get_social_volume_index`	Социальный объём против торгового
`nebula api get_social_volume_profile`	Профиль социального объёма
`nebula api get_top_momentum`	Топ по моментуму
`nebula api get_top_trending`	Топ по трендам
`nebula api list_assets`	Текст в asset ID
`nebula api list_calendar_events`	События календаря
`nebula api list_clusters`	Кластеры авторов
`nebula api list_forecast_assets`	Прогнозируемые активы
`nebula api list_insights`	Аналитика
`nebula api list_subjects`	Текст в subject ID
`nebula api screener`	Скринер
`nebula api search`	Поиск

JSON и агенты для написания кода

Добавьте --json для машиночитаемого вывода. Выполните nebula api <operation_id> --help, чтобы увидеть сгенерированные параметры для любой операции.

Помощник MCP

Выполните nebula mcp, чтобы вывести конфигурацию клиента MCP. Подробности настройки см. в документации MCP.

CI и автоматизация

Задайте NEBULA_API_KEY в вашем менеджере секретов и используйте --json для структурированного вывода. Используйте NEBULA_API_BASE_URL только для разработки или самостоятельно размещённых API.