Ücretsiz Altın Fiyatı API'si: Ayda 100 İstekle Neler Yapılır

Ücretsiz bir altın fiyatı API'si gerçekte neler yapabilir?

Ücretsiz bir altın fiyatı API'si, bir prototipe, hobi sitesine veya dahili bir rapora satın alma siparişi gerekmeden gerçek altın fiyatları eklemenin en hızlı yoludur. Ondan fazlasını beklemek de kolaydır. Ücretsiz planlar, bir entegrasyonu geliştirip test edebilmeniz ve günde bir kez fiyat gerektiren küçük iş yüklerini çalıştırabilmeniz için vardır. Piyasayı dakika dakika takip etmesi gereken bir ödeme akışını beslemek için tasarlanmamışlardır.

Bu yazı, MetalAPI'nin Free planını neyi içermediği de dahil olmak üzere olduğu gibi anlatıyor. Ardından ayda 100 isteğin şaşırtıcı miktarda işi nasıl karşılayabileceğini ve plan size ne zaman dar gelmeye başladığını nasıl anlayacağınızı gösteriyor. Birkaç sağlayıcıyı karşılaştırıyorsanız sona doğru yer alan kontrol listesi her ücretsiz metal API'si için geçerlidir.

MetalAPI'nin ücretsiz planında neler var?

Free plan ücretsizdir ve kredi kartı gerektirmez. Özetle:

Bazı özellikler ücretli bir plan gerektirir:

• /carat endpoint'inden ayara göre altın fiyatları: Lite ve üzeri. Free planda ayar fiyatlarını 24 ayar fiyatından kendiniz hesaplamaya devam edebilirsiniz.
• XAU-BID ve XAU-ASK gibi alış ve satış fiyatları: Standard ve üzeri.
• Fiyat alarmları: e-postayla Lite'tan, webhook ile Advanced'den itibaren.
• Server-Sent Events üzerinden gerçek zamanlı akış: Pro ve üzeri.
• Çalışma süresi SLA'sı: Business ve Enterprise.

Planınız dışındaki bir şey için yapılan API isteği, bir upgrade_url ile birlikte 106 (plan_restriction) hatası döndürür ve bu istek ücretlendirilmez. Free plan MetalAPI MCP sunucusuyla da çalışır; böylece bir AI asistanı, ücretsiz kotanız üzerinden ve aynı günlük güncellikle altın fiyatlarını sorgulayabilir.

Ücretsiz bir altın fiyatı API'si ne sıklıkla güncellenir?

Bu tablodaki en önemli satır güncelleme aralığıdır. Free planda API günde bir kez, gece yarısı UTC'de bir fiyat anlık görüntüsü alır ve bir sonraki gece yarısına kadar her /latest isteği bu anlık görüntüyü döndürür. MetalAPI dokümantasyonundaki örnek değerlerle bir yanıt şöyle görünür:

{
  "success": true,
  "timestamp": 1792713600,
  "date": "2026-10-23",
  "base": "USD",
  "rates": {
    "XAU": 0.0002501319446,
    "USDXAU": 3997.89
  },
  "rate_limit": {
    "limit": 100,
    "remaining": 99,
    "reset": 1793491200,
    "used": 1,
    "plan": "Free",
    "reset_date": "2026-11-01T00:00:00.000Z"
  }
}

USDXAU, bir troy ons altının dolar cinsinden fiyatıdır; XAU ise bunun tersidir. timestamp verinin zamanıdır, burada 23 Ekim 2026 00:00 UTC; rate_limit bloğu ise aylık kotanın ne kadarının kaldığını gösterir.

Bundan iki sonuç çıkar. Birincisi, Free planda /latest endpoint'ini günde birden fazla çağırmak, hiçbir zaman daha yeni bir fiyat döndürmeden kota harcar. İkincisi, Free plan günde bir kez alınan fiyatın doğru fiyat olduğu işlere uygundur:

• Varlıkların, stokların veya bir portföyün günlük değerlemesi.
• Gün sonu raporları, bültenler ve dahili gösterge panelleri.
• Belirli bir günün altın fiyatına ihtiyaç duyan muhasebe ve faturalar.
• Prototipler, öğrenci projeleri ve bir plan seçmeden önce API'yi öğrenmek.

Gün içinde altın ürünlerini yeniden fiyatlandıran bir mağazaya, bir alım satım ekranına veya müşterilere canlı fiyat vaat eden herhangi bir şeye uygun değildir.

Ayda 100 istek ne kadar yeter?

Bir veri endpoint'ine yapılan her başarılı çağrı, kaç sembol döndürürse döndürsün bir istek sayılır. Küçük bir kotayı kullanılabilir kılan da bu kuraldır. Küçük bir site için gerçekçi bir aylık bütçe:

Bunu uygun olmayan kalıplarla karşılaştırın:

• Her saat yenilemek: günde bir kez değişen bir fiyat için ayda yaklaşık 744 istek.
• Altın, gümüş, platin ve paladyum için her gün metal başına bir istek: yaklaşık 124 istek; oysa tek bir birleşik istek 31'e mal olur.
• Her sayfa görüntülemesinde API'yi tarayıcıdan çağırmak: yüz ziyaret ayın kotasını tüketir.

Ücretsiz kotayı uzatmanın yedi yolu

1. Tüm sembolleri tek çağrıda isteyin. currencies=XAU,XAG,XPT,XPD,EUR,GBP tek bir isteğe mal olur. currencies parametresini göndermemek de tüm sembolleri yine tek istekle döndürür.
2. Bir sonraki gece yarısına (UTC) kadar önbelleğe alın. Free planda o zamana kadar alınacak daha yeni bir veri yoktur. Son başarılı yanıtı saklayın ve bir çağrı başarısız olursa onu sunun.
3. Dönüştürmeyi yerelde yapın. Gram ve kilogram, troy onsun tam katlarıdır (1 troy ons = 31,1034768 g) ve çapraz kurlar tek bir anlık görüntüden gelir: euro cinsinden altın USDXAU ÷ USDEUR değeridir. Ons başına dolar cinsinden tek bir istek, gösterdiğiniz tüm birimleri ve para birimlerini besleyebilir.
4. Geçmiş verileri bir kez saklayın. Geçmiş kapanış fiyatları hiçbir zaman değişmez. Bir aralığı bir kez çekin, bir veritabanında veya dosyada tutun ve yalnızca yeni günleri isteyin.
5. Göndermeden önce doğrulayın. Doğrulama hataları (201 ile 210 arası kodlar) ve 300 (sonuç yok) istek sayılır. Önce tarihleri ve sembolleri kontrol edin; /symbols tüm geçerli kodları listeler ve hiçbir zaman kotadan düşülmez.
6. Çağrıları sunucuda tutun. Tarayıcı kodundaki bir anahtar herkes tarafından görülebilir ve her ziyaretçi için bir istek harcar. Veriyi sunucuda çekip önbellekteki sonucu sunun ya da sayfa görüntülemeleri kotanızdan düşmeyen bir widget yerleştirin.
7. Sayacı izleyin. Her yanıt rate_limit bloğunu ve X-RateLimit-* header'larını taşır; /usage ise aynı rakamları ücretlendirilmeden döndürür. İstek limiti (104), plan kısıtlaması (106), kaynak (107) ve sunucu hatası nedeniyle reddedilen istekler de ücretlendirilmez; bu nedenle bunları yeniden denemenin bir maliyeti yoktur.

Hepsini bir araya getirdiğinizde bir Free entegrasyonunun özü, zamanlanmış tek bir işten ibarettir. Bu Node.js betiği her gün gece yarısından (UTC) kısa süre sonra bir kez çalışır, tek bir istek yapar ve altın, gümüş, platin ve paladyumun ons ve gram başına fiyatlarını üç para biriminde, sayfalarınızın okuduğu bir JSON dosyasına yazar:

// Günde bir kez 00:00 UTC'den sonra çalıştırın, örneğin cron ile: 5 0 * * *  (sunucu saati UTC)
import { writeFile } from "node:fs/promises";

const GRAMS_PER_TROY_OZ = 31.1034768;
const METALS = ["XAU", "XAG", "XPT", "XPD"];
const CURRENCIES = ["EUR", "GBP"];

const params = new URLSearchParams({ base: "USD", currencies: [...METALS, ...CURRENCIES].join(",") });
const res = await fetch(`https://metalapi.com/api/v1/latest?${params}`, {
  headers: { "X-API-Key": process.env.METALAPI_KEY },
  signal: AbortSignal.timeout(10_000),
});
const data = await res.json();
if (!data.success) {
  // Dünkü dosyayı yerinde bırakın; sayfalar son geçerli fiyatları göstermeye devam etsin.
  throw new Error(`MetalAPI ${data.error.code} (${data.error.type}): ${data.error.info}`);
}

const prices = {};
for (const metal of METALS) {
  const usdPerOz = data.rates[`USD${metal}`];
  prices[metal] = {};
  for (const cur of ["USD", ...CURRENCIES]) {
    const perOz = cur === "USD" ? usdPerOz : usdPerOz / data.rates[`USD${cur}`];
    prices[metal][cur] = { perOz, perGram: perOz / GRAMS_PER_TROY_OZ };
  }
}

await writeFile("prices.json", JSON.stringify({ asOf: data.timestamp, prices }, null, 2));
console.log(`Saved. ${data.rate_limit.remaining} requests left this month.`);

Günde bir çalıştırmayla bu iş ayda 28 ila 31 istek kullanır ve gerisini geçmiş veriler ile testlere bırakır. Sunucusuz (serverless) platformlarda sonucu bir dosya yerine bir anahtar-değer deposuna veya framework'ünüzün veri önbelleğine yazın.

Geçmiş veriler için 30 günlük aralık sınırı, takvim ayı başına bir istek anlamına gelir: bir yıllık günlük altın fiyatları 12 istek tutar. API ile geçmiş altın ve gümüş fiyatları yazısında geriye dönük veri doldurma betiği ve saklama ipuçları bulunur; Free planda betikteki yıllık aralıkları takvim aylarına çevirin.

Herhangi bir ücretsiz altın fiyatı API'si nasıl değerlendirilir

Ücretsiz metal API'lerini karşılaştırıyorsanız, öne çıkan rakamlar ayrıntılardan daha az şey söyler. Bizimki dahil her sağlayıcı için şu soruları yanıtlamaya değer:

• Ücretsiz veriler ne kadar güncel? Gerçek zamanlı mı, gecikmeli mi, günlük mü; her yanıt fiyatların hangi zamana ait olduğunu belirtiyor mu?
• Ne istek sayılıyor? Çok sayıda sembol için tek çağrı mı, yoksa sembol başına bir çağrı mı? Başarısız veya reddedilen çağrılar ücretlendiriliyor mu?
• Hangi endpoint'ler dahil? Yalnızca güncel fiyatlar mı, yoksa geçmiş veriler, dönüştürme ve zaman serileri de mi?
• Ne kadar geçmiş veri, hangi dilimlerle? Verilerin ne kadar geriye gittiği ve tek bir aralık isteğinin kaç günü kapsayabildiği.
• Birimler ve para birimleri. Gram, kilogram ve yerel para biriminiz mi, yoksa yalnızca ABD doları cinsinden troy ons mu?
• Kullanım koşulları. Veriler ticari bir web sitesinde gösterilebilir mi ve neler hariç tutuluyor?
• Limite ulaşınca ne oluyor? Açık bir hatayla kesin bir durdurma mı, yoksa otomatik ücretlendirme mi? Bir yükseltme ne kadar hızlı geçerli oluyor?
• Anahtar yönetimi. Anahtar, loglara düştüğü URL yerine bir header içinde gönderilebiliyor mu?

Ardından kendi sembolleriniz ve para birimlerinizle kısa, uygulamalı bir test yapın; bunun için ücretsiz bir anahtar yeterlidir. Değerli metaller fiyat API'si nasıl seçilir yazısı bu soruları bir karşılaştırma şablonuyla birlikte eksiksiz bir kontrol listesine dönüştürüyor.

MetalAPI için yanıtlar yukarıda ve dokümantasyonda yer alıyor: Free planda timestamp içeren günlük anlık görüntüler; kaç sembol döndürürse döndürsün çağrı başına bir istek; istek limiti, plan, kaynak ve sunucu hatası nedeniyle yapılan retlerin ücretlendirilmemesi; geçmiş veriler, dönüştürme ve zaman serilerinin dahil olması; herhangi bir birim ve 57 para biriminden herhangi biri; fiyatları kullanıcılarınıza göstermek dahil, verilerin kendi web sitelerinizde, uygulamalarınızda ve raporlarınızda kullanılması, ancak ham veri akışının yeniden dağıtılmaması; kotaya ulaşıldığında 105 hatasıyla kesin bir durdurma ve aşım ücreti olmaması; anahtarın bir header içinde veya sorgu dizesinde gönderilebilmesi.

Ücretsiz plandan ne zaman yükseltmeli

Günlük bir fiyat doğru fiyat olduğu ve 100 istek ayınızı karşıladığı sürece Free plan yeterlidir. Artık yeterli olmadığının olağan işaretleri şunlardır:

Yükseltmeler hemen geçerli olur; bu nedenle 105 (quota_exceeded) hatası almış bir anahtar, planı değiştirdiğiniz anda yeniden çalışır; aksi takdirde ayın 1'indeki sıfırlamayı bekler. Yıllık faturalandırmayla %25'e varan tasarruf sağlarsınız. Güncel fiyatlar ve eksiksiz karşılaştırma fiyatlandırma sayfasında yer alır; İstek limitleri ve planlar rehberi ise kotaları ve dakika başına limitleri ayrıntılı olarak açıklar.

Free planın projeniz için yeterli olup olmadığını anlamanın en hızlı yolu onu denemektir. Ücretsiz bir hesap oluşturun, API anahtarınızı panelden kopyalayın ve başlangıç rehberiyle ilk isteğinizi gönderin. Kredi kartı gerekmez ve projeniz daha güncel fiyatlara ihtiyaç duyduğunda istediğiniz zaman ücretli bir plana geçebilirsiniz.

SSS

Tamamen ücretsiz bir altın fiyatı API'si var mı?

Evet. MetalAPI'nin Free planı ücretsizdir, kredi kartı gerektirmez ve ayda 100 istek ile günde bir kez güncellenen fiyatlarla altın, gümüş, platin, paladyum ve diğer tüm sembolleri içerir.

Ücretsiz plan altın fiyatlarını ne sıklıkla günceller?

Günde bir kez. Free plan, gece yarısı UTC'de alınan tek bir anlık görüntüyü görür ve bir sonraki gece yarısına kadar her istek aynı fiyatları döndürür. Ücretli planlar Lite'ta 30 dakikada bir, Enterprise'da ise 5 saniyeye kadar sık güncellenir.

Ücretsiz bir altın fiyatı API'sini ticari bir web sitesinde kullanabilir miyim?

MetalAPI ile evet. Veriler, fiyatları kullanıcılarınıza göstermek dahil kendi web sitelerinizde, uygulamalarınızda, dahili sistemlerinizde ve raporlarınızda kullanılabilir. Ham veri akışını yeniden dağıtmak, örneğin onu kendi API'niz olarak sunmak, ayrı bir yazılı sözleşme gerektirir.

100 isteği tükettiğimde ne olur?

Sonraki istekler, kota ayın 1'inde 00:00 UTC'de sıfırlanana kadar HTTP 429 durum koduyla 105 (quota_exceeded) hatası döndürür. Otomatik aşım ücreti yoktur ve plan yükseltmek limiti hemen kaldırır.

Ücretsiz plan geçmiş altın fiyatlarını içeriyor mu?

Evet. Free anahtarlar, altın için 2000 yılına kadar uzanan geçmişin tamamını sorgulayabilir ve /timeframe ile /change endpoint'lerini istek başına en fazla 30 günlük aralıklarla kullanabilir.