Storico dei prezzi

GET /price-history

GetPriceHistory

Prezzo di un asset nel tempo, da leggere insieme ai suoi dati social. I valori dell'indice sono in punti indice. Quando un asset crypto non ha candele di exchange, high_usd e low_usd sono l'intervallo delle ultime 24 ore.

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

Parametri

asset_id string QUERY obbligatorio

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

asset_class string QUERY obbligatorio

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.

Valori consentiti

equitycommodityindexcrypto

Example:equity

hours integer QUERY

Finestra di lookback in ore. I piani gratuiti risalgono fino a 90 giorni; oltre viene restituito 403.

Default:168

granularity string QUERY

Dimensione del bucket della serie temporale richiesta. Se omessa, il servizio sceglie una dimensione del bucket adeguata alla finestra di lookback.

Valori consentiti

1h2h4h12h1d

Example:1h

Esempio cURL

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/price-history' \
  --data-urlencode 'asset_id=NVDA' \
  --data-urlencode 'asset_class=equity' \
  --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

series

array<object> obbligatorio

Osservazioni ordinate cronologicamente.

series[].high_usd

number (double) opzionale

Prezzo massimo osservato in dollari statunitensi.

series[].low_usd

number (double) opzionale

Prezzo minimo osservato in dollari statunitensi.

series[].price_usd

number (double) opzionale

Prezzo di mercato più recente o osservato in dollari statunitensi.

series[].timestamp

string (date-time) obbligatorio

Timestamp UTC in formato RFC 3339 per l'osservazione o l'inizio del bucket.

{
  "series": [
    {
      "high_usd": 184.17,
      "low_usd": 179.82,
      "price_usd": 182.41,
      "timestamp": "2026-08-07T15:00:00Z"
    }
  ]
}