Previsione di mindshare
/forecasts/mindshare
Dove è probabile che si trovi il mindshare di un asset nelle prossime 72 ore, come intervallo di esiti con le relative probabilità. series fornisce la distribuzione ogni 4 ore; chance_higher_72h e likely_low_share a likely_high_share riassumono dove si colloca; takeoff_chance_72h è la probabilità di un'improvvisa impennata dell'attenzione.
Le previsioni si aggiornano entro un minuto dalla pubblicazione di nuovi post sull'asset e almeno ogni 15 minuti. refresh=true ricalcola sui dati più recenti in circa 5 secondi; se impiega più di 20, ricevi la previsione più recente con refreshed: false, al costo di 5. Gli asset senza previsione restituiscono status: not_forecastable con un reason; /forecasts/assets elenca gli asset che ne hanno una.
Costa 5 crediti, o 10 con refresh=true. Le risposte not_forecastable sono gratuite, fino a 30 all'ora per account; oltre tale soglia questo endpoint restituisce 429 fino al cambio dell'ora.
Il pagamento tramite wallet non è disponibile per questa operazione; usa l'autenticazione dell'account. guida al pagamento x402.
Parametri
Asset ID da /assets o /search, ad esempio NVDA, GLD, SPX o bitcoin. Va inviato con l'asset_class restituito insieme ad esso.
Example:NVDA
Classe dell'asset indicato da asset_id: equity (azioni ed ETF), commodity, index o crypto. Va inviata l'asset_class restituita da /assets o /search insieme all'asset_id.
equitycommodityindexcrypto
Example:equity
true ricalcola la previsione sui dati più recenti: 10 crediti, circa 5 secondi. Il valore predefinito è false.
Example:false
Esempio 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'Risposte
Tipo di media application/json
as_of
Inizio UTC della previsione: la fine degli ultimi 15 minuti completi su cui è stata calcolata. Null quando l'asset non è mai stato valutato.
chance_higher_72h
La probabilità che la quota sia superiore a current_share tra 72 ore, da 0 a 1.
current_share
La quota dell'asset ad as_of, da 0 a 1: il punto da cui parte ogni percorso e il valore rispetto al quale si misurano le probabilità.
horizon_hours
Quanto avanti si spinge la previsione, in ore: sempre 72.
likely_high_share
Il 90° percentile della quota tra 72 ore: il 90% di probabilità di chiudere al di sotto.
likely_low_share
Il 10° percentile della quota tra 72 ore: il 90% di probabilità di chiudere al di sopra.
reason
Perché l'asset non può essere previsto: too_little_history, stale_data o missing_price. Null quando status è ok.
too_little_historystale_datamissing_pricenull
refreshed
True quando questa richiesta ha rieseguito la previsione (refresh=true e la riesecuzione è terminata in tempo); false quando è l'ultima previsione pianificata ogni cinque minuti.
sample_paths
24 percorsi possibili per la quota, ciascuno allineato con series. Tracciali per mostrare l'ampiezza degli esiti.
series
array<object>
La distribuzione prevista ogni 4 ore da as_of: 18 passi, dal più vecchio.
series
La distribuzione prevista ogni 4 ore da as_of: 18 passi, dal più vecchio.
series[].mean_share
La quota attesa a questo passo.
series[].p10_share
Il 10° percentile della quota a questo passo, da 0 a 1.
series[].p25_share
Il 25° percentile della quota a questo passo, da 0 a 1.
series[].p50_share
Il 50° percentile della quota a questo passo, da 0 a 1.
series[].p75_share
Il 75° percentile della quota a questo passo, da 0 a 1.
series[].p90_share
Il 90° percentile della quota a questo passo, da 0 a 1.
series[].quantile_shares
21 quantili della quota a questo passo: i percentili 0, 5, 10, ... 100, dal più basso. Interpola tra loro per ottenere la probabilità di ricadere in un qualsiasi intervallo.
series[].timestamp
Ora UTC prevista dal passo: as_of più 4, 8, ... 72 ore.
status
ok, oppure not_forecastable quando l'asset non può essere previsto (i campi di riepilogo sono allora null e la serie è vuota; reason ne indica il motivo).
oknot_forecastable
takeoff_chance_72h
La probabilità di un'improvvisa impennata dell'attenzione sull'asset entro 72 ore, da 0 a 1. Null quando non c'è una stima.
{
"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
}