Gümüş Fiyatı API'si: JSON ile Canlı ve Geçmiş XAG Fiyatları

Bir gümüş fiyatı API'si size ne sunar

Bir gümüş fiyatı API'si, gümüşün güncel ve geçmiş fiyatını yapılandırılmış veri olarak, genellikle HTTPS üzerinden JSON biçiminde döndürür; böylece bir mağaza, uygulama veya rapor, rakamları bir web sitesinden kopyalamadan bu fiyatı kullanabilir. MetalAPI'de gümüşün sembolü, bir troy ons gümüş için ISO 4217 kodu olan XAG'dir. Canlı değeri spot fiyattır: toptan piyasadaki alış ve satış kotasyonlarının orta noktası.

Gümüş, altınla aynı API'yi paylaşır, ancak kendine özgü alışkanlıkları vardır. Troy ons başına kote edilir, ama gram ve kilogramla alınıp satılır; gram fiyatı, yuvarlamanın önem kazanacağı kadar küçüktür ve gümüş eşya ile hurda alıcıları ayar yerine milyemle düşünür. Bu rehber, istekleri ve gümüşe özgü ayrıntıları ele alıyor:

• Tek bir istekle canlı gümüş fiyatı ve nasıl okunacağı.
• Ons, gram ve kilogram başına gümüş fiyatları.
• Yine tek bir istekle diğer para birimlerinde gümüş.
• 2000 yılına uzanan geçmiş gümüş fiyatları.
• Kullanım alanları: külçe satıcıları, gümüş eşya ve hurda alıcıları ve yatırım uygulamaları.

Canlı gümüş fiyatı API ile nasıl alınır

Ücretsiz bir hesap oluşturun ve panelden bir API anahtarı ekleyin. Anahtarlar mk_live_ ile başlar. Anahtarınızı bir ortam değişkeninde tutun ve bir header içinde gönderin, ardından XAG ile /latest endpoint'ini isteyin:

export METALAPI_KEY="mk_live_your_key_here"

curl "https://metalapi.com/api/v1/latest?base=USD&currencies=XAG" \
  -H "X-API-Key: $METALAPI_KEY"

Yanıt şöyle görünür. Sayılar canlı fiyatlar değil, MetalAPI dokümantasyonu boyunca kullanılan örnek değerlerdir:

{
  "success": true,
  "timestamp": 1792713600,
  "date": "2026-10-23",
  "base": "USD",
  "rates": {
    "XAG": 0.01853911754,
    "USDXAG": 53.94
  }
}

USDXAG, bir troy ons gümüşün baz para birimi cinsinden fiyatıdır; bu örnekte 53,94 ABD doları. XAG ise bunun tersidir, yani dolar başına troy ons gümüş; forex tarzı API'lerle uyumluluk için korunur. Her zaman ön ekli anahtarı okuyun: rates.XAG değerini fiyat olarak kullanmak, 53,94 yerine 0,0185 gösterir.

timestamp, isteğinizin değil verinin zamanıdır. Spot gümüş hafta içi günün her saatinde işlem görür ve New York saatiyle cuma 17:00'den pazar 17:00'ye kadar durur; bu nedenle API hafta sonu boyunca cuma gününün kapanış fiyatını döndürmeye devam eder. Zaman damgasını, özellikle cumartesi ve pazar günleri, fiyatın yanında gösterin.

Altın, platin veya paladyuma da ihtiyacınız varsa onları aynı isteğe ekleyin: currencies=XAU,XAG,XPT,XPD. Bir istek, kaç sembol döndürürse döndürsün bir kez sayılır.

Ons, gram ve kilogram başına gümüş fiyatı

unit göndermediğiniz sürece gümüş fiyatları troy ons, yani 31,1034768 gram başınadır. Desteklenen değerler troy_oz (varsayılan), gram, kilogram, ounce, pound, metric_ton ve short_ton'dur; birim varsayılan olmadığında yanıta üst düzeyde bir unit alanı eklenir:

curl "https://metalapi.com/api/v1/latest?currencies=XAG&unit=kilogram" \
  -H "X-API-Key: $METALAPI_KEY"

Troy ons başına 53,94 dolarlık örnek fiyatla gümüşün fiyatı:

Gümüş için iki alışkanlık edinmeye değer. Birincisi, gram fiyatında daha fazla ondalık basamak gösterin: 1,7342 dolarda iki ondalık basamak, günlük hareketin büyük kısmını gizler; bu nedenle dört basamak yaygındır. İkincisi, birden fazla birim gösteriyorsanız birim başına bir istek yapmak yerine troy onsu bir kez isteyin ve dönüştürmeyi yerelde yapın. Çarpanlar kesindir:

const GRAMS_PER_TROY_OZ = 31.1034768;

const res = await fetch("https://metalapi.com/api/v1/latest?currencies=XAG", {
  headers: { "X-API-Key": process.env.METALAPI_KEY },
  signal: AbortSignal.timeout(10_000),
});
const data = await res.json();
if (!data.success) throw new Error(`MetalAPI ${data.error.code} (${data.error.type}): ${data.error.info}`);

const perOz = data.rates[`${data.base}XAG`]; // dokümantasyon örneğinde 53.94
const perGram = perOz / GRAMS_PER_TROY_OZ; // 1.7342...
const perKg = perGram * 1000; // 1734.21...

console.log({ perOz, perGram: perGram.toFixed(4), perKg: perKg.toFixed(2) });

Troy ons, gram ve kilogram yazısı, pennyweight dahil tüm çarpanları ve faturalar için yuvarlama kurallarını listeler.

Diğer para birimlerinde gümüş fiyatları

Gümüşü başka bir para birimiyle fiyatlandırmak için base değerini ayarlayın: base=EUR, EURXAG değerini; base=INR ise INRXAG değerini döndürür. unit ile birlikte kullanıldığında bu istek gram başına euro döndürür:

curl "https://metalapi.com/api/v1/latest?base=EUR&currencies=XAG&unit=gram" \
  -H "X-API-Key: $METALAPI_KEY"

{
  "success": true,
  "timestamp": 1792765800,
  "date": "2026-10-23",
  "base": "EUR",
  "unit": "gram",
  "rates": {
    "XAG": 0.6713138244,
    "EURXAG": 1.489616277
  }
}

Gümüşü birkaç para biriminde göstermek için de tek bir istek yeterlidir. Baz USD ile gümüşü ve para birimlerini isteyin, ardından bölün: euro cinsinden gümüş USDXAG ÷ USDEUR değeridir; çünkü USDEUR, bir euronun dolar cinsinden fiyatıdır. Tüm değerler aynı anlık görüntüden gelir; bu nedenle sonuç, base=EUR ile dönen değerle örtüşür. Dokümantasyondaki euro başına 1,1642 dolarlık örnek kurla 53,94 ÷ 1,1642, troy ons başına 46,33 euro, yani gram başına 1,4896 euro eder; yukarıdakiyle aynı:

import os

import requests

GRAMS_PER_TROY_OZ = 31.1034768
CURRENCIES = ["EUR", "GBP", "INR", "TRY"]

resp = requests.get(
    "https://metalapi.com/api/v1/latest",
    params={"base": "USD", "currencies": ",".join(["XAG", *CURRENCIES])},
    headers={"X-API-Key": os.environ["METALAPI_KEY"]},
    timeout=10,
)
data = resp.json()
if not data["success"]:
    err = data["error"]
    raise RuntimeError(f"MetalAPI {err['code']} ({err['type']}): {err['info']}")

rates = data["rates"]
silver_usd = rates["USDXAG"]
for cur in ["USD", *CURRENCIES]:
    per_oz = silver_usd if cur == "USD" else silver_usd / rates["USD" + cur]
    print(f"{cur}: {per_oz:,.2f} per troy oz, {per_oz / GRAMS_PER_TROY_OZ:,.4f} per gram")

Desteklenen 57 para biriminin tümü bu şekilde çalışır; altın, platin ve paladyum da öyle. Böylece tek bir çağrı bütün bir fiyat panosunu besleyebilir. Gümüşün genellikle kilogram başına kote edildiği Hindistan'da base=INR&unit=kilogram alışılmış rakamı doğrudan verir.

API ile geçmiş gümüş fiyatları

Gümüş geçmişi 2000 yılında başlar ve canlı fiyatla aynı parametreleri ve yanıt formatını kullanır. Her günün değerleri o günün kapanış fiyatlarıdır ve tarihler UTC'dir. İhtiyaçların çoğunu dört endpoint karşılar:

• /YYYY-MM-DD, /historical?date= veya /yesterday: tek bir günün kapanışı. Hafta sonları ve tatiller için en son işlem gününün kapanışı döner.
• /timeframe: start_date ile end_date arasındaki günlük kapanışlar; Free planda istek başına en fazla 30 gün, ücretli planlarda 365 gün.
• /change: iki tarih arasındaki başlangıç fiyatı, bitiş fiyatı, mutlak ve yüzde değişim.
• /ohlc: tek bir günün açılış, en yüksek, en düşük ve kapanış değerleri.

# 15 Ocak 2024 kapanışında gümüş (dokümantasyon örneğinde USDXAG 23.162)
curl "https://metalapi.com/api/v1/2024-01-15?currencies=XAG" \
  -H "X-API-Key: $METALAPI_KEY"

# Eylül 2026 için gram başına euro cinsinden günlük gümüş kapanışları
curl "https://metalapi.com/api/v1/timeframe?start_date=2026-09-01&end_date=2026-09-30&base=EUR&currencies=XAG&unit=gram" \
  -H "X-API-Key: $METALAPI_KEY"

# 500 gram gümüşün 1 Ekim 2026 kapanışında euro cinsinden değeri
curl "https://metalapi.com/api/v1/convert?from=XAG&to=EUR&amount=500&unit=gram&date=2026-10-01" \
  -H "X-API-Key: $METALAPI_KEY"

Geçmiş günlerin kapanış fiyatları hiçbir zaman değişmez; bu nedenle onları yeniden istemek yerine saklayın. Ücretli planların 365 günlük sınırıyla, 2000'den bu yana eksiksiz bir geriye dönük veri doldurma işlemi yıl başına bir /timeframe isteği gerektirir. Ekim 2026'dan önceki metal fiyatlarının en yakın vadeli futures kontratlarından türetildiğini ve bu nedenle aynı gündeki spot fiyattan biraz farklı olabileceğini unutmayın.

API ile geçmiş altın ve gümüş fiyatları yazısı eksiksiz bir veri doldurma betiği, saklama ve doğrulama ipuçları ile altın/gümüş oranıyla birlikte bir altın grafiği içerir.

Gümüş fiyatı API'sinin kullanım alanları

Külçe satıcıları ve sikke tüccarları. Satıcılar spot fiyatın üzerinde satar ve altında geri alır. Tipik bir satış fiyatı, troy ons başına spot fiyat × saf gümüş içeriği, artı bir ürün primi, artı ürün başına sabit bir ücrettir. Primi ürün bazında saklayın, spot fiyatı planınızın güncelleme aralığında yenileyin ve müşterilere fiyatın en son ne zaman güncellendiğini gösterin. Standard ve üzeri planlarda, piyasanın kendi makasından iki tarafı da kote etmek için currencies parametresine XAG-BID ve XAG-ASK ekleyin. Spot, alış ve satış fiyatları yazısı, satıcıların bu rakamları alış ve satış tekliflerine nasıl dönüştürdüğünü gösteriyor.

Gümüş eşya, kuyum ve hurda alıcıları. Gümüş eşyalar ağırlığa ve milyeme, yani binde kaç birim saf gümüş içerdiklerine göre fiyatlanır. Yaygın standartlar 999 (saf gümüş), 958 (Britannia), 925 (sterling) ve eski kıta Avrupası gümüş eşyalarında rastlanan 800'dür. Eritme değeri, gram cinsinden ağırlık × milyem × gram fiyatıdır. Gram başına 1,7342 dolarlık örnek fiyatla 500 gramlık sterling bir tepsi, yaklaşık 802,07 dolar değerinde 462,5 gram gümüş içerir. Hurda alıcıları eritme değerinin bir yüzdesini öder; bu nedenle bu yüzdeyi sabit bir değer yerine bir ayar olarak tanımlayın.

MetalAPI'nin ayar endpoint'i /carat yalnızca altını kapsar; bu nedenle gümüş milyemi sizin tarafınızda yapılan bir hesaplamadır:

const GRAMS_PER_TROY_OZ = 31.1034768;

/** Bir gümüş eşyanın eritme değeri: gram cinsinden ağırlık × milyem (ör. 0.925) × gram fiyatı. */
export function meltValue(grams, fineness, pricePerTroyOz) {
  return grams * fineness * (pricePerTroyOz / GRAMS_PER_TROY_OZ);
}

meltValue(500, 0.925, 53.94); // 802.07…  örnek fiyatla sterling tepsi
meltValue(1000, 0.999, 53.94); // 1732.48… 999 gümüşten bir kilogramlık külçe

Yatırım ve portföy uygulamaları. Kullanıcılar sikke, yuvarlak gümüş ve kilogramlık külçe tutar ve bunların değerini kendi para birimlerinde görmek ister. Varlıkları dahili olarak troy ons cinsinden saklayın, girdi birimini bir kez dönüştürün ve portföyü kullanıcının para birimini base olarak kullanarak değerleyin. /change, “bu ay gümüş” gibi satırlar için iki tarih arasındaki yüzde hareketi döndürür; /timeframe ile alınıp saklanan günlük kapanışlar ise grafikleri besler.

Fiyat alarmları. Yalnızca gümüş belirli bir seviyeyi geçtiğinde tepki vermeniz gerekiyorsa fiyat alarmları XAG değerini herhangi bir para biriminde izleyebilir ve sizin tarafınızda hiçbir sorgulama gerekmeden Lite planından itibaren e-postayla, Advanced planından itibaren ise imzalı webhook ile bildirim gönderebilir.

Güncellik, kotalar ve planlar

Gümüş fiyatının ne kadar güncel olduğu plana bağlıdır. Planınızın güncelleme aralığından daha sık sorgulamak yalnızca aynı rakamları yeniden döndürür:

• En az güncelleme aralığınız kadar önbelleğe alın. Free planda güncel fiyatlar için günde bir istek yeterlidir.
• Tüm metalleri tek çağrıda isteyin. currencies=XAU,XAG,XPT,XPD tek bir isteğe mal olur; dört ayrı çağrı ise dört isteğe.
• Anahtarı sunucuda tutun. API'yi her ziyaretçinin tarayıcısından çağırmak yerine sayfalarınıza önbellekteki fiyatları sunun.
• Kullanımı ücretsiz kontrol edin. /usage ve /symbols hiçbir zaman kotadan düşülmez ve her yanıt bir rate_limit bloğu taşır.

Geliştirmeye hazır mısınız? Kredi kartı gerekmeden bir dakikada API anahtarı almak için ücretsiz bir hesap oluşturun. Güncelleme aralıklarını ve kotaları fiyatlandırma sayfasında karşılaştırın; tüm endpoint'ler ve parametreler için başvuru kaynağı olarak API dokümantasyonunu kullanın.

SSS

Bir fiyat API'sinde gümüşün sembolü nedir?

Bir troy ons gümüşün ISO 4217 kodu olan XAG. MetalAPI'de gümüşün baz para biriminizdeki fiyatı, iki kodu birleştiren anahtardır; örneğin ons başına dolar için USDXAG, ons başına euro için EURXAG.

Ücretsiz bir gümüş fiyatı API'si var mı?

Evet. MetalAPI'nin Free planı gümüşü, diğer tüm sembolleri ve geçmişin tamamını ayda 100 istek ve günlük fiyat güncellemeleriyle içerir ve kredi kartı gerektirmez. Ücretli planlar, 30 dakikalık güncellemeler ve 1.000 istek için ayda 4,99 $'dan başlar.

Gümüşün gram fiyatını nasıl alırım?

unit=gram gönderin veya troy ons başına fiyatı 31,1034768'e bölün. 28,35'e bölmeyin: bu avoirdupois onstur ve gram fiyatını yaklaşık %9,7 fazla gösterir.

Geçmiş gümüş fiyatları ne kadar geriye gider?

Günlük gümüş fiyatları her planda 2000 yılından itibaren mevcuttur. Tek bir aralık isteği Free planda en fazla 30 günü, ücretli planlarda en fazla 365 günü kapsar.

Bir satıcının gümüş fiyatı neden API fiyatından farklı?

API, toptan piyasanın spot orta fiyatını döndürür. Satıcılar satarken basım, dağıtım ve kendi kâr marjları için prim ekler, geri alırken ise spot fiyatın altında öder; bu nedenle sikke ve külçelerin perakende fiyatları spot fiyatın üzerinde, geri alım fiyatları ise altında yer alır.