Stock Events

Stock Events

Stock Events API'sini kullan

Stock Events API, kendi araçlarınla Stock Events hesabındaki verileri otomatikleştirmek için sunulan bir Pro özelliğidir. Genel bir piyasa verisi veya sembol arama API'si olarak değil, hesap otomasyonu için tasarlanmıştır.

Yazma istekleri (write requests), Stock Events içinde gördüğün izleme listelerini (watchlists), sembolleri ve işlemleri doğrudan değiştirir.

API ile neler yapabilirsin?

  • İzleme listelerini listeleyebilir, oluşturabilir, geri çağırabilir ve güncelleyebilirsin.
  • Bir izleme listesindeki sembolleri listeleyebilir, ekleyebilir, güncelleyebilir ve kaldırabilirsin.
  • İşlemleri listeleyebilir, oluşturabilir, geri çağırabilir, güncelleyebilir ve silebilirsin.
  • Hesaplanmış Holdings (Varlıklar) ve Dividends (Temettüler) görünümlerini okuyabilirsin.

API anahtarı nasıl oluşturulur?

API anahtarlarını oluşturmak ve kullanmak için aktif bir Stock Events Pro aboneliği gereklidir.

  1. Stock Events web uygulamasına giriş yap.
  2. Profiline git.
  3. Ayarlar kısmını seç.
  4. başlığı altında, Veri seçeneğine tıkla.
  5. API Anahtarları kısmını seç.
  6. API anahtarı oluştur seçeneğine tıkla.
  7. Tanımlayıcı bir İsim gir ve ardından Oluştur butonuna bas.
  8. API anahtarını kopyala seçeneğini seç ve pencereyi kapatmadan önce anahtarı güvenli bir yere kaydet.

Tam API anahtarı sadece bir kez gösterilir. Pencereyi kapattıktan sonra, API Anahtarları ekranında tam anahtar yerine sadece anahtarın adı, ön eki, oluşturulma tarihi ve son kullanım tarihi görünür.

Eğer Pro aboneliğin pasif hale gelirse, anahtarların hesabına bağlı kalmaya devam eder ancak Pro erişimin tekrar aktif olana kadar API istekleri 403 Forbidden hatası döndürür.

İlk isteğini gönder

API temel URL'si https://stockevents.app/api/v1 adresidir. API anahtarını Authorization başlığında bir bearer token olarak gönder.

curl -H "Authorization: Bearer $STOCK_EVENTS_API_KEY" \    https://stockevents.app/api/v1/watchlists

Bu istek, izleme listelerini ve onların ID'lerini döndürür. İzleme listesine özel sembol, Holdings ve Dividends uç noktalarında (endpoints) bir izleme listesi ID'si kullanabilirsin.

İstek alanları, yanıt yapıları, isteğe bağlı parametreler ve mevcut tüm uç noktalar için şu kaynakları kullanabilirsin:

API anahtarını güvende tut

API anahtarını bir şifre gibi düşün. Onu kaynak kontrol sistemlerine (source control) ekleme, halka açık istemci kodlarında paylaşma veya bir sorgu parametresi ya da istek gövdesi (request body) içinde gönderme.

API anahtarları, her anahtar için ayrı izinler gerektirmeden hesap otomasyon API'sini doğrular. Onları sadece güvendiğin araçlarla kullan.

Eğer bir anahtar ifşa olursa, API Anahtarları kısmına dön, API anahtarını iptal et seçeneğini seç ve ardından İptal Et diyerek onayla. Anahtar anında çalışmayı durdurur ve tekrar aktif edilemez. Gerekirse yeni bir anahtar oluştur.

Sık karşılaşılan hatalar

  • 401 Unauthorized: API anahtarı eksik, geçersiz veya iptal edilmiş.
  • 403 Forbidden: Hesabın şu anda aktif bir Pro erişimi bulunmuyor.