Previsión de mindshare
/forecasts/mindshare
Dónde es probable que esté el mindshare de un activo en las próximas 72 horas, como un rango de resultados con sus probabilidades. series da la distribución cada 4 horas; chance_higher_72h y likely_low_share a likely_high_share resumen dónde acaba; takeoff_chance_72h es la probabilidad de un repunte repentino de la atención.
Las previsiones se actualizan en menos de un minuto desde que hay nuevas publicaciones sobre el activo, y como mínimo cada 15 minutos. refresh=true recalcula con los últimos datos en unos 5 segundos; si tarda más de 20, obtienes la última previsión con refreshed: false, cobrada a 5. Los activos sin previsión devuelven status: not_forecastable con un reason; /forecasts/assets enumera los activos que tienen una.
Cuesta 5 créditos, o 10 con refresh=true. Las respuestas de not_forecastable son gratuitas, hasta 30 por hora y cuenta; superado ese límite, este endpoint devuelve 429 hasta que se reinicie la hora.
El pago con cartera no está disponible para esta operación; usa la autenticación de cuenta. Guía de pago x402.
Parámetros
ID del activo de /assets o /search, como NVDA, GLD, SPX o bitcoin. Envíalo junto con el asset_class que se devolvió con él.
Example:NVDA
Clase del activo nombrado por asset_id: equity (acciones y ETF), commodity, index o crypto. Envía el asset_class que /assets o /search devolvió junto con el asset_id.
equitycommodityindexcrypto
Example:equity
true recalcula la previsión con los últimos datos: 10 créditos, unos 5 segundos. Por defecto es false.
Example:false
Ejemplo de 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'Respuestas
Tipo de medio application/json
as_of
Inicio en UTC de la previsión: el final de los últimos 15 minutos completos a partir de los que se calculó. Null cuando el activo nunca se ha puntuado.
chance_higher_72h
La probabilidad de que la acción esté más alta que current_share dentro de 72 horas, de 0 a 1.
current_share
La acción del activo en as_of, de 0 a 1: donde empieza cada trayectoria y el valor contra el que se miden las probabilidades.
horizon_hours
Con cuánta antelación se ejecuta el pronóstico, en horas: siempre 72.
likely_high_share
El percentil 90 de la acción dentro de 72 horas: un 90% de probabilidad de terminar por debajo.
likely_low_share
El percentil 10 de la acción dentro de 72 horas: un 90% de probabilidad de terminar por encima.
reason
Por qué no se puede pronosticar el activo: too_little_history, stale_data o missing_price. Null cuando status es ok.
too_little_historystale_datamissing_pricenull
refreshed
True cuando esta solicitud volvió a ejecutar el pronóstico (refresh=true y la re-ejecución terminó a tiempo); false cuando es el último pronóstico programado de cinco minutos.
sample_paths
24 trayectorias posibles para la acción, cada una alineada con series. Dibújalas para mostrar la dispersión de los resultados.
series
array<object>
La distribución del pronóstico cada 4 horas desde as_of: 18 pasos, del más antiguo al más reciente.
series
La distribución del pronóstico cada 4 horas desde as_of: 18 pasos, del más antiguo al más reciente.
series[].mean_share
La acción esperada en este paso.
series[].p10_share
El percentil 10 de la acción en este paso, de 0 a 1.
series[].p25_share
El percentil 25 de la acción en este paso, de 0 a 1.
series[].p50_share
El percentil 50 de la acción en este paso, de 0 a 1.
series[].p75_share
El percentil 75 de la acción en este paso, de 0 a 1.
series[].p90_share
El percentil 90 de la acción en este paso, de 0 a 1.
series[].quantile_shares
21 cuantiles de la acción en este paso: los percentiles 0, 5, 10, ... 100, del más bajo al más alto. Interpola entre ellos para obtener la probabilidad de caer en cualquier rango.
series[].timestamp
Hora UTC que pronostica el paso: as_of más 4, 8, ... 72 horas.
status
ok, o not_forecastable cuando no se puede pronosticar el activo (los campos de resumen son entonces null y la serie está vacía; reason indica por qué).
oknot_forecastable
takeoff_chance_72h
La probabilidad de un repunte repentino de la atención sobre el activo dentro de 72 horas, de 0 a 1. Null cuando no hay estimación.
{
"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
}