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

İstihbarat

GET /insights
ListInsights

Piyasalarda küresel olarak ya da tek bir varlık veya özne için neler olup bittiğine dair kısa haberler; her biri bir başlık, özet, duygu durumu (−1, 0 veya +1), etiketler, 1 ile 3 arasında önem derecesi ve ilgili varlıkları içerir. En son güncellenen önce gelir; en yeni olayları önce görmek için order_by=start_time_desc gönderin.

Parametre kuralları:

  • asset_class ve asset_id birlikte gönderin ya da hiçbirini göndermeyin.
  • subject_id, asset_id veya asset_class ile birleştirilemez.

Cüzdanla ödeme https://nebula-api.hiddensystems.ai/api/v1/x402/insights 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

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

subject_id string QUERY

/subjects veya /search tarafından döndürülen kanonik varlık dışı tanımlayıcı, örneğin text:jensen huang veya handle:elonmusk. Her durumda kabul edilir. asset_id veya asset_class ile birleştirilemez.

Example:text:jensen huang

limit integer QUERY

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

Default:10

offset integer QUERY

Atlanan sonuç sayısı.

Default:0

start_time_after string (date-time) QUERY

Yalnızca bu RFC3339 zamanından sonra başlayan öğeler. Ücretsiz planlar 90 gün geriye gider; daha fazlası 403 döndürür.

Example:2026-08-01T00:00:00Z

start_time_before string (date-time) QUERY

Yalnızca bu RFC3339 zamanından önce başlayan öğeler. Ücretsiz planlar 90 gün geriye gider; daha fazlası 403 döndürür.

Example:2026-08-07T00:00:00Z

tags array<string> QUERY

Bu etiketlerden herhangi birini taşıyan haberleri tutar, tam olarak eşleştirilir (örneğin earnings). Etiketler serbest biçimli etiketlerdir; döndürülen haberlerden okuyun. Birden fazlasını virgülle ayırarak gönderin.

Example:earnings

exclude_tags array<string> QUERY

Bu etiketlerden herhangi birini taşıyan haberleri dışarıda bırakır. Yalnızca etiketlerle eşleşir, kategoriler veya alan adlarıyla değil: kripto haberlerini dışarıda bırakmak için bunun yerine alan adlarını filtreleyin. Birden fazlasını virgülle ayırarak gönderin.

Example:rumour

categories array<string> QUERY

Birincil kategorisi bunlardan biri olan haberleri tutar, tam olarak eşleştirilir (örneğin equities veya technology). Kategoriler serbest biçimlidir; döndürülen haberlerden okuyun. Birden fazlasını virgülle ayırarak gönderin.

Example:equities

domains array<string> QUERY

Bu alan adlarından herhangi birindeki haberleri tutar. Birden fazlasını virgülle ayırarak gönderin.

Example:equities,macro

order_by string QUERY

Sonuç sıralaması. Varsayılan olarak updated_at_desc.

İzin verilen değerler
start_time_ascstart_time_descupdated_at_ascupdated_at_desccreated_at_asccreated_at_descimportance_score_ascimportance_score_desc

Default:updated_at_desc

cURL Örneği

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

insights
array<object> zorunlu

Sağlanan filtrelerle eşleşen seçilmiş istihbarat öğeleri.
insights[].category
string isteğe bağlı

Atandığında birincil istihbarat kategorisi.

insights[].domains
array<string> zorunlu

Kayda bağlı pazar veya özne alan adları.

insights[].entities
array<object> zorunlu

Bu kayda bağlı varlıklar ve varlık dışı özneler.
insights[].entities[].asset_class
string isteğe bağlı

Varlığın sınıfı, asset_id ile birlikte gönderilir.

İzin verilen değerler
equitycommodityindexcrypto
insights[].entities[].asset_id
string isteğe bağlı

Bir hisse, emtia, endeks veya coin için, varlık uç noktalarının aldığı asset_id; kişiler, hesaplar ve konular için ve Nebula'nın yerleştiremediği nadir varlıklar için yoktur.

insights[].entities[].entity_id
string zorunlu

Bağlı varlık için Nebula'nın kimliği, örneğin eq:NVDA, gecko:1 veya text:ai. Varlığı sorgulamak için aynı nesnedeki asset_id ve asset_class ya da subject_id kullanın.

insights[].entities[].entity_types
array<string> zorunlu

Bağlı varlık için bilgi grafiği sınıflandırmaları.

insights[].entities[].is_direct
boolean zorunlu

Kayıt doğrudan bu bağlı varlıkla ilgili olduğunda true.

insights[].entities[].is_primary
boolean zorunlu

Bunun kaydın birincil bağlı varlığı olduğu durumda true.

insights[].entities[].name
string zorunlu

İnsan tarafından okunabilir ad.

insights[].entities[].role
string zorunlu

Bağlı varlığın istihbarat öğesiyle ilişkisi.

insights[].entities[].subject_id
string isteğe bağlı

Bir kişi, hesap veya konu için, özne farkındalıklı uç noktaların aldığı subject_id; varlıklar için yoktur.

insights[].headline
string zorunlu

Kısa istihbarat başlığı.

insights[].importance_score
integer zorunlu

1 (düşük) ile 3 (yüksek) arasında önem derecesi.

insights[].insight_id
integer (int64) zorunlu

İstihbarat öğesi için kararlı tanımlayıcı.

insights[].sentiment_score
integer zorunlu

İşaretli duygu durumu puanı; pozitif yükseliş, negatif düşüş yönündedir.

insights[].start_time
string (date-time) isteğe bağlı

İstihbarat öğesinin veya olayın başladığı UTC zamanı.

insights[].summary
string zorunlu

İstihbarat öğesinin kanıta dayalı özeti.

insights[].tags
array<string> zorunlu

Kayda eklenen aranabilir etiketler.

insights[].updated_at
string (date-time) isteğe bağlı

Kaydın son güncellendiği UTC zamanı.

{
  "insights": [
    {
      "category": "earnings",
      "domains": [
        "equities",
        "technology"
      ],
      "entities": [
        {
          "asset_class": "equity",
          "asset_id": "NVDA",
          "entity_id": "eq:NVDA",
          "entity_types": [
            "equity"
          ],
          "is_direct": true,
          "is_primary": true,
          "name": "NVIDIA Corporation",
          "role": "primary",
          "subject_id": "text:jensen huang"
        }
      ],
      "headline": "NVIDIA raises its quarterly revenue outlook",
      "importance_score": 3,
      "insight_id": 38421,
      "sentiment_score": 1,
      "start_time": "2026-08-20T20:00:00Z",
      "summary": "Management raised guidance after stronger-than-expected data-centre demand.",
      "tags": [
        "earnings",
        "data_centres"
      ],
      "updated_at": "2026-08-07T14:35:00Z"
    }
  ]
}