Fiyat geçmişi

GET /price-history

GetPriceHistory

Bir varlığın zaman içindeki fiyatı; sosyal verileriyle karşılaştırmak için okunur. Endeks değerleri endeks puanı cinsindendir. Bir kripto varlığın borsa mumu yoksa, high_usd ve low_usd son 24 saatlik aralıktır.

Cüzdanla ödeme https://nebula-api.hiddensystems.ai/api/v1/x402/price-history adresinde kullanılabilir. Nebula hesabı veya API anahtarı gerekmez; imzalamadan önce ödeme teklifini kontrol edin. x402 ödeme kılavuzu.

Parametreler

asset_id string QUERY zorunlu

/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_class string QUERY zorunlu

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.

İzin verilen değerler

equitycommodityindexcrypto

Example:equity

hours integer QUERY

Saat cinsinden geriye dönük pencere. Ücretsiz planlar 90 güne kadar erişebilir; daha fazlası 403 döndürür.

Default:168

granularity string QUERY

İstenen zaman serisi kova boyutu. Atlanırsa, hizmet geriye dönük pencereye uygun bir kova boyutu seçer.

İzin verilen değerler

1h2h4h12h1d

Example:1h

cURL Örneği

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'

Yanıtlar

200 OK

400 Hatalı İstek

401 Yetkisiz

402 Krediler tükendi; yanıt, yenileme zamanlamasını ve satın alınan kredi bakiyesini içerir

403 Yasak

404 Bulunamadı

405 Yönteme izin verilmiyor; Allow başlığı desteklenen yöntemi listeler

429 Çok Fazla İstek

500 Sunucu İçi Hata

503 Hizmet Kullanılamıyor

Medya türü application/json

series

array<object> zorunlu

Kronolojik olarak sıralanmış gözlemler.

series[].high_usd

number (double) isteğe bağlı

Gözlemlenen en yüksek fiyat, ABD doları cinsinden.

series[].low_usd

number (double) isteğe bağlı

Gözlemlenen en düşük fiyat, ABD doları cinsinden.

series[].price_usd

number (double) isteğe bağlı

En güncel veya gözlemlenen piyasa fiyatı, ABD doları cinsinden.

series[].timestamp

string (date-time) zorunlu

Gözlem veya kova başlangıcı için UTC RFC 3339 zaman damgası.

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