マインドシェア予測
/forecasts/mindshare
今後72時間で資産の mindshare がどこに落ち着く可能性が高いかを、結果の範囲とその確率として示します。series は4時間ごとの分布を返し、chance_higher_72h と likely_low_share から likely_high_share は落ち着く先を要約し、takeoff_chance_72h は注目が急上昇する確率です。
予測は資産に関する新しい投稿から1分以内に、少なくとも15分ごとに更新されます。refresh=true は最新データで約5秒で再計算します。20秒を超える場合は、最新の予測を refreshed: false 付きで受け取り、5クレジットが課金されます。予測がない資産は status: not_forecastable と reason を返します。予測がある資産の一覧は /forecasts/assets にあります。
5クレジット、refresh=true を付けると10クレジットです。not_forecastable の回答は無料で、アカウントごとに1時間あたり30件までです。それを超えると、時間が明けるまでこのエンドポイントは429を返します。
このオペレーションではウォレット支払いを利用できません。アカウント認証を使用してください。x402 支払いガイド。
パラメータ
/assets または /search で取得したアセット ID（NVDA、GLD、SPX、bitcoin など）。一緒に返された asset_class とともに送信してください。
Example:NVDA
asset_id で指定されたアセットのクラス: equity（株式および ETF）、commodity、index、crypto のいずれか。/assets または /search が asset_id とともに返した asset_class を送信してください。
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
72時間後にこの銘柄のシェアがcurrent_shareを上回る確率（0〜1）。
current_share
as_of時点の資産のシェア（0〜1）。すべてのパスはここから始まり、確率はこの値を基準に測られます。
horizon_hours
予測がどこまで先まで及ぶかを時間で表したもの。常に72です。
likely_high_share
72時間後のシェアの90パーセンタイル。これを下回って終わる確率が90%です。
likely_low_share
72時間後のシェアの10パーセンタイル。これを上回って終わる確率が90%です。
reason
この資産を予測できない理由。too_little_history、stale_data、missing_price のいずれかです。status が ok のときは null になります。
too_little_historystale_datamissing_pricenull
refreshed
このリクエストが予測を再実行した場合（refresh=true で再実行が時間内に完了した場合）は true、直近の定時5分予測である場合は false です。
sample_paths
シェアの24通りのパス。それぞれが series に対応します。これらを描画すると、結果のばらつきを確認できます。
series
array<object>
as_of から4時間ごとの予測分布。18ステップで、古い順です。
series
as_of から4時間ごとの予測分布。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 です（その場合、summary のフィールドは 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
}