關注度預測
/forecasts/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 點額度，加上 refresh=true 則為 10 點。not_forecastable 的回應免費，每個帳號每小時最多 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
當此請求重新執行預測時為 true（refresh=true 且重新執行及時完成）；若為最新的排程五分鐘預測則為 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（此時摘要欄位為 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
}