Veri Formatları ve Birimler

Her kur için iki yön

İstediğiniz her sembol için rates iki sayı içerir. Baz para birimi USD iken altın (XAU) için:

• USDXAU: bir troy ons altının ABD doları cinsinden fiyatı, örneğin 3997.89. Kullanıcılara gösterilecek değer budur.
• XAU: bunun tersi, yani bir ABD doları başına troy ons altın, örneğin 0.0002501319446. Bu format, forex tarzı API'lerle uyumluluk için korunmaktadır.

Para birimleri de aynı kuralı izler. Baz USD iken USDEUR bir euronun dolar cinsinden fiyatı, EUR ise dolar başına euro miktarıdır.

{
  "success": true,
  "timestamp": 1792765800,
  "date": "2026-10-23",
  "base": "USD",
  "rates": {
    "XAU": 0.0002501319446,
    "USDXAU": 3997.89,
    "EUR": 0.8589589418,
    "USDEUR": 1.1642
  }
}

Baz para birimi seçimi

base, yanıttaki tüm fiyatların para birimini belirler. Varsayılan değer USD olup desteklenen her sembolü kabul eder: EUR, GBP, JPY, hatta değerleri bitcoin veya altın cinsinden ifade etmek istiyorsanız BTC ya da XAU. Çapraz kurlar aynı anlık görüntüden hesaplanır; bu nedenle birbirleriyle her zaman tutarlıdır.

Bu istek, altının troy ons başına euro cinsinden fiyatı olan EURXAU değerini döndürür:

GET /api/v1/latest?api_key=YOUR_API_KEY&base=EUR&currencies=XAU,XAG

Kütle birimleri

unit göndermediğiniz sürece metal fiyatları troy ons (31,1035 g) başınadır. Desteklenen değerler:

• troy_oz (varsayılan), gram, kilogram, ounce (avoirdupois, 28,35 g), pound, metric_ton ve short_ton

g, kg, lb ve tonne gibi kısa biçimler de kabul edilir. oz değerinin avoirdupois ons anlamına geldiğine dikkat edin. Külçe metallerin fiyatlandırıldığı troy ons için troy_oz kullanın veya unit parametresini hiç göndermeyin.

unit yalnızca değerli ve endüstriyel metallere uygulanır. Enerji fiyatları varil, MMBtu veya galon başına kalır; para birimleri ve kripto etkilenmez. Varsayılan dışında bir birim kullanıldığında yanıt bir unit alanı içerir. GET /api/v1/latest?base=EUR&currencies=XAU,XAG&unit=gram için:

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

Endüstriyel metaller ve enerji

Endüstriyel metaller (XCU bakır, ALU alüminyum, ZNC çinko ve HRC sıcak haddelenmiş rulo çelik), diğer tüm metaller gibi varsayılan olarak troy ons başına fiyatlandırılır; böylece tüm metaller doğrudan karşılaştırılabilir. Her piyasanın işlem gördüğü birimi almak için bakırda unit=pound, alüminyum ve çinkoda unit=metric_ton, çelikte ise unit=short_ton gönderin.

Enerji fiyatları kontrat birimi başınadır: WTI ve BRENT varil başına, NATURALGAS MMBtu başına, GASOLINE ve HEATINGOIL ise galon başına.

GET /api/v1/latest?api_key=YOUR_API_KEY&currencies=XCU&unit=pound

Desteklenen semboller

• Değerli metaller: XAU altın, XAG gümüş, XPT platin, XPD paladyum
• Endüstriyel metaller: XCU bakır, ALU alüminyum, ZNC çinko, HRC çelik
• Enerji: WTI, BRENT, NATURALGAS, GASOLINE, HEATINGOIL
• Para birimleri: USD, EUR, GBP, JPY, CHF, CAD, AUD, CNY ve INR dahil yaklaşık 55 ISO 4217 para birimi
• Kripto: BTC, ETH, SOL, XRP, BNB, ADA, DOGE, DOT, LINK, LTC, TRX, USDT, USDC

Eksiksiz ve güncel liste semboller sayfasında yer alır ve /api/v1/symbols üzerinden de alınabilir.

Alış ve satış fiyatları

Standard ve üzeri planlarda, orta fiyatın yanında alış ve satış fiyatlarını da almak için currencies içindeki bir sembole -BID veya -ASK ekleyin. Bu fiyatlar, bankalar arası akışlardan fiyatlanan sembollerde, yani değerli metallerde ve başlıca para birimlerinde kullanılabilir. currencies=XAU,XAU-BID,XAU-ASK için:

"rates": {
  "XAU": 0.0002501319446,
  "USDXAU": 3997.89,
  "XAU-BID": 0.0002501488386,
  "USDXAU-BID": 3997.62,
  "XAU-ASK": 0.0002501150529,
  "USDXAU-ASK": 3998.16
}

Ayara göre altın fiyatları

/carat, kuyumculukta kullanılan saflıklardaki altın fiyatlarını (saflık = ayar ÷ 24) istediğiniz para birimi ve birimde döndürür. Ücretli planlarda kullanılabilir. GET /api/v1/carat?carat=all&unit=gram için (kısaltılmış):

{
  "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 }
  }
}

Zaman damgaları ve tarihler

timestamp, döndürülen fiyatların saniye cinsinden Unix zamanıdır (UTC). date, aynı günün UTC'ye göre YYYY-MM-DD biçimindeki karşılığıdır. Geçmiş veri yanıtları istenen günün 00:00 UTC zamanıyla damgalanır ve o günün kapanış fiyatlarını içerir.

const date = new Date(data.timestamp * 1000);
console.log(date.toISOString()); // 2026-10-23T14:30:00.000Z

Hassasiyet

Kurlar en fazla 10 anlamlı basamağa sahip JSON sayılarıdır; bu, 0.0002501319446 gibi ters kurlar için yeterlidir. Değerleri yalnızca gösterirken yuvarlayın, hesaplamalarda kullanmadan önce değil.

Piyasa saatleri ve hafta sonları

Spot metaller ve para birimleri hafta içi günlerde kesintisiz işlem görür. Piyasalar cuma günü New York saatiyle 17:00'de kapanır ve pazar günü 17:00'de yeniden açılır. Hafta sonu fiyatlar son kotasyonda sabit kalır ve API cuma kapanış fiyatını döndürmeye devam eder (sembol sayfalarında “Piyasa kapalı” ibaresi görünür).

Kripto 7/24 işlem görür ve hafta sonları da güncellenmeye devam eder. Endüstriyel metaller ve enerji, ilgili vadeli işlem borsalarının işlem saatlerini izler.