Публичный API Nebula
Указатель справочника
У каждого эндпоинта ниже есть стабильная HTML-страница и её Markdown-двойник. Этот индекс статический, доступен для сканирования и безопасен для чтения AI-агентами без выполнения JavaScript.
Обнаружение
3 эндпоинта/screener
Скринер
Ранжируйте активы или субъекты по одной 24-часовой метрике и фильтруйте по остальным: доля, изменение доли, посты, чистые бычьи посты (бычьи минус медвежьи; отрицательное значение — медвежьи) или 24-часовое изменение цены. Диапазоны включают границы и комбинируются; фильтры по цене применяются только к активам.
/top-momentum
Топ по моментуму
Активы или субъекты, быстрее всех набирающие долю в разговоре: доля за эти 24 часа минус доля за предыдущие 24 часа. share_change_pct — то же изменение относительно вчерашней доли.
/top-trending
Топ по трендам
Активы или субъекты с наибольшей долей обсуждения за последние 24 часа, в порядке убывания, с изменением относительно предыдущих 24 часов.
Поиск
3 эндпоинта/assets
Текст в asset ID
Ищите акции (акции и ETF), сырьё, индексы и криптовалюты по названию или тикеру и получайте asset_id и asset_class, которые принимает любая конечная точка активов. Отправьте query для поиска, asset_id для точного совпадения или ничего, чтобы просмотреть самые активные активы.
/search
Поиск
Один поиск по активам, людям, аккаунтам и темам. Каждый результат сообщает, чем он является, через kind: у активов есть asset_id и asset_class, у субъектов — subject_id. Отправьте kind, чтобы искать только по одной стороне.
/subjects
Текст в subject ID
Ищите людей, аккаунты и темы, включая ИИ, и получайте subject_id, которые принимают конечные точки субъектов. Активы не включены; для них используйте /assets или /search.
Соцсети и настроения
6 эндпоинтов/emotions
Распределение эмоций
Какие из 15 эмоций преобладают в разговоре об активе или субъекте со временем. proportion — доля каждой эмоции среди эмоций бакета (в сумме они дают 1); post_count считает посты, в которых она проявляется. Один пост может проявлять несколько.
/mindshare
Доля внимания
Доля актива или субъекта в обсуждении: его посты за последние 24 часа как часть всех постов на его рынке (акции, криптовалюты или люди и темы), от 0 до 1. Отправьте clusters, чтобы измерить долю внутри одной или нескольких групп авторов.
/related-subjects
Связанные субъекты
Люди, аккаунты и темы, которые чаще всего обсуждаются в тех же постах, что и актив или субъект. share — это общие посты как доля от постов якоря; поля тональности отражают тональность якоря в этих общих постах.
/sentiment
Настроения
Насколько бычьи или медвежьи настроения в обсуждении актива, темы или всего рынка с течением времени. sentiment_signal — это бычьи посты минус медвежьи за последние 24 часа, при этом недавние посты имеют больший вес: положительное значение означает преобладание бычьих настроений. Показатель растёт вместе с объёмом, поэтому сравнивайте актив с его собственной историей.
/sentiment/timeframes
Сентимент по таймфреймам
Тональность в разбивке по горизонту, о котором говорят люди: краткосрочный (до недели), среднесрочный (от недель до месяцев) и долгосрочный (три месяца и более), каждый по шкале /sentiment. Отделяет толпу, которая настроена по-медвежьи на этой неделе, но по-бычьи на год, от той, что настроена по-медвежьи на всём горизонте.
/social-momentum
Социальный импульс
Посты, уникальные авторы и тональность внутри каждого кластера авторов — рядом друг с другом, для актива, субъекта или целого рынка: какие группы движут беседой и чем отличается их тон. Кластеры пересекаются, поэтому не складывайте их. Передайте clusters, чтобы вернуть только названные вами.
Прогнозы
3 эндпоинта/forecasts/assets
Прогнозируемые активы
Все активы, для которых сейчас есть прогноз. Список охватывает и /forecasts/mindshare, и /forecasts/sentiment, которые прогнозируют одни и те же активы: передайте asset_id и asset_class актива в любой из них. Акции, сырьевые товары и индексы идут первыми, затем криптовалюты, самые обсуждаемые — вперёд. Список обновляется каждые пять минут.
/forecasts/mindshare
Прогноз Mindshare
Где, вероятно, окажется mindshare актива в следующие 72 часа — в виде диапазона исходов с их вероятностями. series даёт распределение каждые 4 часа; chance_higher_72h и likely_low_share–likely_high_share обобщают, куда он попадёт; takeoff_chance_72h — вероятность внезапного всплеска внимания.
/forecasts/sentiment
Прогноз сентимента
Куда, вероятно, двинется сентимент актива в следующие 72 часа — диапазон исходов с их вероятностями. series даёт каждые 4 часа ожидаемое число бычьих, медвежьих и нейтральных постов и общее число постов на этом шаге, а также sentiment_signal в его конце, по шкале /sentiment. chance_higher_24h и chance_higher_72h дают вероятность того, что сигнал завершится выше current_sentiment_signal; их флаги _confident отмечают, когда эта вероятность явно склоняется в одну сторону.
Настроения рынка
7 эндпоинтов/calls
Сигналы long/short
Сколько длинных и коротких призывов люди делают по активу или по всему рынку с течением времени. Призыв утверждает, что актив вырастет или упадёт, раскрывает позицию или призывает других её занять; обычное мнение не считается. Отправьте clusters, чтобы подсчитать призывы одной группы.
/calls/returns
Распределение исходов сигналов
Как показали себя недавние призывы: доля прибыльных, медианная и средняя доходность, а также распределение доходностей. Каждый призыв оценивается по движению цены за 24 часа после него, с точки зрения автора призыва, поэтому короткий призыв при падении на 10% даёт +10%. Отправьте clusters, чтобы сравнить группы, например smart_money против dumb_money.
/conviction-index
Индекс уверенности
Показатель от 0 до 100, отражающий силу веры людей в актив. Он объединяет соотношение бычьих настроений по активу и по рынку, то, насколько устойчивы настроения при падении цены, последнее значение бычьего соотношения и эмоции типа жадности. Типичное значение — около 50; сравнивайте актив с его собственной историей.
/fear-greed-index
Индекс страха и жадности
Ежедневный показатель страха и жадности от 0 до 100 для одного актива, объединяющий цену, волатильность, импульс, объём торгов и социальное настроение: до 20 — Extreme Fear, 40 — Fear, 60 — Neutral, 80 — Greed, выше 80 — Extreme Greed. Компоненты перечислены в metadata.
/price-levels
Упоминаемые в соцсетях ценовые уровни
Цены, которые люди называют для актива (цели, уровни поддержки и котируемые уровни), сгруппированные по цене и времени: где толпа закрепляет свои ожидания. mentions считает указанные уровни, поэтому один пост может добавить несколько.
/social-volume-index
Социальный объём против торгового
Что сейчас активнее для актива — торговля или обсуждения, причём каждое сравнивается со своей нормой за 90 дней. volume_index принимает значения 0–100: 50 означает, что оба показателя повышены одинаково, выше 50 — торговля опережает обсуждения, ниже 50 — обсуждения опережают торговлю. Ежедневно, максимум за 90 дней.
/social-volume-profile
Профиль социального объёма
Профиль объёма, построенный по постам, а не по сделкам: где на оси цены происходили обсуждения актива. В каждом бине есть число постов, доли бычьих и медвежьих постов и directional_imbalance от −1 (все медвежьи) до +1 (все бычьи); significance_score ранжирует бины от 0 до 1 по числу постов, балансу, частоте возврата цены к ним и сжатию; точка контроля — самый активный бин. Отправьте clusters, чтобы построить профиль для одной группы.
Рыночные данные
1 эндпоинтАналитика
3 эндпоинта/calendar-events
События календаря
Предстоящие и прошедшие рыночные события (отчётность, публикация экономических данных, IPO, листинги, голосования, слушания) — глобальные или по одному активу либо субъекту, с типом, статусом, важностью от 1 до 3 и участвующими сущностями. По умолчанию — с сегодняшнего дня и далее, сначала самые ранние; отправьте min_importance_score=2 для значимых событий.
/insights
Аналитика
Короткие заметки о том, что происходит на рынках — глобально или по одному активу или субъекту, — каждая с заголовком, сводкой, тональностью (−1, 0 или +1), тегами, важностью от 1 до 3 и связанными сущностями. Сначала недавно обновлённые; отправьте order_by=start_time_desc, чтобы сначала шли самые новые события.
/insights/attention
Внимание к инсайтам
Обсуждение вокруг одной единицы аналитики: 24-часовое окно внимания, количество авторов и распределение тональности, почасовые интервалы, состав кластеров, векторы влияния и ценовые реакции для каждой связанной сущности с ценой. Используйте после /insights, когда читатель открывает одну единицу и ему нужен полный контекст уровня панели.
Кластеры
10 эндпоинтов/clusters
Кластеры авторов
Активность и тональность каждого кластера авторов на рынке: публикации, уникальные авторы, изменение относительно предыдущего окна и чистая тональность (бычьи публикации минус медвежьи) с почасовым рядом. asset_class — это equity (по умолчанию) или crypto.
/clusters/comparison
Сравнение кластеров
Все кластеры авторов рядом друг с другом за окно: публикации и их изменение, насколько кластер бычий относительно рынка (cluster_bullish_share против market_bullish_share), актив, к которому он чаще всего обращался за последние 7 дней (trending_asset), и ежедневные публикации.
/clusters/comparison/divisive-assets
Спорные активы
Широко обсуждаемые активы, по которым кластеры расходятся сильнее всего. minority_share — доля меньшего лагеря среди кластеров, явно склоняющихся к бычьей или медвежьей позиции, так что 0.5 — это равный раскол. Показатель измеряет разделённость обсуждения, а не грядущее движение.
/clusters/comparison/hype-cycles
Приходы цикла хайпа
Крупнейшие хайп-циклы окна и порядок, в котором кластеры присоединялись к каждому из них, относительно пикового часа рынка, вместе с почасовыми постами рынка вокруг пика.
/clusters/comparison/traits
Сравнение признаков кластеров
Каждая характеристика /clusters/profile по всем кластерам, начиная с наибольшей, чтобы увидеть, какие группы лидируют или отстают по каждой из них.
/clusters/hype-cycles
Циклы хайпа кластеров
Насколько рано кластер приходит к хайп-циклам по сравнению с рынком. curve — это накопленная доля постов каждой стороны с 7 дней до пика по 7 дней после, поэтому линия, расположенная левее, соответствует более раннему приходу; lead_days — это опережение кластера (положительное значение означает ранний приход), а clusters ранжирует опережение всех кластеров.
/clusters/overlap
Пересечение кластеров
Какие кластеры следят за теми же активами, что и этот, и совпадают ли они во мнениях. overlap_share — какую долю из своих топ-50 активов разделяет другой кластер; direction_agreement_share — как часто они придерживаются одного направления; stance_gap положительно, когда этот кластер настроен более бычье.
/clusters/profile
Профиль кластера
Поведенческие признаки одного кластера, каждый из которых ранжирован относительно всех остальных кластеров (rank 1 — наивысший):
/clusters/rotation
Ротация кластеров
Куда смещается внимание кластера: активы, набирающие и теряющие долю его постов по сравнению с предыдущим окном, в базисных пунктах, а также распределение его постов по рынкам, людям и событиям.
/clusters/stances
Позиции кластеров
Позиция одного кластера по его самым обсуждаемым активам рядом с позицией рынка, от −1 (полностью медвежья) до +1 (полностью бычья). contrarian_share — как часто он склоняется в сторону, противоположную рынку, со средним значением по другим кластерам для сравнения.