Kullanılabilir Endpoint'ler

Temel URL ve ortak parametreler

Tüm endpoint'ler https://metalapi.com/api/v1 altındaki GET istekleridir ve bir API anahtarı gerektirir (bkz. Kimlik doğrulama). Çoğu, aynı isteğe bağlı parametreleri kabul eder:

• base: fiyatların ifade edildiği para birimi. Varsayılan değer USD olup desteklenen her sembol kullanılabilir.
• currencies veya takma adı symbols: döndürülecek sembollerin XAU,XAG,EUR gibi virgülle ayrılmış listesi. Tüm sembolleri almak için bu parametreyi göndermeyin.
• unit: metal fiyatları için kütle birimi. troy_oz (varsayılan), gram, kilogram, ounce, pound, metric_ton veya short_ton değerlerinden biri.

Tarihler YYYY-MM-DD formatındadır ve UTC olarak yorumlanır.

Güncel kurlar: /latest

Planınızın güncelleme aralığına göre güncel fiyatlar; Free planda günlükten Enterprise planda 5 saniyeye kadar. Standard ve üzeri planlarda alış ve satış fiyatlarını almak için currencies parametresine XAU-BID ve XAU-ASK gibi semboller ekleyin.

GET https://metalapi.com/api/v1/latest?api_key=YOUR_API_KEY&base=USD&currencies=XAU,XAG,EUR

Geçmiş kurlar: /{date}

Geçmiş bir günün kapanış fiyatları. Üç biçim kabul edilir: yol olarak tarih, /historical?date= veya /yesterday.

GET /api/v1/2026-10-01?api_key=YOUR_API_KEY&currencies=XAU,XAG
GET /api/v1/historical?date=2026-10-01&api_key=YOUR_API_KEY&currencies=XAU,XAG
GET /api/v1/yesterday?api_key=YOUR_API_KEY&currencies=XAU,XAG

Dönüştürme: /convert

from cinsinden amount tutarını to birimine dönüştürür; örneğin doları ons cinsinden altına ya da gümüşü euroya. Geçmiş bir kapanış fiyatıyla dönüştürmek için date, metali gram veya kilogram cinsinden dönüştürmek için unit ekleyin.

GET /api/v1/convert?api_key=YOUR_API_KEY&from=USD&to=XAU&amount=1000

# 1 Ekim 2026 kapanışında 500 gram gümüşün euro karşılığı
GET /api/v1/convert?api_key=YOUR_API_KEY&from=XAG&to=EUR&amount=500&unit=gram&date=2026-10-01

Zaman aralığı: /timeframe

start_date ile end_date arasındaki her gün için günlük kapanış fiyatları. Tek bir istek Free planda en fazla 30 günü, ücretli planlarda ise 365 günü kapsayabilir. Daha uzun aralıklar 207 hatası döndürür. /timeseries, uyumluluk için korunan bir takma addır.

GET /api/v1/timeframe?api_key=YOUR_API_KEY&start_date=2026-09-01&end_date=2026-09-30&currencies=XAU

Değişim: /change

Her sembol için iki tarih arasındaki başlangıç kuru, bitiş kuru, mutlak değişim ve yüzde değişim. “Altın bu ay %3,6 yükseldi” gibi gösterimler için kullanışlıdır. Aralık limitleri /timeframe ile aynıdır.

GET /api/v1/change?api_key=YOUR_API_KEY&start_date=2026-09-30&end_date=2026-10-23&currencies=XAU,XAG

OHLC: /ohlc

Tek bir günün açılış, en yüksek, en düşük ve kapanış değerleri. Bugünün o ana kadarki çubuğunu almak için date göndermeyin ya da latest değerini verin.

GET /api/v1/ohlc?api_key=YOUR_API_KEY&date=2026-10-22&currencies=XAU,XAG

Ayara göre altın: /carat

24 ayardan 8 ayara kadar kuyumculukta kullanılan saflıklarda altın fiyatları, istediğiniz para birimi ve birimde. carat=24 (varsayılan), 18 gibi tek bir ayar ya da carat=all gönderin. Desteklenen ayarlar 24, 23, 22, 21, 20, 18, 16, 14, 12, 10, 9 ve 8'dir. Geçmiş ayar fiyatları için date ekleyin.

Bu endpoint ücretli planlarda kullanılabilir. Free plan anahtarları 106 hatası alır.

GET /api/v1/carat?api_key=YOUR_API_KEY&carat=all&base=EUR&unit=gram

Semboller: /symbols

Desteklenen sembollerin ve adlarının listesi. Her sembolün kategorisini ve birimini de almak için details=1 ekleyin. Bu endpoint aylık kotanızdan düşülmez.

GET /api/v1/symbols?api_key=YOUR_API_KEY&details=1

Kullanım: /usage

Geçerli fatura ayında kullanılan ve kalan istek sayısı. Bu endpoint de ücretsizdir; böylece kota harcamadan izleme sistemlerinizden çağırabilirsiniz.

GET /api/v1/usage?api_key=YOUR_API_KEY

Gerçek zamanlı akış: /stream

Fiyat güncellemelerini gerçekleştikleri anda ileten bir Server-Sent Events akışıdır; böylece /latest endpoint'ini sürekli sorgulamanız gerekmez. Pro ve üzeri planlarda kullanılabilir. Olay formatı akış dokümantasyonunda açıklanmıştır.

curl -N "https://metalapi.com/api/v1/stream" \
  -H "Authorization: Bearer YOUR_API_KEY"