Hasfiyat Altın API nedir?

Hasfiyat Altın API, Harem Altın başta olmak üzere 11 canlı veri kaynağından gerçek zamanlı altın, döviz ve parite fiyatlarını tek bir merkezden dağıtan bir fiyat altyapısıdır. Has altın, gram altın, çeyrek, yarım, tam altın, ons, USD/TRY ve EUR/TRY gibi onlarca sembolü WebSocket (Socket.IO) ile anlık, REST API ile de istediğiniz an sorgulayarak alabilirsiniz. Kuyumcu vitrin ekranları, e-ticaret siteleri, mobil uygulamalar ve fiyat otomasyonu kuran yazılım ekipleri için tasarlanmıştır; entegrasyon dakikalar içinde tamamlanır.

Hangi veri kaynaklarını destekliyorsunuz?

Harem Altın, Hakan Altın, Mayda Gold, Myakche, Metal Altın, Nadir Döviz, Anlık Altın, Sağlamoğlu Altın, Fikri Şahin, Harem V3 ve Hasfiyat Döviz dahil 11 canlı kaynak desteklenir. Paketinize göre birden fazla kaynağı aynı anda kullanabilir ve kaynak önceliği belirleyebilirsiniz; öncelikli kaynak kesintiye uğradığında sistem otomatik olarak bir sonraki kaynağa geçerek fiyat akışınızı kesintisiz tutar. Böylece tek bir sağlayıcıya bağımlı kalmadan yüksek erişilebilirlikle çalışır, en güncel ve tutarlı altın fiyatını sürekli elde edersiniz.

REST API mi yoksa WebSocket mi kullanmalıyım?

İki erişim yöntemi de tek panelden yönetilir ve aynı anda kullanılabilir. Vitrin ekranı, tabela ve mobil uygulama gibi fiyatın saniye saniye güncellenmesi gereken yerlerde Socket.IO (WebSocket) önerilir; bağlantı açık kaldığı sürece her değişiklik anlık olarak size iletilir ve sürekli sorgu yapmanıza gerek kalmaz. Periyodik raporlama, sunucu taraflı entegrasyonlar ve e-ticaret ürün fiyatı güncelleme gibi senaryolarda ise REST API daha pratiktir. Çoğu müşterimiz ikisini birlikte kullanır: anlık akış için WebSocket, doğrulama ve toplu işlemler için REST.

Fiyatlar ne kadar günceldir?

Fiyatlar kaynaktan alındığı anda işlenir ve milisaniye mertebesinde gecikmeyle dağıtılır. WebSocket bağlantısında piyasadaki her değişiklik bağlantınıza anlık olarak iletilir; sürekli sorgu (polling) yaparak sunucuyu yormanıza gerek kalmaz. REST API üzerinden yapılan her istek de o anki en güncel fiyatı döndürür. Ayrıca her sembolün son güncellenme zamanı (timestamp) yanıt içinde yer aldığından, verinin tazeliğini kendi tarafınızda da kolayca denetleyebilirsiniz.

Pazaryeri ve e-ticaret entegrasyonu var mı?

Evet. Trendyol, Hepsiburada, N11, Amazon, Çiçeksepeti, Pazarama, Ticimax, İkas, IdeaSoft, T-Soft, Shopify, WooCommerce, Magento, OpenCart ve PrestaShop dahil 15 platforma altın ürün fiyatlarınız canlı kura göre otomatik olarak gönderilir. Gramaj × emtia mantığıyla her ürünün ağırlığına göre fiyat hesaplanır; alış/satış marjı, güvenlik marjı, sabit ekleme ve indirim (üstü çizili fiyat) gibi kuralları tek panelden tanımlarsınız. Kur değiştikçe ürün fiyatlarınız manuel müdahale olmadan güncellenir, böylece pazaryerlerinde her zaman doğru ve güncel fiyatla satış yaparsınız.

Paketler ve fiyatlandırma nasıldır?

Starter 1.250 ₺/ay, Pro 2.500 ₺/ay ve Enterprise 9.000 ₺/ay olmak üzere üç paket sunulur ve tüm fiyatlar aylıktır, KDV dahildir. Paketler; kullanabileceğiniz veri kaynağı sayısı, IP/alan adı yetkisi (whitelist), aylık REST istek kotası ve pazaryeri entegrasyon hakları bakımından farklılaşır. Starter tek şube ve temel socket akışı için, Pro mağaza ve pazaryeri operasyonları için, Enterprise ise tüm kaynak ve pazaryerlerini kapsayan kurumsal ihtiyaçlar için konumlandırılmıştır. Dilediğiniz zaman panel üzerinden üst pakete geçebilirsiniz.

API erişimi nasıl güvenli hale getiriliyor?

Her hesaba özel API anahtarı (Bearer token) ile kimlik doğrulaması yapılır ve erişim, tanımladığınız IP adresleri ya da alan adlarıyla (whitelist) sınırlandırılır. Böylece anahtarınız üçüncü kişilerin eline geçse bile yalnızca izin verdiğiniz sunuculardan kullanılabilir. Her paketin kendi IP yetki sayısı ve aylık istek kotası vardır; yetkili adresler ve kotalar panelden anlık olarak yönetilir. Tüm trafik HTTPS ve WSS üzerinden şifreli taşınır, böylece fiyat verileriniz uçtan uca korunur.

Hasfiyat'a kayıt olup ihtiyacınıza uygun paketi seçtikten sonra panelden API anahtarınızı oluşturursunuz. Ardından REST uç noktalarına Bearer anahtarınızla istek atabilir veya Socket.IO ile gerçek zamanlı akışa bağlanabilirsiniz; dokümantasyonda cURL ve Node.js örnekleri hazır şekilde sunulur. Çoğu ekip entegrasyonu dakikalar içinde tamamlar. Kurulum sırasında takıldığınız her konuda panel üzerindeki destek ve WhatsApp kanallarından bize ulaşabilirsiniz.

Canlı altın API nedir?

Canlı altın API, gerçek zamanlı altın ve döviz fiyatlarını yazılımınıza aktaran bir veri servisidir. Hasfiyat API bunu REST, WebSocket ve Webhook ile milisaniye gecikmeyle sunar.

Ücretsiz altın API var mı?

Evet. Hasfiyat API ücretsiz başlangıç planıyla denenebilir; üretim kullanımı için ihtiyaca göre paketler mevcuttur.

Altın API nasıl alınır?

Hasfiyat'a kayıt olun, panelden API anahtarınızı oluşturun ve REST ya da WebSocket ile bağlanın. Entegrasyon dakikalar içinde tamamlanır.

Gram altın API'de var mı?

Evet. Gram, çeyrek, yarım, tam, cumhuriyet, ATA ve 22 ayar dahil tüm sarrafiye kalemleri tek uçtan gelir.

22 ayar altın fiyatı API'de var mı?

Evet. 22 ayar dahil kuyumcuların kullandığı tüm ayar ve sarrafiye fiyatları API üzerinden sağlanır.

Gümüş ve platin API'de var mı?

Evet. Altın ve dövizin yanı sıra gümüş ve platin fiyatları da aynı API'den alınır.

Döviz kuru API'si var mı?

Evet. USD/TRY, EUR/TRY ve pariteler dahil canlı döviz kurları aynı API üzerinden sunulur.

Altın API fiyatları ne kadar?

Kullanımınıza göre paket seçenekleri vardır. Ücretsiz başlangıç planıyla test edip ihtiyacınıza uygun paketi seçebilirsiniz.

WebSocket ile altın fiyatı nasıl çekilir?

wss://api.hasfiyat.com/stream adresine bağlanıp fiyat değişimlerini anlık alırsınız; sürekli sorgu (polling) yapmanız gerekmez.

E-ticaret siteme altın fiyatı nasıl eklerim?

REST ile periyodik sorgu ya da WebSocket ile canlı akış kullanırsınız. Trendyol, Hepsiburada, Amazon gibi pazaryerleri için hazır entegrasyonlar mevcuttur.

Veriler ne kadar günceldir?

Türkiye piyasa verisi milisaniye gecikmeyle akar. Öncelikli kaynak kesilirse otomatik devretme ile fiyat akışı kesintisiz kalır.

Hangi programlama dilleriyle kullanılır?

HTTP/WebSocket destekleyen her dille: Node.js, PHP, Python, C# ve daha fazlası. Dokümantasyonda cURL ve Node.js örnekleri hazırdır.

Altın API ne işe yarar?

Canlı altın ve döviz fiyatlarını yazılımınıza otomatik aktararak fiyat panosu, e-ticaret ve mobil uygulamalarınızı günceller.

İstek attığınızda anlık fiyatları JSON olarak dönen uç noktalardır; kolay ve her dille uyumludur.

Webhook desteği var mı?

Evet, belirlediğiniz olaylarda fiyat verisi sizin adresinize otomatik gönderilir.

API dokümantasyonu nerede?

altinapi.hasfiyat.com/docs adresinde uçlar, parametreler ve örnek istek-yanıtlar hazırdır.

Ons altın API'de var mı?

Evet, ons (XAU) dahil tüm temel altın sembolleri sağlanır.

ATA altın API'de var mı?

Evet, ATA ve cumhuriyet altını dahil sarrafiye kalemleri desteklenir.

Has altın fiyatı API'de var mı?

Evet, has altın ve gram altın fiyatları anlık gelir.

Parite verisi var mı?

Evet, USD/TRY, EUR/TRY ve pariteler API üzerinden sunulur.

Fiyatlar ne sıklıkla güncellenir?

Piyasa hareketiyle milisaniye seviyesinde; WebSocket ile anında push edilir.

API gecikmesi ne kadar?

Milisaniye seviyesinde düşük gecikmeyle çalışır.

Kaç kaynak kullanabilirim?

Paketinize göre 11 canlı kaynaktan birden fazlasını aynı anda ve öncelik sırasıyla kullanabilirsiniz.

Kaynak kesilirse ne olur?

Öncelikli kaynak kesilirse sistem otomatik olarak bir sonraki kaynağa geçer; akış kesilmez.

IP kısıtlaması var mı?

Evet, panelden IP whitelist tanımlayarak anahtarınızı koruyabilirsiniz.

Domain whitelist var mı?

Evet, anahtarın yalnızca belirlediğiniz alan adlarından kullanılmasını sağlarsınız.

Paketinize göre istek limitleri vardır; WebSocket ile limit olmadan canlı akış alırsınız.

API anahtarı nasıl yenilenir?

Panelden mevcut anahtarı iptal edip yenisini tek tıkla oluşturursunuz.

Fiyatlar Harem Altın ile aynı mı?

Harem Altın dahil 11 kaynağı destekler; kaynak önceliğini siz belirlersiniz.

Mobil uygulamada kullanılır mı?

Evet, iOS ve Android uygulamalarında REST veya WebSocket ile kullanılır.

Vitrin ekranı için uygun mu?

Evet, kuyumcu vitrin/TV fiyat ekranları için idealdir.

Node.js örneği var mı?

Evet, dokümantasyonda Node.js ve cURL örnekleri hazır sunulur.

PHP ile nasıl kullanılır?

cURL veya Guzzle ile REST uçlarına Bearer anahtarınızla istek atarsınız.

Python ile nasıl kullanılır?

requests ile REST, websocket-client ile canlı akış; örnekler dokümanda mevcut.

Test ortamı var mı?

Ücretsiz başlangıç planıyla üretim öncesi test yapabilirsiniz.

Kurumsal fatura kesiliyor mu?

Evet, kurumsal ödeme ve fatura desteklenir.

Kaç sembol destekleniyor?

Onlarca altın, döviz, gümüş, platin ve parite sembolü sağlanır.

Gümüş gram fiyatı var mı?

Evet, gümüş gram fiyatı API üzerinden gelir.

Fiyat panosu kurulur mu?

Evet, API ile web/TV üzerinde canlı fiyat panosu kolayca kurulur.

Trendyol altın fiyatı entegrasyonu var mı?

Evet, Trendyol, Hepsiburada, Amazon, N11 gibi pazaryerleri için hazır entegrasyonlar mevcuttur.

Altın API güvenli mi?

Her istek API anahtarıyla doğrulanır; IP/domain whitelist ile ek güvenlik sağlanır.

Kurulum ne kadar sürer?

Çoğu ekip entegrasyonu dakikalar içinde tamamlar.

Tüm Rehber Sayfaları

Hesaplama

Altında Alış Satış Spread'i Nasıl Hesaplanır?

Alış - Satış Spread'i İki Fiyat Arasındaki Fark

Altın ve dövizde tek bir fiyat yoktur; alış ve satış olmak üzere iki fiyat kote edilir. Aralarındaki farka spread denir ve maliyeti doğrudan etkiler. Bu yazıda spread'in ne olduğunu, nasıl hesaplandığını ve neden önemli olduğunu açıklıyoruz.

Spread Nedir ve Nasıl Hesaplanır?

Spread, bir varlığın satış fiyatı ile alış fiyatı arasındaki farktır. Serbest piyasada alış, sizin sattığınızda alacağınız fiyat; satış ise sizin aldığınızda ödeyeceğiniz fiyattır. Satış her zaman alıştan yüksektir ve bu fark spread'i oluşturur.

Mutlak spread basitçe spread = satış fiyatı - alış fiyatı ile bulunur. Örneğin gram altında alış 2.600 TL, satış 2.640 TL ise spread 40 TL'dir. Bu, bir alıp hemen satarsanız katlanacağınız anlık maliyettir.

Karşılaştırma için yüzde spread daha kullanışlıdır: yüzde spread = (satış - alış) / alış × 100. Yukarıdaki örnekte (40 / 2.600) × 100 ≈ %1,54 çıkar. Yüzde ifade, farklı fiyat seviyelerindeki ürünleri kıyaslamayı kolaylaştırır.

Spread'in Önemi ve Anlık Takip

Spread, kısa vadeli işlemlerde kârlılığı doğrudan etkiler; dar spread düşük maliyet, geniş spread yüksek maliyet demektir. Likit ve derin piyasalarda spread daralır, dalgalı veya düşük hacimli anlarda genişler. Bu yüzden spread aynı zamanda piyasa sağlığının bir göstergesidir.

Bir uygulama alış ve satış fiyatlarını doğru göstermek zorundadır; tek fiyat sunmak kullanıcıyı yanıltır. Hem alış hem satışı anlık takip etmek, adil bir değerleme ve şeffaf bir deneyim için gereklidir.

Hasfiyat API'si serbest piyasa alış ve satış fiyatlarını ayrı ayrı, milisaniye gecikmeyle döndürür. REST ile anlık çift fiyatı çekebilir, WebSocket (Socket.IO) akışıyla spread değiştikçe otomatik güncelleme alabilirsiniz; böylece spread hesaplarınız her an güncel piyasa koşullarını yansıtır.

Sık sorulan sorular

Alış ve satış fiyatı ne demektir?

Alış (buy) fiyatı piyasanın altını sizden aldığı, satış (sell) fiyatı ise size sattığı değerdir. Hasfiyat altınapi bu iki değeri ayrı alanlar olarak döndürür, böylece işleminizin yönüne göre doğru fiyatı kullanırsınız.

Spread (makas) nedir?

Spread, alış ile satış fiyatı arasındaki farktır ve piyasada "makas" olarak da bilinir. Bu fark, piyasa yapıcıların işlem maliyeti ve risk payını yansıtır.

Alış ve satış fiyatı neden farklıdır?

Piyasa yapıcılar altını alırken daha düşük, satarken daha yüksek fiyat uygulayarak işlem maliyetini ve riskini karşılar. Bu yapısal fark, her varlıkta alış-satış spreadinin oluşmasına neden olur.

API'de alış ve satış ayrı mı geliyor?

Evet, Hasfiyat altınapi her sembol için alış ve satış değerini ayrı alanlar olarak döndürür. Bu sayede tek fiyata güvenmek yerine işleminizin yönüne uygun değeri kullanabilirsiniz.

Spread nasıl hesaplanır?

Spread, satış fiyatından alış fiyatının çıkarılmasıyla bulunur: Satış − Alış. Bu farkı yüzde olarak görmek isterseniz farkı alış fiyatına bölüp 100 ile çarparsınız.

Hesabımda alış mı satış fiyatını kullanmalıyım?

Müşteriye satış yapıyorsanız satış fiyatını, müşteriden altın alıyorsanız alış fiyatını kullanmalısınız. Yanlış yönü kullanmak, ürün değerini olduğundan yüksek ya da düşük gösterir.

Anlık spread değişimini API ile takip edebilir miyim?

Evet, WebSocket ile ilgili sembole abone olup alış ve satış değerlerini milisaniye-altı gecikmeyle alarak spreadi canlı izleyebilirsiniz. Bu, hızlı hareket eden piyasalarda makas genişlemesini anında yakalamanızı sağlar.

Kaynaklar arasında fiyat farkı olur mu?

Evet, farklı sağlayıcılar arasında küçük fiyat farkları olabilir; Hasfiyat altınapi 14 kaynağı birleştirip çoklu-kaynak failover ile en güvenilir değeri sunar. Bir kaynak çökse bile diğerinden fiyat gelmeye devam eder.

Spreadin genişlemesi ne anlama gelir?

Spreadin genişlemesi genellikle piyasanın oynaklığının arttığını ya da likiditenin azaldığını gösterir. Bu dönemlerde alış-satış farkı büyür, bu yüzden fiyatlamayı anlık veriyle güncel tutmak önemlidir.

Canlı altın & döviz verisine hemen bağlanın

Dakikalar içinde REST veya Socket.IO ile gerçek zamanlı fiyat akışına başlayın.

Hemen Başla Dokümantasyon

Diğer rehber sayfaları

Altın WebSocket ile Canlı Veri Akışı Ticimax Altın Fiyat Entegrasyonu İkas Altın Fiyat Entegrasyonu WooCommerce ve WordPress Altın Entegrasyonu E-ticaret Altyapıları Altın Entegrasyonu Pazaryeri Altın Fiyat Entegrasyonu Harem Altın API Alternatifi ve Veri Sağlayıcısı Altın ve Döviz Veri Kaynakları Emtia API Gram, Çeyrek, Ons ve Daha Fazlası Döviz ve Parite API USD/TL, EUR/TL ve Fazlası Geliştiriciler İçin Altın API Entegrasyonu E-ticaret Altın Fiyat Otomasyonu