API Dokümantasyonu

Giriş

Hasfiyat API, kuyumcu ve döviz büroları için farklı kaynaklardan anlık altın, döviz ve kripto para verilerini tek bir noktada toplar. REST API ve WebSocket Stream seçenekleri ile uygulamanıza en uygun veri akışını kolayca entegre edebilirsiniz.

API isteklerinizi doğrulamak için `Authorization` başlığında API anahtarınızı (Bearer Token) kullanmanız gerekmektedir. Anahtarlarınızı panel üzerinden **API Anahtarı** sayfasından oluşturabilirsiniz.

GET /api/prices HTTP/1.1
Host: api.hasfiyat.com
Authorization: Bearer YOUR_API_KEY

Tüm bot verilerine tek bir uç nokta üzerinden erişebilirsiniz. Kaynak seçimi için `source` parametresini kullanın.

const url = "https://api.hasfiyat.com/api/prices?source=harem&symbols=GRAM,HAS";
const res = await fetch(url, { headers: { 'Authorization': 'Bearer YOUR_KEY' } });
console.log(await res.json());

// Birim bilgisi, ayarsiz (ham) deger ve turetilmis kalem
const url = "https://api.hasfiyat.com/api/prices?source=harem&symbols=GRAM ALTIN,ALTIN/GÜMÜŞ&birim=1&ham=1";
const res = await fetch(url, { headers: { 'Authorization': 'Bearer YOUR_KEY' } });
const j = await res.json();

console.log(j.lastUpdate);            // "2026-09-24T07:07:37.939Z" (mutlak an)
console.log(j.dataAgeMs, j.stale);   // 178  false  (goreli yas + bayatlik)
console.log(j.data[0]);              // { title, buy, sell, unit, currency }

WebSocket teknolojisi ile verileri anlık olarak takip edin. Her veri değişikliğinde anında bildirim alırsınız.

const token = "YOUR_JWT_TOKEN";
const ws = new WebSocket("wss://api.hasfiyat.com/stream?source=harem&token=" + token);

ws.onmessage = (event) => {
  const data = JSON.parse(event.data);
  console.log('Canlı Veri:', data);
};

ws.onerror = (err) => {
  console.error('Bağlantı Hatası:', err);
};

Kullanılabilir Kaynaklar

Her kaynak kendi sembol adlandırmasını kullanır. Aşağıdaki listeler 24.09.2026 tarihinde canlı uçtan okunarak üretilmiştir. Bir sembolü tam adıyla istemeniz en kesin sonucu verir; tam eşleşme tutmazsa sistem normalize eşleme ve takma ad çözümlemesini sırayla dener.

Birim ve Para Birimi

Değerler Türkçe biçimli metindir (binlik ., ondalık , — örn. 6.692,74). Ondalık basamak sayısı kaynağın hassasiyetini korur. Birim bilgisi sembol adına gömülüdür; alan olarak almak için birim=1 parametresini ekleyin.

Tanınmayan bir sembolde unit ve currency alanları null döner — yanlış birim bildirilmez.

buy / sell Ne Anlama Gelir?

buy alış, sell satış değeridir; piyasa yapıcısının perspektifinden verilir. buy piyasanın sizden aldığı, sell piyasanın size sattığı fiyattır. Her zaman buy < sell olur; aradaki fark makastır.

Türetilmiş Kalemler

Bazı semboller kaynakta bulunmaz; bunları adıyla istediğinizde API tarafında üretiriz. Kaynakta aynı adlı kalem varsa kaynak her zaman otoritedir, türetme yapılmaz. Hesap için gereken veri eksikse kalem hiç üretilmez — uydurma değer dönmez.

Kaynak Bazlı Sembol Listeleri

Başlığa tıklayarak o kaynağın tüm sembollerini açabilirsiniz. Parantez içindeki değer birimdir.

Yanıt Başlıkları

Gövdeyi ayrıştırmadan veri sağlığını izlemek için bu başlıkları kullanabilirsiniz.

Hasfiyat paneli; altın ürün fiyatlarınızı 16 pazaryeri ve e-ticaret mağazasına canlı altın kuruna göre otomatik aktarır. Fiyatlar gramaj, emtia kaynağı ve marj oranınıza göre hesaplanır; tampon ve volatilite eşikleriyle gereksiz güncellemeler engellenir.

Desteklenen Platformlar

Fiyat Nasıl Hesaplanır?

Her ürün için gramaj ve baz emtia (HAS, GRAM, 22 ayar, çeyrek vb.) tanımlanır. Fiyat, seçtiğiniz kaynağın canlı değerinden hesaplanır; tampon (buffer) ve volatilite eşiği ile küçük dalgalanmalarda gereksiz güncelleme yapılmaz, marjınız korunur.

Senkronizasyon Modları

Kurulum Adımları

1. 1Panelde Pazaryerleri sayfasına gidin ve yeni entegrasyon ekleyin.
2. 2Pazaryerini seçip kimlik bilgilerini (API anahtarı, mağaza adresi vb.) girin ve bağlantıyı doğrulayın.
3. 3Ürünleri çekin, gramaj ve baz emtiayı eşleştirin; alış/satış marjınızı belirleyin.
4. 4Test (Dry-run) modunda fiyatları önizleyin; doğruysa Canlı moda alıp gönderim sıklığını ayarlayın.