Mindshare tahmini
/forecasts/mindshare
Bir varlığın mindshare değerinin önümüzdeki 72 saat içinde muhtemelen nerede olacağı; olasılıklarıyla birlikte bir sonuç aralığı olarak. series dağılımı her 4 saatte bir verir; chance_higher_72h ve likely_low_share ile likely_high_share nereye oturacağını özetler; takeoff_chance_72h dikkatte ani bir artış olasılığıdır.
Tahminler, varlıkla ilgili yeni gönderilerden sonra bir dakika içinde ve en az 15 dakikada bir güncellenir. refresh=true, en güncel veriler üzerinde yaklaşık 5 saniyede yeniden hesaplar; bu 20 saniyeyi aşarsa, refreshed: false ile en güncel tahmini alırsınız ve 5 kredi ücretlendirilir. Tahmini olmayan varlıklar reason ile birlikte status: not_forecastable döndürür; /forecasts/assets tahmini olan varlıkları listeler.
5 kredi, refresh=true ile 10 kredi tutar. not_forecastable yanıtları ücretsizdir, hesap başına saatte 30'a kadar; bunun ötesinde bu uç nokta saat sıfırlanana kadar 429 döndürür.
Bu işlem için cüzdan ödemesi kullanılamaz; hesap kimlik doğrulamasını kullanın. x402 ödeme kılavuzu.
Parametreler
/assets veya /search'ten alınan varlık ID'si; örneğin NVDA, GLD, SPX veya bitcoin. Yanında döndürülen asset_class ile birlikte gönderin.
Example:NVDA
asset_id ile adlandırılan varlığın sınıfı: equity (hisseler ve ETF'ler), commodity, index veya crypto. /assets veya /search'ün asset_id ile birlikte döndürdüğü asset_class'ı gönderin.
equitycommodityindexcrypto
Example:equity
true, tahmini en güncel veriler üzerinde yeniden hesaplar: 10 kredi, yaklaşık 5 saniye. Varsayılan olarak false.
Example:false
cURL Örneği
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'Yanıtlar
Medya türü application/json
as_of
Tahminin UTC başlangıcı: hesaplandığı son tam 15 dakikalık dilimin bitişi. Varlık hiç puanlanmadıysa null.
chance_higher_72h
Payın 72 saat içinde current_share'den yüksek olma olasılığı, 0 ile 1 arasında.
current_share
Varlığın as_of anındaki payı, 0 ile 1 arasında: her yolun başladığı yer ve olasılıkların kendisine göre ölçüldüğü değer.
horizon_hours
Tahminin ne kadar ileriye gittiği, saat cinsinden: her zaman 72.
likely_high_share
Payın 72 saat içindeki 90. yüzdelik dilimi: altında bitme olasılığı %90.
likely_low_share
Payın 72 saat içindeki 10. yüzdelik dilimi: üstünde bitme olasılığı %90.
reason
Varlığın neden tahmin edilemediği: too_little_history, stale_data veya missing_price. status ok olduğunda null.
too_little_historystale_datamissing_pricenull
refreshed
Bu istek tahmini yeniden çalıştırdığında true (refresh=true ve yeniden çalıştırma zamanında tamamlandığında); en son planlanmış beş dakikalık tahmin olduğunda false.
sample_paths
Pay için 24 olası yol; her biri series ile hizalıdır. Sonuçların dağılımını göstermek için bunları çizin.
series
array<object>
as_of anından itibaren her 4 saatte bir tahmin dağılımı: 18 adım, en eskisi ilk.
series
as_of anından itibaren her 4 saatte bir tahmin dağılımı: 18 adım, en eskisi ilk.
series[].mean_share
Bu adımdaki beklenen pay.
series[].p10_share
Bu adımdaki payın 10. yüzdelik dilimi, 0 ile 1 arasında.
series[].p25_share
Bu adımdaki payın 25. yüzdelik dilimi, 0 ile 1 arasında.
series[].p50_share
Bu adımdaki payın 50. yüzdelik dilimi, 0 ile 1 arasında.
series[].p75_share
Bu adımdaki payın 75. yüzdelik dilimi, 0 ile 1 arasında.
series[].p90_share
Bu adımdaki payın 90. yüzdelik dilimi, 0 ile 1 arasında.
series[].quantile_shares
Bu adımdaki payın 21 kantili: 0., 5., 10., ... 100. yüzdelik dilimler, en düşük ilk. Herhangi bir aralığa düşme olasılığı için bunların arasında interpolasyon yapın.
series[].timestamp
Adımın tahmin ettiği UTC zamanı: as_of artı 4, 8, ... 72 saat.
status
ok veya varlık tahmin edilemediğinde not_forecastable (bu durumda özet alanları null olur ve series boş kalır; reason nedeni söyler).
oknot_forecastable
takeoff_chance_72h
Varlığa yönelik ilginin 72 saat içinde ani bir şekilde artma olasılığı, 0 ile 1 arasında. Tahmin yoksa 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
}