Tüm belgeler Nebula belgeleri Tüm uç noktalar Etkileşimli belgeler Markdown OpenAPI JSON
  1. REST API
  2. Sorgulama

Metinden varlık ID'si

GET /assets
ListAssets

Hisse senetlerini (stoklar ve ETF'ler), emtiaları, endeksleri ve kripto varlıkları ad veya ticker ile arayın ve her varlık endpoint'inin aldığı asset_id ve asset_class değerlerini alın. Arama yapmak için query, tam eşleşme için asset_id gönderin veya en aktif varlıklara göz atmak için hiçbirini göndermeyin.

Parametre kuralları:

  • asset_id ile asset_class birlikte gönderilmelidir.
  • asset_id, query ile birleştirilemez.

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

Parametreler

asset_id string QUERY

/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

Sonuçları tek bir sınıfla sınırlar: equity (hisse senetleri ve ETF'ler), commodity, index veya crypto. asset_id gönderildiğinde zorunludur.

İzin verilen değerler
equitycommodityindexcrypto

Example:equity

query string QUERY

Genel tanımlayıcılar ve adlar üzerinde büyük/küçük harfe duyarsız arama.

Example:NVIDIA

limit integer QUERY

Döndürülen maksimum sonuç sayısı.

Default:50

offset integer QUERY

Atlanan sonuç sayısı.

Default:0

cURL Örneği

curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/assets' \
  --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

assets
array<object> zorunlu

Sağlanan keşif filtreleriyle eşleşen varlıklar.
assets[].asset_class
string zorunlu

Varlığın sınıfı: equity (hisseler ve ETF'ler), commodity, index veya crypto. Her asset kapsamlı istekte asset_id ile birlikte gönderin.

İzin verilen değerler
equitycommodityindexcrypto
assets[].asset_id
string zorunlu

Kanonik genel varlık tanımlayıcısı: hisseler, emtialar ve endeksler için ticker veya piyasa sembolü, kripto için CoinGecko slug'ı (yoksa sayısal bir id).

assets[].handle
string isteğe bağlı

Mevcut olduğunda birincil sosyal medya kullanıcı adı.

assets[].market_cap_usd
number (double) isteğe bağlı

ABD doları cinsinden en güncel piyasa değeri. Kripto için raporlanır; hisse senetleri, emtialar ve endeksler için bulunmaz.

assets[].name
string zorunlu

İnsan tarafından okunabilir ad.

assets[].price_change_24h_pct
number (double) isteğe bağlı

24 saat boyunca ham piyasa fiyatı değişimi, yüzde puan cinsinden.

assets[].price_usd
number (double) isteğe bağlı

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

assets[].symbol
string zorunlu

Görünen ticker veya piyasa sembolü.

has_more
boolean zorunlu

Döndürülen kayıtlardan sonra başka bir sayfa mevcut olduğunda true.

limit
integer zorunlu

İstenen maksimum kayıt sayısı.

offset
integer zorunlu

Atlanan eşleşen kayıt sayısı.

{
  "assets": [
    {
      "asset_class": "equity",
      "asset_id": "NVDA",
      "name": "NVIDIA Corporation",
      "price_change_24h_pct": 2.37,
      "price_usd": 182.41,
      "symbol": "NVDA"
    },
    {
      "asset_class": "commodity",
      "asset_id": "GLD",
      "name": "SPDR Gold Shares",
      "symbol": "GLD"
    },
    {
      "asset_class": "index",
      "asset_id": "SPX",
      "name": "S&P 500",
      "symbol": "SPX"
    }
  ],
  "has_more": false,
  "limit": 50,
  "offset": 0
}