Takvim etkinlikleri
/calendar-events
Yaklaşan ve geçmiş piyasa olayları (bilanço açıklamaları, ekonomik veri açıklamaları, halka arzlar, borsaya kote olmalar, oylamalar, duruşmalar); küresel olarak veya tek bir varlık ya da konu için; tür, durum, 1 ile 3 arasında önem derecesi ve ilgili varlıklarla birlikte. Varsayılan olarak bugünden itibaren, en erken önce gelecek şekilde; yalnızca dikkate değer olanlar için min_importance_score=2 gönderin.
Parametre kuralları:
asset_classveasset_idbirlikte gönderin ya da hiçbirini göndermeyin.subject_id,asset_idveyaasset_classile birleştirilemez.
Cüzdanla ödeme https://nebula-api.hiddensystems.ai/api/v1/x402/calendar-events adresinde kullanılabilir. Nebula hesabı veya API anahtarı gerekmez; imzalamadan önce ödeme teklifini kontrol edin. x402 ödeme kılavuzu.
Parametreler
/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_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.
equitycommodityindexcrypto
Example:equity
/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
Döndürülen maksimum sonuç sayısı.
Default:50
Atlanan sonuç sayısı.
Default:0
Yalnızca bu RFC3339 zamanından sonra başlayan olaylar. Ücretsiz planlar 90 gün geriye gidebilir; daha fazlası 403 döndürür.
Example:2026-08-01T00:00:00Z
Yalnızca bu RFC3339 zamanından önce başlayan olaylar. Ücretsiz planlar 90 gün geriye gidebilir; daha fazlası 403 döndürür.
Example:2026-08-07T00:00:00Z
Olayları bu alan adlarından herhangi birinde tutun. Birden fazlasını virgülle ayırarak gönderin.
Example:equities,macro
Olayları bu türlerden herhangi birinde tutun. Birden fazlasını virgülle ayırarak gönderin.
Example:earnings,economic_release
Olayları bu durumlardan herhangi birinde tutun. Birden fazlasını virgülle ayırarak gönderin.
Example:scheduled,postponed
1 (düşük) ile 3 (yüksek) arasında minimum önem derecesi. Varsayılan 1'dir ve tüm olayları kapsar.
Default:1
cURL Örneği
curl --request GET \
--url 'https://nebula-api.hiddensystems.ai/api/v1/public/calendar-events' \
--header 'X-API-Key: YOUR_API_KEY'Yanıtlar
Medya türü application/json
calendar_events
array<object>
Sağlanan filtrelerle eşleşen takvim olayları.
calendar_events
Sağlanan filtrelerle eşleşen takvim olayları.
calendar_events[].calendar_event_id
Takvim olayı için kalıcı genel tanımlayıcı.
calendar_events[].confidence_score
Olayın güvenilirliği, 1 (düşük) ile 10 (yüksek) arasında.
calendar_events[].created_at
Kaydın oluşturulduğu UTC zamanı.
calendar_events[].domains
Kayda bağlı pazar veya özne alan adları.
calendar_events[].end_time
Bilindiğinde UTC olay bitiş zamanı.
calendar_events[].entities
array<object>
Bu kayda bağlı varlıklar ve varlık dışı özneler.
calendar_events[].entities
Bu kayda bağlı varlıklar ve varlık dışı özneler.
calendar_events[].entities[].asset_class
Varlığın sınıfı, asset_id ile birlikte gönderilir.
equitycommodityindexcrypto
calendar_events[].entities[].asset_id
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.
calendar_events[].entities[].confidence
Mevcut olduğunda varlık bağlantısı güvenilirliği.
calendar_events[].entities[].entity_id
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.
calendar_events[].entities[].is_primary
Bunun kaydın birincil bağlı varlığı olduğu durumda true.
calendar_events[].entities[].name
İnsan tarafından okunabilir ad.
calendar_events[].entities[].role
Bağlantılı varlığın takvim olayıyla ilişkisi.
calendar_events[].entities[].subject_id
Bir kişi, hesap veya konu için, özne farkındalıklı uç noktaların aldığı subject_id; varlıklar için yoktur.
calendar_events[].event_metadata
Olay türüne özgü yapılandırılmış üst veri. Anahtarlar olay türüne göre değişir.
calendar_events[].event_subtype
Mevcut olduğunda daha spesifik olay sınıflandırması.
calendar_events[].event_type
Üst düzey olay sınıflandırması.
calendar_events[].importance_score
1 (düşük) ile 3 (yüksek) arasında önem derecesi.
calendar_events[].location
Bir yer bilindiğinde olayın fiziksel olarak gerçekleştiği yer. Çevrimiçi ve zincir üstü olaylarda bulunmaz.
calendar_events[].long_term_impact_score
Tahmini uzun vadeli piyasa etkisi, 1 (düşük) ile 3 (yüksek) arasında.
calendar_events[].macro_impact_score
Tahmini makroekonomik etki, 1 (düşük) ile 3 (yüksek) arasında.
calendar_events[].price_impact_score
Tahmini doğrudan fiyat etkisi, 1 (düşük) ile 3 (yüksek) arasında.
calendar_events[].short_term_impact_score
Tahmini kısa vadeli piyasa etkisi, 1 (düşük) ile 3 (yüksek) arasında.
calendar_events[].source_count
Olayı destekleyen kaynak sayısı.
calendar_events[].sources
array<object>
Üst yanıtı destekleyen kaynak kayıtları.
calendar_events[].sources
Üst yanıtı destekleyen kaynak kayıtları.
calendar_events[].sources[].external_id
Harici kaynak tarafından atanan tanımlayıcı.
calendar_events[].sources[].provider
Mevcut olduğunda üst veri sağlayıcısı.
calendar_events[].sources[].published_at
UTC yayın zamanı.
calendar_events[].sources[].publisher
Mevcut olduğunda orijinal yayıncı.
calendar_events[].sources[].source
Kaynak platformu veya akışı.
calendar_events[].sources[].subtype
Kaynak alt türü.
calendar_events[].sources[].trusted
Kaynağın güvenilir olarak sınıflandırılıp sınıflandırılmadığı.
calendar_events[].sources[].url
Mevcut olduğunda genel kaynak URL'si.
calendar_events[].start_time
İstihbarat öğesinin veya olayın başladığı UTC zamanı.
calendar_events[].status
Olayın mevcut yaşam döngüsü durumu: scheduled, tentative, cancelled veya postponed.
calendar_events[].summary
İstihbarat öğesinin kanıta dayalı özeti.
calendar_events[].tags
Kayda eklenen aranabilir etiketler.
calendar_events[].tail_risk_impact_score
Tahmini kuyruk riski etkisi, 1 (düşük) ile 3 (yüksek) arasında.
calendar_events[].time_precision
Yayımlanan olay zamanının hassasiyeti: dakika, saat, gün, hafta, ay, yıl veya bilinmiyor. Gün hassasiyetli bir olay o günün 00:00 UTC saatinde başlar.
calendar_events[].title
İnsan tarafından okunabilir olay başlığı.
calendar_events[].trusted_source_count
Güvenilir olarak işaretlenmiş destekleyici kaynak sayısı.
calendar_events[].updated_at
Kaydın son güncellendiği UTC zamanı.
{
"calendar_events": [
{
"calendar_event_id": "earnings:nvda:2026-q3",
"confidence_score": 9,
"created_at": "2026-08-06T10:00:00Z",
"domains": [
"equities",
"technology"
],
"end_time": "2026-08-20T21:00:00Z",
"entities": [
{
"asset_class": "equity",
"asset_id": "NVDA",
"confidence": 0.98,
"entity_id": "eq:NVDA",
"is_primary": true,
"name": "NVIDIA Corporation",
"role": "affected",
"subject_id": "text:jensen huang"
}
],
"event_metadata": {
"fiscal_quarter": "Q3",
"fiscal_year": 2026
},
"event_subtype": "quarterly_results",
"event_type": "earnings",
"importance_score": 3,
"location": "Santa Clara, California",
"long_term_impact_score": 2,
"macro_impact_score": 1,
"price_impact_score": 3,
"short_term_impact_score": 3,
"source_count": 4,
"sources": [
{
"external_id": "0001045810-26-000123",
"provider": "SEC EDGAR",
"published_at": "2026-08-07T14:30:00Z",
"publisher": "NVIDIA Corporation",
"source": "sec",
"subtype": "filing",
"trusted": true,
"url": "https://www.sec.gov/Archives/edgar/data/1045810/example.htm"
}
],
"start_time": "2026-08-20T20:00:00Z",
"status": "scheduled",
"summary": "Management raised guidance after stronger-than-expected data-centre demand.",
"tags": [
"earnings",
"data_centres"
],
"tail_risk_impact_score": 1,
"time_precision": "exact",
"title": "NVIDIA Q3 2026 earnings",
"trusted_source_count": 3,
"updated_at": "2026-08-07T14:35:00Z"
}
]
}