Altın Ayar Fiyatları: 24, 22 ve 18 Ayar Nedir, Nasıl Hesaplanır?

Ayar, karat ve saflık

Ayar, altının ağırlığını değil saflığını ölçer. Saf altın 24 ayardır; dolayısıyla bir alaşımdaki altın oranı, ayar sayısının 24'e bölünmesiyle bulunur. 18 ayar altın, 18 birim altın ile alaşımı sertleştiren, rengini değiştiren ve maliyetini düşüren gümüş, bakır, çinko veya paladyum gibi 6 birim başka metalden oluşur.

Ayar (İngilizcede karat; K veya kt) ile karat (ct) kolayca karıştırılır. Türkçede ayar altının saflığını, karat ise değerli taşları tartmak için kullanılan 200 miligramlık birimi ifade eder. İngilizcede durum daha karışıktır: Amerikan İngilizcesinde karat saflık, carat taş ağırlığı anlamına gelirken İngiliz İngilizcesi çoğu zaman ikisi için de carat kullanır. MetalAPI endpoint'i bu daha geniş kullanımı izleyerek /carat adını taşır, ancak değerli taş ağırlığına göre değil, saflığa göre altın fiyatları döndürür.

Ayar fiyatını altın piyasasına bağlayan formül kısadır:

K ayar altının gram fiyatı = troy ons başına spot fiyat ÷ 31,1034768 × K ÷ 24

Bu yazı formülün her bir parçasını açıklıyor, hesaplamayı kendiniz nasıl yapacağınızı ve API'den nasıl alacağınızı gösteriyor, ardından bir ayar altın fiyatını bitmiş bir mücevherin fiyatından ayıran unsurlara bakıyor.

Ayar saflığı ve milyem

Birçok ülke altını ayarın yerine veya yanında milyem ile, yani binde kaç birim altın içerdiğiyle damgalar. İki ölçek birbirine doğrudan karşılık gelir:

Bu tabloyu fiyatlara dönüştürürken iki ayrıntı önemlidir:

• Damgalar asgari standartlardır. 585 damgası en az %58,5 altın anlamına gelir; bu, 14 ÷ 24 = %58,33'ten biraz fazladır. Her ülke kendi standartlarını ve toleranslarını belirler; bu nedenle bir parçanın gerçek milyemi ayar oranının biraz üzerinde olabilir.
• Saf altın tam olarak 1,0000 değildir. Yatırımlık külçeler genellikle 999,9 veya 999 milyemdir. MetalAPI'deki 24 ayar fiyatı tam olarak 1 saflık kullanır; bu da onu spot fiyata eşit kılar.

Hangi ayarların önemli olduğu, nerede satış yaptığınıza bağlıdır. 22 ve 21 ayar Güney Asya'da ve Orta Doğu'nun büyük bölümünde mücevherde geleneksel ayarlardır; 18 ve 14 ayar Avrupa'da ve Kuzey Amerika'da yaygındır, 9 ayar ise Birleşik Krallık'ta sık görülür. Müşterilerinizin gerçekte satın aldığı ayarları destekleyin.

Ayar fiyatlarını kendiniz hesaplamak

Spot altın, bir troy ons saf altın başına fiyatlanır. Gram başına ayar fiyatını bulmak için birimi dönüştürüp ardından saflıkla ölçeklendirin. MetalAPI dokümantasyonundaki örnek spot fiyatla, yani troy ons başına 3.997,89 USD ile (canlı bir fiyat değil, bir örnek):

1. Saf altının gram fiyatı: 3.997,89 ÷ 31,1034768 = 128,5351 USD.
2. 22 ayar altının gram fiyatı: 128,5351 × 22 ÷ 24 = 117,8239 USD.
3. 18 ayar altının gram fiyatı: 128,5351 × 18 ÷ 24 = 96,4014 USD.

Aynı hesaplama JavaScript ile; ayar yerine milyeme göre fiyatlandırma için ikinci bir fonksiyonla birlikte:

const GRAMS_PER_TROY_OZ = 31.1034768;

/** Belirli bir ayardaki altının gram fiyatı (24 = saf altın). */
export function karatPricePerGram(spotPerTroyOz, karat) {
  return (spotPerTroyOz / GRAMS_PER_TROY_OZ) * (karat / 24);
}

/** 585 veya 916 gibi bir milyem değerinde gram fiyatı. */
export function finenessPricePerGram(spotPerTroyOz, fineness) {
  return (spotPerTroyOz / GRAMS_PER_TROY_OZ) * (fineness / 1000);
}

const spot = 3997.89; // örnek fiyat, troy ons başına USD
for (const k of [24, 22, 21, 18, 14, 10, 9]) {
  console.log(`${k}K`, karatPricePerGram(spot, k).toFixed(4));
}
// 24K 128.5351, 22K 117.8239, 21K 112.4683, 18K 96.4014, 14K 74.9788, 10K 53.5563, 9K 48.2007
console.log("585", finenessPricePerGram(spot, 585).toFixed(4)); // 75.1931

Altın fiyatı ile döviz kurunun aynı andan gelmesi için satış yaptığınız para biriminde verilmiş bir spot fiyattan (base=EUR, base=INR vb.) başlayın. Dolar cinsinden bir gram fiyatını başka bir zamanda alınmış bir döviz kuruyla dönüştürmek, altınla hiçbir ilgisi olmayan bir hata ekler.

Ayar yerine damgaya göre fiyatlandırıyorsanız milyem fonksiyonunu kullanın. 583,3 ile 585 arasındaki fark, metal değerinin yaklaşık %0,3'üdür: gram başına küçüktür, ancak ağır bir zincirde fark edilir. Hangisini seçerseniz seçin, tutarlı biçimde kullanın ve belgeleyin.

/carat endpoint'inden ayar fiyatlarını almak

MetalAPI bu hesaplamayı sizin yerinize, Lite'tan başlayarak tüm ücretli planlarda kullanılabilen /carat endpoint'inde yapar. Endpoint şu parametreleri alır:

• carat: 24 (varsayılan), 23, 22, 21, 20, 18, 16, 14, 12, 10, 9, 8 veya all.
• base: fiyatların para birimi, varsayılan olarak USD.
• unit: varsayılan olarak troy_oz; kuyumculukta genellikle gram tercih edilir.
• date: geçmiş bir günün ayar fiyatları için isteğe bağlı bir YYYY-MM-DD tarihi.

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

API referansındaki örnek değerlerle yanıt:

{
  "success": true,
  "carat": "22",
  "date": "2026-10-24",
  "base": "EUR",
  "timestamp": 1792834892,
  "rates": {
    "XAU22K": { "price": 105.5297, "unit": "gram", "carat": "22", "purity": 0.916667 }
  }
}

carat=all ile tüm ayarları tek bir istekte alırsınız; bu, tek bir ayarla aynı maliyettedir. Her kayıt XAU<karat>K biçiminde anahtarlanır ve fiyatı, birimi, ayarı ve uygulanan saflığı taşır. Bu örnek kısaltılmıştır:

{
  "success": true,
  "carat": "all",
  "date": "2026-10-23",
  "base": "USD",
  "timestamp": 1792765800,
  "rates": {
    "XAU24K": { "price": 128.53515, "unit": "gram", "carat": "24", "purity": 1 },
    "XAU22K": { "price": 117.82389, "unit": "gram", "carat": "22", "purity": 0.916667 },
    "XAU18K": { "price": 96.401361, "unit": "gram", "carat": "18", "purity": 0.75 },
    "XAU14K": { "price": 74.978836, "unit": "gram", "carat": "14", "purity": 0.583333 }
  }
}

Node.js 18 veya sonrasında tüm ayarları gram başına BAE dirhemi cinsinden okumak:

const params = new URLSearchParams({ carat: "all", unit: "gram", base: "AED" });
const res = await fetch(`https://metalapi.com/api/v1/carat?${params}`, {
  headers: { "X-API-Key": process.env.METALAPI_KEY },
});
const data = await res.json();
if (!data.success) throw new Error(`${data.error.code} ${data.error.type}: ${data.error.info}`);

for (const row of Object.values(data.rates)) {
  console.log(`${row.carat}K: ${row.price.toFixed(2)} ${data.base} per ${row.unit}`);
}

Yerel para biriminizde fiyatlandırma

Mücevher yerel para birimiyle alınıp satılır; bu nedenle base değerini mağazanın para birimine ayarlayın: rupi için INR, dirhem için AED, lira için TRY, sterlin için GBP. Desteklenen 57 para biriminin tümü çalışır ve altın ile döviz kuru tek bir anlık görüntüden geldiği için rakamlar birbiriyle tutarlıdır.

# Tüm ayarlar, gram başına Hindistan rupisi cinsinden
curl "https://metalapi.com/api/v1/carat?carat=all&unit=gram&base=INR" \
  -H "X-API-Key: $METALAPI_KEY"

# Geçmiş bir günde gram başına Türk lirası cinsinden 22 ayar
curl "https://metalapi.com/api/v1/carat?carat=22&unit=gram&base=TRY&date=2026-10-01" \
  -H "X-API-Key: $METALAPI_KEY"

Tola ile fiyatlanan piyasalar için gram fiyatını 11,6638038 ile ya da troy ons fiyatını 0,375 ile çarpın. 10 tolalık bir külçe 116,638 g ağırlığındadır. Birim dönüştürme yazısı, tola, tael ve pennyweight için kesin çarpanları içerir.

Üç pratik nokta:

• Güncellik planınıza bağlıdır. /carat, planınızın izin verdiği güncellikte fiyatlar döndürür: Lite'ta 30 dakikada bir, Standard'da 10 dakikada bir, Enterprise'da ise 5 saniyeye kadar. Fiyat panosunu günde birkaç kez güncelleyen bir mağazanın en hızlı plana ihtiyacı yoktur.
• Zaman damgasını gösterin. timestamp alanı, müşterilere ve denetçilere fiyatın ne zaman alındığını gösterir.
• Hafta sonları. Spot altın, New York saatiyle cuma 17:00'de işleme kapanır ve pazar 17:00'de yeniden açılır; bu nedenle ayar fiyatları hafta sonu boyunca cuma gününün son fiyatında kalır.

Ayar fiyatından mücevher fiyatına

Ayar fiyatı, altın içeriğinin değeridir. Bitmiş bir parçanın fiyatına ise birkaç bileşen eklenir ve bunların nasıl hesaplandığı ülkeye, ticari teamüllere ve işletmeye göre değişir. Olağan yapı taşları şunlardır:

• Metal değeri: net altın ağırlığı × gram başına ayar fiyatı. Taşlar, inciler ve altın olmayan diğer parçalar ayrıca tartılır ve hesaba katılmaz.
• İşçilik: gram başına, metal değerinin yüzdesi olarak veya parça başına sabit bir tutar şeklinde alınan emek ve tasarım ücreti. Bazı piyasalar üretimde kaybolan metal için ayrıca bir fire payı ekler.
• Taşlar ve diğer malzemeler: kendi koşullarına göre fiyatlanır.
• Damgalama veya sertifikasyon ücretleri, uygulandığı yerlerde.
• Vergi: KDV, GST veya satış vergisi. Oranlar ve kurallar ülkeye göre farklılık gösterir ve bazı ülkeler yatırımlık altını mücevherden farklı vergilendirir. Örneğin AB'de yatırımlık altın, mücevheri kapsamayan özel bir KDV muafiyetine tabidir.

İşte bu parçaları ayrı tutan minimal bir fiyat teklifi hesaplayıcısı. Faturadaki kuruşların tutması için baştan sona Decimal kullanır:

from dataclasses import dataclass
from decimal import Decimal, ROUND_HALF_UP

CENT = Decimal("0.01")


@dataclass
class QuoteInput:
    weight_g: Decimal  # net altın ağırlığı, taşlar hariç
    karat_price_per_g: Decimal  # /carat?unit=gram yanıtından, kendi para biriminizde
    making_per_g: Decimal = Decimal("0")  # gram başına sabit işçilik ücreti
    making_pct: Decimal = Decimal("0")  # veya metal değerinin bir oranı
    stones: Decimal = Decimal("0")  # ayrıca fiyatlandırılır
    tax_rate: Decimal = Decimal("0")  # bulunduğunuz ülkedeki KDV, GST veya satış vergisi


def jewelry_quote(q: QuoteInput) -> dict:
    metal = q.weight_g * q.karat_price_per_g
    making = q.weight_g * q.making_per_g + metal * q.making_pct
    subtotal = metal + making + q.stones
    tax = subtotal * q.tax_rate
    parts = {"metal": metal, "making": making, "stones": q.stones, "tax": tax, "total": subtotal + tax}
    return {k: v.quantize(CENT, rounding=ROUND_HALF_UP) for k, v in parts.items()}


# Yalnızca örnek girdiler: gram başına 117.8239 örnek fiyatla 10 g 22 ayar,
# %12 işçilik ve %20 vergi oranı.
print(jewelry_quote(QuoteInput(
    weight_g=Decimal("10"),
    karat_price_per_g=Decimal("117.8239"),
    making_pct=Decimal("0.12"),
    tax_rate=Decimal("0.20"),
)))

Bu girdilerle betik 1.178,24 metal değeri, 141,39 işçilik, 263,93 vergi ve toplam 1.583,55 yazdırır. İşçilik ücreti ve vergi oranı yalnızca yer tutucudur, öneri değildir. Verginin nerede, hangi bileşenlere ve hangi oranda uygulanacağı muhasebecinize veya vergi danışmanınıza sorulması gereken sorulardır.

Geri alım ve hurda değerleri

Müşterilerden altın geri almak tersi yönde işler. Başlangıç noktası aynı metal değeridir, ancak bu değer damgadaki ayara değil, gerçekte ölçülen milyeme dayanmalıdır:

hurda değeri = gram cinsinden ağırlık × milyem ÷ 1.000 × gram başına spot fiyat − rafineri ve işlem kesintileri

Alıcılar milyemi genellikle XRF analizi veya asit testleri gibi yöntemlerle ölçer; çünkü eski parçalar damgalarının altında kalabilir ve zincirlerdeki lehim ortalama saflığı düşürür. Kesintiyi düşük bir spot fiyatın içine gizlemek yerine kodunuzda açık, belgelenmiş bir parametre olarak tutun; böylece fiyat tekliflerinde ve denetimlerde açıkça görünür.

Burada spot fiyat olarak gram başına 24 ayar fiyatını (veya unit=gram ile /latest) kullanın ve ölçülen milyemi kendiniz uygulayın. /carat endpoint'inden gelen ayar fiyatları tam olarak K ÷ 24 oranını varsayar; bu, yeni ürünleri ayara göre fiyatlandırmak için doğrudur, ancak 912 gibi bir ölçüm sonucu için doğru değildir.

Uygulama kontrol listesi

• Her ayar veya ürün için ayrı çağrı yapmak yerine carat=all ile bir kez isteyin ve sonucu planınızın güncelleme aralığı boyunca önbelleğe alın.
• Bir rakamı daha sonra açıklayabilmek için her fiyat teklifi ve siparişle birlikte fiyatı, zaman damgasını ve kullanılan saflığı saklayın.
• Geçmiş ayar fiyatları için date kullanın; örneğin eski bir faturayı yeniden hesaplarken. API ile geçmiş altın ve gümüş fiyatları yazısı daha uzun aralıkları ve verilerin yerel olarak saklanmasını ele alıyor.
• Yalnızca gösterim aşamasında, her para biriminin kendi ondalık basamak sayısını kullanarak yuvarlayın.
• API anahtarını sunucunuzda tutun. Bir mağaza web sitesinde kod yazmadan altın fiyat panosu göstermek için gömülebilir bir widget kullanın.
• Yalnızca birkaç ayara ihtiyacınız varsa formülü /latest verilerine uygulamak her planda çalışır. /carat ise ücretli planlarda hesaplama zahmetinden kurtarır ve hazır, tutarlı rakamlar döndürür.

API dokümantasyonu /carat endpoint'inin tüm parametrelerini açıklar, fiyatlandırma sayfası hangi planların bunu içerdiğini gösterir ve Altın fiyatı API rehberi anahtarları, hataları ve önbelleğe almayı genel olarak ele alır. Kendi kataloğunuzla denemek için kaydolun ve bir anahtar alın.