Прогноз Mindshare
/forecasts/mindshare
Где, вероятно, окажется mindshare актива в следующие 72 часа — в виде диапазона исходов с их вероятностями. series даёт распределение каждые 4 часа; chance_higher_72h и likely_low_share–likely_high_share обобщают, куда он попадёт; takeoff_chance_72h — вероятность внезапного всплеска внимания.
Прогнозы обновляются в течение минуты после новых постов об активе и не реже, чем каждые 15 минут. refresh=true пересчитывает по последним данным примерно за 5 секунд; если это занимает больше 20, вы получаете последний прогноз с refreshed: false, за 5 кредитов. Активы без прогноза возвращают status: not_forecastable с reason; /forecasts/assets перечисляет активы, для которых прогноз есть.
Стоит 5 кредитов или 10 с refresh=true. Ответы not_forecastable бесплатны, до 30 в час на аккаунт; сверх этого эндпоинт возвращает 429, пока час не обнулится.
Оплата кошельком недоступна для этой операции; используйте аутентификацию аккаунта. Руководство по оплате x402.
Параметры
Asset ID из /assets или /search, например NVDA, GLD, SPX или bitcoin. Передавайте его вместе с возвращённым рядом с ним asset_class.
Example:NVDA
Класс актива, указанного в asset_id: equity (акции и ETF), commodity, index или crypto. Передавайте asset_class, который /assets или /search вернули вместе с asset_id.
equitycommodityindexcrypto
Example:equity
true пересчитывает прогноз по последним данным: 10 кредитов, около 5 секунд. По умолчанию false.
Example:false
Пример cURL
curl --get \
--url 'https://nebula-api.hiddensystems.ai/api/v1/public/forecasts/mindshare' \
--data-urlencode 'asset_id=NVDA' \
--data-urlencode 'asset_class=equity' \
--header 'X-API-Key: YOUR_API_KEY'Ответы
Тип медиа application/json
as_of
Начало прогноза в UTC: конец последних полных 15 минут, по которым он был рассчитан. Null, если актив никогда не оценивался.
chance_higher_72h
Вероятность того, что доля будет выше current_share через 72 часа, от 0 до 1.
current_share
Доля актива на момент as_of, от 0 до 1: точка отсчёта для всех траекторий и значение, относительно которого измеряются вероятности.
horizon_hours
На сколько часов вперёд строится прогноз: всегда 72.
likely_high_share
90-й процентиль доли через 72 часа: вероятность 90%, что итоговое значение окажется ниже него.
likely_low_share
10-й процентиль доли через 72 часа: вероятность 90%, что итоговое значение окажется выше него.
reason
Почему актив нельзя спрогнозировать: too_little_history, stale_data или missing_price. Null, когда status равен ok.
too_little_historystale_datamissing_pricenull
refreshed
True, когда этот запрос перезапустил прогноз (refresh=true и повторный расчёт успел завершиться); false, когда это последний прогноз по расписанию, обновляемый каждые пять минут.
sample_paths
24 возможные траектории доли, каждая выровнена с series. Постройте их, чтобы показать разброс исходов.
series
array<object>
Распределение прогноза каждые 4 часа от as_of: 18 шагов, от самого раннего к самому позднему.
series
Распределение прогноза каждые 4 часа от as_of: 18 шагов, от самого раннего к самому позднему.
series[].mean_share
Ожидаемая доля на этом шаге.
series[].p10_share
10-й процентиль доли на этом шаге, от 0 до 1.
series[].p25_share
25-й процентиль доли на этом шаге, от 0 до 1.
series[].p50_share
50-й процентиль доли на этом шаге, от 0 до 1.
series[].p75_share
75-й процентиль доли на этом шаге, от 0 до 1.
series[].p90_share
90-й процентиль доли на этом шаге, от 0 до 1.
series[].quantile_shares
21 квантиль доли на этом шаге: 0-й, 5-й, 10-й, ... 100-й процентили, от наименьшего к наибольшему. Интерполируйте между ними, чтобы получить вероятность попадания в любой диапазон.
series[].timestamp
Время UTC, на которое прогнозируется шаг: as_of плюс 4, 8, ... 72 часа.
status
ok или not_forecastable, когда актив нельзя спрогнозировать (тогда поля сводки равны null, а series пуст; reason объясняет причину).
oknot_forecastable
takeoff_chance_72h
Вероятность резкого всплеска внимания к активу в течение 72 часов, от 0 до 1. Null, когда оценки нет.
{
"as_of": "2026-09-14T09:15:00Z",
"chance_higher_72h": 0.63,
"current_share": 0.0498,
"horizon_hours": 72,
"likely_high_share": 0.1022,
"likely_low_share": 0.0331,
"reason": null,
"refreshed": false,
"sample_paths": [
[
0.0502,
0.0515,
0.0531
],
[
0.0494,
0.0488,
0.0479
]
],
"series": [
{
"mean_share": 0.0512,
"p10_share": 0.039936000000000006,
"p25_share": 0.045568000000000004,
"p50_share": 0.050176,
"p75_share": 0.055296000000000005,
"p90_share": 0.063488,
"quantile_shares": [
0.0301,
0.0352,
0.0391,
0.0418,
0.0437,
0.0451,
0.0463,
0.0474,
0.0484,
0.0493,
0.0502,
0.0511,
0.0521,
0.0532,
0.0544,
0.0557,
0.0573,
0.0594,
0.0623,
0.0671,
0.0889
],
"timestamp": "2026-09-14T13:15:00Z"
},
{
"mean_share": 0.0523,
"p10_share": 0.040794000000000004,
"p25_share": 0.046547,
"p50_share": 0.051254,
"p75_share": 0.056484,
"p90_share": 0.06485199999999999,
"quantile_shares": [
0.0301,
0.0352,
0.0391,
0.0418,
0.0437,
0.0451,
0.0463,
0.0474,
0.0484,
0.0493,
0.0502,
0.0511,
0.0521,
0.0532,
0.0544,
0.0557,
0.0573,
0.0594,
0.0623,
0.0671,
0.0889
],
"timestamp": "2026-09-14T17:15:00Z"
},
{
"mean_share": 0.0534,
"p10_share": 0.041652,
"p25_share": 0.047526000000000006,
"p50_share": 0.052332000000000004,
"p75_share": 0.05767200000000001,
"p90_share": 0.066216,
"quantile_shares": [
0.0301,
0.0352,
0.0391,
0.0418,
0.0437,
0.0451,
0.0463,
0.0474,
0.0484,
0.0493,
0.0502,
0.0511,
0.0521,
0.0532,
0.0544,
0.0557,
0.0573,
0.0594,
0.0623,
0.0671,
0.0889
],
"timestamp": "2026-09-14T21:15:00Z"
}
],
"status": "ok",
"takeoff_chance_72h": 0.21
}