FinansAPI
Genel dokümantasyon
Sunulan API türleri, veri modeli özeti, kullanım sınırları ve tipik entegrasyon senaryoları. Teknik istek örnekleri ve anahtarınızla deneme için giriş yapın ve müşteri panelindeki API dokümantasyonu sayfasını kullanın.
Sunulan API çeşitleri
Aynı piyasa verisi farklı entegrasyon ihtiyaçları için iki ana kanaldan sunulur:
REST (HTTP)
GET /v1/fiyatlar ile anlık özet JSON alırsınız. Sunucu taraflı, mobil ve batch işler için uygundur; tek yanıtta tüm kategoriler ve semboller yer alır.
Canlı akış (Socket.io)
Tarayıcı ve gerçek zamanlı uygulamalar için prices olayı üzerinden güncel fiyatlar paketi yayınlanır. Bağlantı API anahtarı ile doğrulanır.
API’de sağlanan veriler
Yanıt gövdesinde üst düzey bir fiyatlar nesnesi bulunur. Yapı kabaca şöyledir:
- Kategoriler: Her üst anahtar bir piyasa grubudur (ör. döviz, maden, gram altın). Kaynakta grup bilgisi yoksa semboller
DIGERaltında toplanabilir. - Semboller: Kategori altında sembol adı →
bid(alış),ask(satış), isteğe bağlıtimestamp. - Meta:
guncellendialanı paketin son güncellenme zamanını (ms) gösterir.
Tek sembol için ayrı bir REST uç noktası yoktur; istemci tarafında JSON içinden ilgili kategori ve sembol seçilir. Detaylı kod örnekleri paneldeki teknik dokümantasyondadır.
Rate limit ve güvenlik
Her müşteri hesabına atanmış API anahtarı için saniyede istek üst sınırı (rate limit) uygulanır; değer yönetim panelinden hesaba göre yapılandırılır. Limit aşıldığında 429 Too Many Requests dönebilirsiniz.
İsteğe bağlı olarak IP adresi ve alan adı allowlist ile anahtarınızın yalnızca belirttiğiniz ortamlardan kullanılması kısıtlanabilir.
Anahtar süresi dolduğunda veya pasifleştirildiğinde erişim reddedilir (403).
Kullanım alanları
- Perakende ve kurumsal fiyat ekranları, mobil uygulamalar
- İç panolar, operasyon ve treasury raporları
- ERP ve back-office entegrasyonları
- Medya ve yayın (ticker, canlı grafik beslemesi)
- Otomasyon, bot ve arka plan servisleri
Teknik entegrasyon ve örnek kod
cURL, Node, Python ve yanıt gövdesi ayrıntıları müşteri panelindeki API dokümantasyonu sayfasında yer alır (giriş gerekir). Socket.io bağlantı örnekleri de orada toplanmıştır.