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

Arama

GET /search
Arama

Varlıklar, kişiler, hesaplar ve konular arasında tek bir arama. Her sonucun kind alanı hangisi olduğunu söyler: varlıklar asset_id ve asset_class taşır, özneler ise subject_id. Yalnızca tek tarafı aramak için kind gönderin.

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

Parametreler

query string QUERY zorunlu

Aranacak metin: bir ticker, bir şirket veya coin adı, bir kişi, bir hesap ya da bir konu.

Example:NVIDIA

kind string QUERY

Sonuçları varlıklarla (hisseler, emtialar, endeksler ve kripto) veya öznelerle (kişiler, hesaplar ve konular) sınırlar. Her ikisinde de arama yapmak için bunu atlayın.

İzin verilen değerler
assetsubject

Example:asset

limit integer QUERY

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

Default:10

cURL Örneği

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/search' \
  --data-urlencode 'query=NVIDIA' \
  --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

query
string zorunlu

Çözümlenen ve geri yansıtılan serbest metin dizesi.

results
array<object> zorunlu

Sıralanmış sonuçlar, en iyiden başlayarak.
results[].asset_class
string isteğe bağlı

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

results[].asset_id
string isteğe bağlı

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).

results[].kind
string zorunlu

Sonucun ne olduğu: asset (asset_id ve asset_class ile sorgulayın) veya subject (subject_id ile sorgulayın).

İzin verilen değerler
assetsubject
results[].matched_alias
string isteğe bağlı

Sorguyla eşleşen ad veya takma ad; böylece bir aramanın neden o sonuca vardığını gösterebilirsiniz.

results[].name
string zorunlu

İnsan tarafından okunabilir ad.

results[].subject_id
string isteğe bağlı

Varlık olmayan bir kişi, hesap veya konu için kanonik tanımlayıcı.

results[].symbol
string isteğe bağlı

Görünen ticker veya piyasa sembolü.

{
  "query": "nvidia",
  "results": [
    {
      "asset_class": "equity",
      "asset_id": "NVDA",
      "kind": "asset",
      "name": "NVIDIA Corporation",
      "symbol": "NVDA"
    },
    {
      "kind": "subject",
      "matched_alias": "NVIDIA AI",
      "name": "NVIDIA AI",
      "subject_id": "handle:nvidiaai"
    }
  ]
}