Yerel Para Biriminde Gram Altın Fiyatı: API ile INR, AED, TRY

Yerel para biriminizde altının gram fiyatı

Alıcıların çoğunun baktığı rakam altının gram fiyatıdır. Chennai'deki bir kuyumcu, Dubai Altın Çarşısı'ndaki bir müşteri ve İstanbul'da gram altını takip eden bir birikimci gram ve kendi para birimi cinsinden düşünür; uluslararası piyasa ise altını troy ons başına ABD doları cinsinden fiyatlar. Bu ikisini iki dönüşüm birbirine bağlar: troy onstan grama ve dolardan yerel para birimine.

altının gram fiyatı (yerel) = troy ons başına USD fiyatı ÷ 31,1034768 × USD başına yerel para birimi

Bu rehber, bu rakamı MetalAPI'den nasıl alacağınızı, bazı piyasaların kullandığı 10 gram ve tola fiyatlarını nasıl türeteceğinizi, rakamı yerel okuyucular için nasıl biçimlendireceğinizi ve yerel bir dükkânın fiyatının neden nadiren dönüştürülmüş spot fiyata eşit olduğunu gösteriyor.

Altının gram fiyatını API ile istemek

MetalAPI her iki dönüşümü de sunucuda yapar: unit=gram troy ons fiyatını gram fiyatına çevirir, base ise para birimini belirler. İkisi de Free dahil her planda çalışır:

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

Fiyat, baz para birimi ile sembolü birleştiren anahtarda yer alır; burada INRXAU: saf altının gram başına rupi fiyatı. Aşağıdaki yanıt, dokümantasyondaki örnek altın fiyatını (troy ons başına 3.997,89 USD) ve dolar başına 88,00 rupilik varsayılan bir kuru kullanır. İkisi de canlı kotasyon değil, örnektir:

{
  "success": true,
  "timestamp": 1792834892,
  "date": "2026-10-24",
  "base": "INR",
  "unit": "gram",
  "rates": {
    "XAU": 0.00008840878563,
    "INRXAU": 11311.09304
  }
}

• Tek bir anlık görüntü. Altın fiyatı ve döviz kuru aynı andan gelir; bu nedenle ayrı bir döviz çağrısı gerekmez ve ikisi arasında kayma olmaz.
• Öneksiz anahtar ters kurdur. Burada XAU, rupi başına gram altın miktarını tutar. Önekli anahtarı gösterin; veri formatları rehberi her iki yönü de açıklar.
• Tola veya 10 gram birimi yoktur. unit; troy_oz (varsayılan), gram, kilogram, ounce, pound, metric_ton ve short_ton değerlerini kabul eder; diğer her değer 209 (invalid_unit) hatası döndürür. İkisi de gram fiyatından tek bir çarpma uzaklıktadır.

Piyasaya göre altının gram fiyatı: formüller

Perakende alışkanlıkları ülkeden ülkeye değişir. Tablo, birkaç büyük piyasadaki olağan kotasyonu ve bunun API'nin 24 ayar gram fiyatından nasıl türetileceğini gösteriyor. Diğer ayarlar için K ÷ 24 ile çarpın ya da ücretli bir planda /carat kullanın.

Örnek altın fiyatına uygulandığında formüller şu rakamları verir. Dokümantasyondaki örnek olan euro kuru (euro başına 1,1642 USD) dışındaki döviz kurları açıklama amacıyla varsayılmıştır:

Gram ve tola sütunlarının arkasındaki kesin çarpanlar birim dönüştürme yazısında yer alır.

Hindistan rupisi cinsinden altının gram fiyatı

Hindistan'da altın genellikle 24 ayar (999) ve kuyumculuk standardı olan 22 ayar (916) için fiyatlanır. base=INR&unit=gram, 24 ayarın gram fiyatını döndürür. 22 ayar için 22 ÷ 24 ile çarpın ya da ücretli bir planda bu fiyatı /carat endpoint'inden isteyin:

curl "https://metalapi.com/api/v1/carat?carat=22&unit=gram&base=INR" \
  -H "X-API-Key: $METALAPI_KEY"

Temsili kurla 24 ayar altının gramı 11.311,09 rupi, 22 ayarın gramı ise 10.368,50 rupi olur. Altın ayar fiyatları yazısı saflık çarpanlarını ve 916 ile 750 gibi milyem damgalarını ele alır.

10 gram altın fiyatı

Hindistan'daki birçok fiyat panosu, gazete ve karşılaştırma sitesi altını 10 gram başına fiyatlar; Pakistan'daki fiyatlar da çoğu zaman tola fiyatının yanında 10 gram fiyatını gösterir. Gram fiyatını isteyip 10 ile çarpın ve yuvarlamadan önce çarpın: gram fiyatını önce tam rupiye yuvarlamak, 10 gram fiyatını beş rupiye kadar kaydırabilir.

import os
from decimal import Decimal, ROUND_HALF_UP

import requests

TOLA_G = Decimal("11.6638038")  # 180 grain
RUPEE = Decimal("1")

r = requests.get(
    "https://metalapi.com/api/v1/latest",
    params={"base": "INR", "currencies": "XAU", "unit": "gram"},
    headers={"X-API-Key": os.environ["METALAPI_KEY"]},
    timeout=10,
)
data = r.json(parse_float=Decimal)
if not data["success"]:
    raise RuntimeError(data["error"])

per_gram = data["rates"]["INRXAU"]  # 24 ayar, gram başına rupi
for karat in (24, 22):
    g = per_gram * karat / 24
    print(
        f"{karat}K  1 g: {g.quantize(RUPEE, ROUND_HALF_UP)}"
        f"  10 g: {(g * 10).quantize(RUPEE, ROUND_HALF_UP)}"
        f"  1 tola: {(g * TOLA_G).quantize(RUPEE, ROUND_HALF_UP)}"
    )

Yukarıdaki temsili yanıtla betik 24 ayar için 11311, 113111 ve 131930 rupi, 22 ayar için 10369, 103685 ve 120936 rupi yazdırır. parse_float=Decimal, fiyatları ikili kayan noktalı sayıların (float) dışında tutar; bu, bir rakam faturaya girdiğinde önem kazanır.

Tola başına altın fiyatı

Tola, Güney Asya'nın geleneksel altın ağırlık birimidir; Pakistan'da ve Nepal'de hâlâ yaygın olarak kullanılır, Körfez piyasalarında da on tolalık külçeler (116,64 g) bilinen bir üründür. 180 grain olarak tanımlanır: tam olarak 11,6638038 gram, yani troy onsun sekizde üçü. API'de tola birimi olmadığından iki yoldan biriyle dönüştürün:

tola fiyatı = gram fiyatı × 11,6638038 = troy ons fiyatı × 0,375

Örnek fiyatla ikisi de tola başına 1.499,21 USD verir. Bir fiyat listesi veya sözleşme yuvarlanmış bir tola ağırlığı kullanıyorsa gram ağırlığını bir yapılandırma değeri yapın, sayfada gösterin ve aynı tabloda asla kesin tola değeriyle karıştırmayın.

Dubai'de altının gram fiyatı (AED)

Dubai'deki kuyumcular ve yayımlanan fiyat panoları fiyatları gram başına dirhem cinsinden, genellikle 24, 22, 21 ve 18 ayar için listeler. Ücretli bir planda tek bir /carat isteği tüm ayarları döndürür; Free planda /latest endpoint'inden base=AED&unit=gram isteyin ve K ÷ 24 oranını kendiniz uygulayın:

curl "https://metalapi.com/api/v1/carat?carat=all&unit=gram&base=AED" \
  -H "X-API-Key: $METALAPI_KEY"

BAE dirhemi ABD dolarına 3,6725'ten sabitlenmiştir; bu nedenle dirhem cinsinden altın fiyatları dolar fiyatıyla neredeyse bire bir hareket eder: örnek fiyatla 24 ayarın gramı yaklaşık 472,05 AED, 22 ayarınki 432,71 AED'dir. Suudi riyali (3,75'ten sabit), Katar riyali, Bahreyn dinarı ve Umman riyali de dolara sabitlenmiştir. Yine de sabit kodlanmış bir kur yerine API'nin kurunu kullanın; böylece kod her para birimi için aynı kalır.

Gram altın: Türk lirası cinsinden altının gram fiyatı

Türkiye'de bir gram 24 ayar altının lira cinsinden fiyatı olan gram altın, çeyrek gibi sikke fiyatlarıyla birlikte insanların en yakından takip ettiği altın fiyatıdır. base=TRY&unit=gram bu fiyatı TRYXAU olarak döndürür: örnek altın fiyatı ve dolar başına varsayılan 42,00 lirayla gram başına 5.398,48 lira.

Lira cinsinden altın fiyatı, dolar cinsinden altını ve lira cinsinden doları birleştirir; bu nedenle altının kendisi yatay seyrederken bile yükselebilir. Bir hareketi açıklamak için varsayılan baz USD ile /change?currencies=XAU,TRY, iki tarih arasında dolar cinsinden altındaki (USDXAU) ve dolar başına liradaki (TRY) yüzde değişimi döndürür. Gram altındaki değişim (1 + altındaki değişim) × (1 + kurdaki değişim) − 1 olur.

Kod örneği: tek istekte birden fazla piyasa

Birden fazla ülkeyi gösteren bir pano, her para birimi için ayrı bir çağrıya ihtiyaç duymaz. Varsayılan baz USD değerini koruyun ve gram başına altını para birimleriyle birlikte isteyin: unit yalnızca metal fiyatını değiştirir; rates.INR gibi her döviz anahtarı ise dolar başına o para biriminden kaç birim olduğunu tutar. İkisinin çarpımı yerel gram fiyatıdır ve tüm pano tek bir isteğe mal olur:

const TOLA_GRAMS = 11.6638038;

// Her piyasa: para birimi, gösterim yerel ayarı, gösterilecek ayarlar ve ağırlıklar (gram)
const MARKETS = [
  { currency: "INR", locale: "en-IN", karats: [24, 22], weights: { gram: 1, "10 g": 10 } },
  { currency: "PKR", locale: "en-PK", karats: [24, 22], weights: { tola: TOLA_GRAMS, "10 g": 10 } },
  { currency: "AED", locale: "en-AE", karats: [24, 22, 21, 18], weights: { gram: 1 } },
  { currency: "TRY", locale: "tr-TR", karats: [24], weights: { gram: 1 } },
  { currency: "EUR", locale: "de-DE", karats: [24], weights: { gram: 1 } },
];

const url = new URL("https://metalapi.com/api/v1/latest");
url.searchParams.set("currencies", ["XAU", ...MARKETS.map((m) => m.currency)].join(","));
url.searchParams.set("unit", "gram"); // yalnızca XAU'yu etkiler; döviz kurları değişmez

const res = await fetch(url, { headers: { "X-API-Key": process.env.METALAPI_KEY } });
const data = await res.json();
if (!data.success) throw new Error(`${data.error.code}: ${data.error.info}`);

const usdPerGram = data.rates.USDXAU; // 24 ayar altın, gram başına USD
for (const m of MARKETS) {
  const perUsd = data.rates[m.currency]; // 1 USD karşılığı para birimi miktarı
  if (perUsd === undefined) continue;
  const fmt = new Intl.NumberFormat(m.locale, { style: "currency", currency: m.currency });
  for (const karat of m.karats) {
    for (const [label, grams] of Object.entries(m.weights)) {
      const price = usdPerGram * perUsd * grams * (karat / 24); // yalnızca format() ile yuvarlanır
      console.log(`${m.currency} ${karat}K per ${label}: ${fmt.format(price)}`);
    }
  }
}
// örn. temsili 88.00 INR/USD kuruyla "INR 24K per 10 g: ₹1,13,110.93"
console.log("As of", new Date(data.timestamp * 1000).toISOString());

Yerel altın fiyatları neden dönüştürülmüş spot fiyattan farklıdır

API, saf altının uluslararası spot fiyatını piyasa döviz kuruyla dönüştürülmüş olarak döndürür. Bir kuyumcunun panosu veya bir külçe birliğinin günlük fiyatı bu referanstan başlar ve yerel maliyetleri ekler; bu nedenle genellikle daha yüksektir:

• İthalat vergileri. Altınının çoğunu ithal eden ülkeler genellikle gümrük vergisi uygular; bu da yerel toptan fiyatı dönüştürülmüş uluslararası fiyatın üzerine çıkarır. Oranlar bütçelere ve ticaret politikasına göre değişir.
• GST ve KDV. Hindistan altına GST uygular, BAE ve Suudi Arabistan gibi Körfez ülkeleri KDV uygular; AB ise yatırımlık altını KDV'den muaf tutar, ancak mücevheri tutmaz. Birçok sistem külçe ve sikkeleri, mücevherden ve işçilik ücretlerinden farklı değerlendirir.
• İşçilik ve fire. İşçilik gram başına, yüzde olarak veya parça başına ücretlendirilir; bazı piyasalar ayrıca bir fire payı ekler.
• Satıcı primleri ve makaslar. Satıcılar referansın üzerinde satar ve altında geri alır; küçük külçe ve sikkeler gram başına büyük külçelerden daha yüksek prim taşır.
• Yerel arz ve talep. Güçlü talep veya ithalat kısıtlamaları yerel fiyatı, ülkeye getirilmiş uluslararası fiyatın üzerinde bir prime itebilir; zayıf talep ise iskontoya.
• Zamanlama ve döviz kuru. Yerel fiyatlar çoğu zaman günde bir veya birkaç kez, bir bankanın ya da birliğin kendi döviz kuruyla belirlenir; spot fiyat ise sürekli hareket eder.
• Saflık. Yerel bir kotasyon 995 külçeleri veya 22 ayar mücevher altınını ifade edebilir, INRXAU ise saf altındır. Aynı şeyleri karşılaştırın.

Bunları tek bir opak kâr marjı yerine API fiyatının üzerine eklenen, adlandırılmış ve belgelenmiş parametreler olarak modelleyin; gümrük ve vergi oranlarını resmi kaynaklardan veya vergi danışmanınızdan alın. Ardından yayımladığınız şeyi doğru etiketleyin: "INR'ye dönüştürülmüş uluslararası spot fiyat" ile "bugün Mumbai'deki altın fiyatı" aynı iddia değildir.

Gösterim ipuçları: yerel sayı biçimlendirme

• Yerel ayarın sayı biçimini kullanın. Hint İngilizcesi basamakları lakh ve crore olarak gruplar (₹1,13,110.93), Türkçe binlik ayırıcı olarak nokta, ondalık ayırıcı olarak virgül kullanır (₺5.398,48), Almanca ise euro işaretini sona koyar (110,41 €). Bu işi Intl.NumberFormat ya da platformunuzun yerel ayar kütüphanesi yapsın.
• Ondalık basamak sayısını bilinçli seçin. Çoğu para birimi iki ondalık basamak kullanır; Kuveyt dinarı, Bahreyn dinarı ve Umman riyali üç basamak kullanır. 10 gram veya tola başına rupi panoları genellikle tam rupi gösterir; bu nedenle orada maximumFractionDigits: 0 verin.
• Rakam sistemini seçin. ar-SA gibi bazı Arapça yerel ayarlar varsayılan olarak Arap-Hint rakamlarını kullanır. Latin rakamları için ar-SA-u-nu-latn gibi bir yerel ayar kullanın.
• Ayarı, ağırlığı ve para birimini etiketleyin. "22 ayar, 10 g başına, INR" şüpheye yer bırakmaz.
• Yerel saati gösterin. timestamp UTC'dir; onu Asia/Kolkata, Asia/Dubai veya Europe/Istanbul saat diliminde biçimlendirin. Spot altın New York saatiyle cuma 17:00'de kapanır ve pazar 17:00'de yeniden açılır; bu nedenle hafta sonu fiyatını piyasa kapanışı olarak işaretleyin.

Yerel para biriminde geçmiş gram altın fiyatları

base ve unit geçmiş veri endpoint'lerinde de çalışır; bu nedenle rupi veya dirhem cinsinden gram altın grafiği ek bir dönüşüm gerektirmez. Günlük geçmiş her planda metaller için 2000'e, para birimleri için 1999'a kadar uzanır; tek bir /timeframe isteği Free planda en fazla 30, ücretli planlarda 365 günü kapsar:

curl "https://metalapi.com/api/v1/timeframe?base=INR&currencies=XAU&unit=gram&start_date=2026-09-24&end_date=2026-10-23" \
  -H "X-API-Key: $METALAPI_KEY"

Değerler günlük kapanışlardır; hafta sonları ve tatiller eksik olabilir. Ekim 2026'dan önceki metal fiyatları en yakın vadeli futures kontratlarından türetilmiştir; bu nedenle spot fiyattan biraz farklı olabilir.

Piyasanız için gram altın fiyatlarını alın

Yerel bir altın fiyatı sayfası oluşturmak için ücretsiz bir anahtar almak üzere kaydolun, para biriminizi base olarak vererek unit=gram isteyin ve 10 gram, tola ve ayar fiyatlarını yukarıda gösterildiği gibi türetin. Free plan, günlük güncellemelerle ayda 100 istek içerir; bu, geliştirip test etmeye yeter. Canlı bir pano için Lite 30 dakikada bir güncellenir ve /carat ekler, Standard 10 dakikada bir güncellenir ve alış/satış fiyatlarını ekler, en hızlı plan ise 5 saniyede bir güncellenir. Fiyatlandırma sayfası planları karşılaştırır; semboller sayfası desteklenen tüm para birimlerini listeler.

Sık sorulan sorular

API altın fiyatlarını tola veya 10 gram başına döndürüyor mu?

Birim olarak hayır. unit=gram isteyin ve 10 ile ya da tola için 11,6638038 ile çarpın; veya varsayılan troy ons fiyatını 0,375 ile çarpın. unit=tola, 209 hatası döndürür.

API fiyatı neden yerel kuyumcumun altın fiyatından düşük?

API, saf altının uluslararası spot fiyatını piyasa döviz kuruyla döndürür. Yerel fiyatlar ithalat vergilerini, GST'yi veya KDV'yi, işçilik ücretlerini, satıcı primlerini ve yerel arz ile talebi ekler; ayrıca daha düşük bir saflığa veya daha önceki bir fiyat tespitine (fixing) dayanıyor olabilir.

Hangi yerel para birimleri destekleniyor?

57 para birimi; bunlar arasında Güney Asya'da INR, PKR, BDT ve LKR, Körfez'de AED, SAR, QAR, KWD, BHD ve OMR, ayrıca TRY, EGP, EUR ve GBP bulunur. Bunların herhangi biri base olarak çalışır; /api/v1/symbols ise tam listeyi kotanızdan düşülmeden döndürür.

Altının gram fiyatı ne sıklıkla güncellenir?

Planınızın izin verdiği sıklıkta: Free planda günlük, Lite'ta 30 dakikada bir, Standard'da 10 dakikada bir, Advanced ve Pro'da 60 saniyede bir, Ultra ve Business'ta 15 saniyede bir, Enterprise'da ise 5 saniyede bir. Hafta sonu boyunca fiyat cuma kapanışında kalır.

Kendi para birimimde 22 veya 21 ayar altının gram fiyatını alabilir miyim?

Evet. Ücretli planlarda carat=22, carat=21 veya carat=all ile birlikte unit=gram ve kendi base değerinizle çağrılan /carat, hazır ayar fiyatları döndürür. Free planda 24 ayar gram fiyatını K ÷ 24 ile çarpın.