Tutta la documentazione Documentazione di Nebula Tutti gli endpoint Documentazione interattiva Markdown JSON OpenAPI
  1. API REST
  2. Previsioni

Asset prevedibili

GET /forecasts/assets
ListForecastAssets

Tutti gli asset con una previsione al momento. L'elenco copre sia /forecasts/mindshare sia /forecasts/sentiment, che prevedono gli stessi asset: passa asset_id e asset_class di un asset a uno dei due. Azioni, materie prime e indici vengono prima, poi le criptovalute, dal più discusso. L'elenco si aggiorna ogni cinque minuti.

Pagamento con wallet disponibile su https://nebula-api.hiddensystems.ai/api/v1/x402/forecasts/assets. Non sono richiesti un account Nebula o una chiave API; controlla l'offerta di pagamento prima di firmare. Guida al pagamento x402.

Parametri

asset_class string QUERY

Limita l'elenco a una sola classe: equity (azioni ed ETF), commodity, index o crypto.

Valori consentiti
equitycommodityindexcrypto

Example:equity

limit integer QUERY

Numero massimo di risultati restituiti.

Default:100

offset integer QUERY

Numero di risultati saltati.

Default:0

Esempio cURL

curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/forecasts/assets' \
  --header 'X-API-Key: YOUR_API_KEY'

Risposte

200 OK
400 Richiesta non valida
401 Non autorizzato
402 Crediti esauriti; la risposta include i tempi di rinnovo e il saldo dei crediti acquistati
403 Vietato
404 Non trovato
405 Metodo non consentito; l'header Allow elenca il metodo supportato
429 Troppe richieste
500 Errore interno del server
503 Servizio non disponibile

Tipo di media application/json

assets
array<object> obbligatorio

Asset con una previsione corrente: prima azioni, materie prime e indici, poi criptovalute; dal più discusso all'interno di ciascuna classe.
assets[].as_of
string (date-time) obbligatorio

Inizio UTC della previsione corrente dell'asset: la fine degli ultimi 15 minuti completi su cui è stata calcolata.

assets[].asset_class
string obbligatorio

La classe dell'asset: equity (azioni ed ETF), commodity, index o crypto. Va inviata con asset_id in ogni richiesta con ambito asset.

Valori consentiti
equitycommodityindexcrypto
assets[].asset_id
string obbligatorio

Identificatore pubblico canonico dell'asset: il ticker o simbolo di mercato per azioni, commodity e indici, e lo slug CoinGecko (o, in mancanza, un id numerico) per le crypto.

assets[].name
string obbligatorio

Nome leggibile.

assets[].symbol
string obbligatorio

Ticker o simbolo di mercato visualizzato.

has_more
boolean obbligatorio

True quando è disponibile un'altra pagina dopo i record restituiti.

limit
integer obbligatorio

Numero massimo di record richiesti.

offset
integer obbligatorio

Numero di record corrispondenti saltati.

total
integer obbligatorio

Quanti asset corrispondono alla richiesta su tutte le pagine.

{
  "assets": [
    {
      "as_of": "2026-09-14T14:15:00Z",
      "asset_class": "equity",
      "asset_id": "NVDA",
      "name": "NVIDIA Corporation",
      "symbol": "NVDA"
    },
    {
      "as_of": "2026-09-14T14:15:00Z",
      "asset_class": "equity",
      "asset_id": "TSLA",
      "name": "Tesla, Inc.",
      "symbol": "TSLA"
    },
    {
      "as_of": "2026-09-14T14:15:00Z",
      "asset_class": "equity",
      "asset_id": "AMZN",
      "name": "Amazon.com, Inc.",
      "symbol": "AMZN"
    }
  ],
  "has_more": true,
  "limit": 100,
  "offset": 0,
  "total": 3206
}