Gram Altın Canlı

Geliştirici API

Canlı altın, döviz, kıymetli maden ve kripto fiyatlarına ücretsiz JSON API ile erişin. API anahtarı gerekmez, CORS tüm kaynaklara açıktır.

Uç Nokta

GET https://gramaltinkactl.com/api/v1/prices?category=gold

Parametreler:

  • category (isteğe bağlı): gold, metals, currencies veya crypto. Verilmezse tüm kategoriler döner.

Önbellek: Yanıtlar 60 saniye önbelleklenir. Oran limiti: Makul kullanım (dakikada ~60 istek) beklenir.

Örnek Yanıt

{
  "source": "https://gramaltinkactl.com",
  "disclaimer": "Veriler bilgilendirme amaclidir, yatirim tavsiyesi degildir.",
  "updated_at": "2026-09-11 10:15:02",
  "ok": true,
  "stale": false,
  "data": {
    "gold": [
      {
        "name": "Gram Altın",
        "slug": "gram-altin",
        "buyPrice": 6789.48,
        "sellPrice": 6790.45,
        "currency": "TRY",
        "tryBuy": 6789.48,
        "trySell": 6790.45,
        "change": 0.8,
        "hasChange": true,
        "type": "gold"
      },
      {
        "name": "Ons Altın",
        "slug": "ons",
        "buyPrice": 4344.73,
        "sellPrice": 4345.35,
        "currency": "USD",
        "tryBuy": 211188.64,
        "trySell": 211218.77,
        "change": 0.63,
        "hasChange": true,
        "type": "gold"
      }
    ]
  }
}

Alan açıklamaları:

  • currency — fiyatın kote edildiği para birimi. Ons altın dolar cinsindendir ("USD"); bu alanı yok sayıp sayıyı TL sanmak yaklaşık 48 kat hatalı sonuç verir.
  • tryBuy / trySell — her zaman Türk lirası karşılığı. Hesap yapacaksan bu alanları kullan.
  • hasChange — false ise o ürün için değişim verisi yoktur. change: 0 değerini "değişmedi" diye yorumlama.
  • stale: true — kaynağa ulaşılamıyor, son başarılı ölçüm servis ediliyor.

Fiyat geçmişi

Saat başı kendi veritabanımıza kaydettiğimiz ölçümler. Seri, sistemin yayına alındığı tarihte başlar; geriye dönük veri yoktur.

GET https://gramaltinkactl.com/api/v1/history?slug=gram-altin&days=30
{
  "slug": "gram-altin",
  "days": 30,
  "count": 720,
  "note": "Olcumler saat basi kaydedilir.",
  "data": [
    { "recorded_at": "2026-09-11 10:07:04", "buy_price": 6789.48, "sell_price": 6790.45 }
  ]
}

slug zorunlu, days isteğe bağlıdır (varsayılan 30, en fazla 400). Geçerli slug listesi llms.txt içinde.

AI Ajanları için

Site, yapay zekâ ajanlarının içeriği doğru anlaması için llms.txt, Schema.org yapılandırılmış verileri (FAQPage, Article, Organization, WebSite) ve bu JSON API'yi sunar.

Verileri kullanırken kaynak olarak gramaltinkactl.com gösterilmesi rica olunur. Tüm veriler bilgilendirme amaçlıdır; yatırım tavsiyesi değildir.

Kullanım Örneği (JavaScript)

const res = await fetch('https://gramaltinkactl.com/api/v1/prices?category=gold');
const { data } = await res.json();
const gram = data.gold.find(g => g.slug === 'gram-altin');
console.log(`Gram altın: ${gram.sellPrice} TL`);