MetalAPI ile Başlarken

Giriş

MetalAPI; spot değerli metaller, endüstriyel metaller, enerji, yaklaşık 55 para birimi ve 13 kripto para için bir JSON REST API'sidir. Gerçek zamanlı fiyatlar, 1999'a uzanan günlük geçmiş veriler, dönüştürme, OHLC çubukları ve ayara göre altın fiyatları sunar.

Her endpoint, https://metalapi.com/api/v1 altında basit bir HTTPS GET isteğidir; bu nedenle her programlama dilinden ve her HTTP istemcisiyle çalışır. Bu rehber, kayıt olmaktan ilk yanıtınızı almaya kadar sizi birkaç dakikada yönlendirir.

API anahtarınızı alın

E-posta adresinizle ücretsiz bir hesap oluşturun. Kredi kartı gerekmez. Free planı, günlük fiyat güncellemeleriyle ayda 100 istek içerir; bu da API'yi denemek için yeterlidir.

Paneldeki API keys bölümünü açın ve bir anahtar oluşturun. Anahtarlar mk_live_ ile başlar ve ardından 32 karakter gelir. Her anahtarın yalnızca hash değerini sakladığımız için tam anahtar yalnızca bir kez gösterilir. Anahtarı hemen parola yöneticinize veya ortam değişkenlerinize kopyalayın.

İlk isteğinizi gönderin

Dört değerli metalin en güncel fiyatlarını ABD doları cinsinden isteyin. YOUR_API_KEY yerine kendi anahtarınızı yazın:

curl "https://metalapi.com/api/v1/latest?api_key=YOUR_API_KEY&base=USD&currencies=XAU,XAG,XPT,XPD"

Yanıtı anlamak

base, fiyatların ifade edildiği para birimidir (varsayılan: USD). currencies, yanıtı ihtiyacınız olan sembollerle sınırlar. Bu parametreyi göndermezseniz tüm semboller tek bir yanıtta döner. Başarılı bir çağrı şuna benzer bir JSON döndürür:

{
  "success": true,
  "timestamp": 1792713600,
  "date": "2026-10-23",
  "base": "USD",
  "rates": {
    "XAU": 0.0002501319446,
    "USDXAU": 3997.89,
    "XAG": 0.01853911754,
    "USDXAG": 53.94,
    "XPT": 0.000620212733,
    "USDXPT": 1612.35,
    "XPD": 0.0006775985906,
    "USDXPD": 1475.8
  },
  "rate_limit": {
    "limit": 100,
    "remaining": 99,
    "reset": 1793491200,
    "used": 1,
    "plan": "Free",
    "reset_date": "2026-11-01T00:00:00.000Z"
  }
}

Her sembol iki kez yer alır. USDXAU, bir troy ons altının baz para birimi cinsinden fiyatıdır ve genellikle göstermek istediğiniz değer budur. XAU ise bunun tersidir: bir ABD doları ile kaç troy ons alınabileceğini gösterir. Veri formatları rehberi her iki yönü ayrıntılı olarak açıklar.

X-RateLimit-* header'ları olarak da gönderilen rate_limit bloğu, aylık kotanızdan ne kadarının kaldığını ve kotanın ne zaman sıfırlanacağını gösterir.

Koddan çağırın

Aynı istek JavaScript ile (Node.js 18+, Deno veya Bun) şöyle yapılır. Bu kez anahtar URL yerine bir header içinde gönderiliyor:

const res = await fetch("https://metalapi.com/api/v1/latest?currencies=XAU,XAG", {
  headers: { Authorization: `Bearer ${process.env.METALAPI_KEY}` },
});
const data = await res.json();

if (!data.success) throw new Error(`${data.error.code}: ${data.error.info}`);
console.log("Gold, USD per troy ounce:", data.rates.USDXAU);

Sonraki adımlar

• Kimlik doğrulama: header tabanlı anahtarlar ve tarayıcıda kullanım için alan adıyla sınırlandırılmış anahtarlar.
• Kullanılabilir endpoint'ler: geçmiş kurlar, dönüştürme, zaman serileri, OHLC ve ayar fiyatları.
• İstek limitleri ve planlar: kotalar, dakika başına limitler ve güncelleme aralıkları.
• Hata yönetimi: hata kodları ve makul bir yeniden deneme stratejisi.