Ana içeriğe atla
ONEPiR - ikas E-Ticaret Otomatik Döviz ve Altın Kuru Fiyat Güncelleme - API Integrator
Ücretsiz Kayıt Ol
Altın ve döviz kuru verisi — JSON API

Kur API ile altın ve döviz kurlarını sitenize bağlayın

Altın, dolar ve euro kurlarını tek bir adresten JSON olarak alın. Seçtiğiniz kaynağa göre gram altın ya da has altın; bugünün saatlik hareketi, günlük kayıtlar ve aylık ortalamalar dahil.

Gram Altın
Alış6.470,75
Satış6.557,60
Has Altın
Alış6.503,27
Satış6.537,99
Dolar
Alış49,38
Satış49,46
Euro
Alış54,96
Satış55,18
ONEPiR kur verisi — son güncelleme 00:48
Ücretsiz Kayıt OlTeknik Dokümana Git

Kur API ne için kullanılır?

Kur verisini kendiniz toplamak yerine hazır alın; kalan işi kendi arayüzünüzde kurgulayın.

Sitenizde güncel kur şeridi

Altın, dolar ve euro değerlerini sayfanızın üstünde gösterin. Tek bir istek, hazır JSON.

Gün içi ve geçmişe dönük grafik

Bugünün saatlik hareketini ya da tarih aralığı vererek günlük ve aylık seriyi çekin; doğrudan grafik kütüphanenize besleyin.

Kura endeksli fiyat hesabı

Ürün fiyatlarınızı güncel kur üzerinden hesaplayan kendi kurgunuzu kurun; kur verisini bizden alın.

Teknik Referans

Tek endpoint, altı parametre

SDK kurmanız gerekmez. İstek sitenizin sayfasından yapılır; API isteğin izin verdiğiniz alan adından geldiğini doğrular.

GET

Uç Nokta

https://app.onepir.com/api/modules/currency-api/public

Yanıt JSON biçimindedir ve tarayıcıdan çağrılabilmesi için CORS başlıklarıyla döner. Başarılı yanıtlar beş dakikalık önbellek başlığı taşır.

Sorgu Parametreleri

ParametreDeğerlerVarsayılanAçıklama
apiKeyAPI anahtarınızZorunluPanelden alınan anahtar; en az 32 karakter.
typegold · usd · eurgoldHer istek tek bir kur döndürür. Altında dönen cins kaynağa bağlıdır: varsayılan kaynak gram altın, ONEPiR kaynağı has altın verir.
perioddaily · monthly · hourlydailydaily günlük kayıtları, monthly aylık ortalamaları döndürür. hourly bugünün saatlik kapanışlarını verir (Türkiye saati); bu modda tarih parametreleri yok sayılır.
startDateYYYY-MM-DDAyarınıza göreAralığın başlangıcı. Vermezseniz panelde tanımladığınız gün sayısı kadar geriye gider (varsayılan 30 gün).
endDateYYYY-MM-DDBugünAralığın bitişi.
sourcedefault · onepir · tcmb · dovizdefaultKur kaynağını seçer; altında dönen cinsi de belirler. Her kaynak her kur tipini vermez — altın için tcmb, dolar ve euro için doviz desteklenmez; desteklenmeyen eşleşme 400 döner.

Örnek İstek

fetch(
  "https://app.onepir.com/api/modules/currency-api/public" +
    "?apiKey=API_ANAHTARINIZ" +
    "&type=gold&period=daily&source=onepir"
)
  .then((res) => res.json())
  .then((data) => console.log(data.data.rates));

Örnek Yanıt

{
  "success": true,
  "data": {
    "rates": [
      { "date": "2026-08-08", "buy": 5961, "sell": 5972 },
      { "date": "2026-08-07", "buy": 5943, "sell": 5953 }
    ],
    "type": "gold",
    "period": "daily",
    "source": "onepir",
    "currency": "TRY"
  },
  "meta": {
    "source": "ONEPiR",
    "generatedAt": "2026-08-08T09:12:33.120Z",
    "dateRange": { "start": "2026-07-09", "end": "2026-08-08" },
    "recordCount": 31,
    "usage": {
      "requestsUntilNextKontor": 12,
      "kontorDeducted": false,
      "totalRequests": 48
    },
    "performance": { "responseTimeMs": 84 }
  }
}

Hata Kodları

KodHTTPAnlamı
INVALID_API_KEY401API anahtarı eksik veya geçersiz.
UNAUTHORIZED_DOMAIN403İstek, izin verilen alan adları listesinde olmayan bir siteden geldi.
UNAUTHORIZED_IP403İstek, izin verilen IP listesinde olmayan bir adresten geldi.
MODULE_INACTIVE403Kur API modülü mağazanızda aktif değil.
INSUFFICIENT_KONTOR402Kontör bakiyeniz yetersiz.
RATE_LIMIT_EXCEEDED429Dakikalık istek limiti aşıldı.
INVALID_DATE_RANGE400Parametreler veya tarih aralığı geçersiz.
UNSUPPORTED_SOURCE400Seçilen kaynak bu kur tipi için veri sağlamıyor.
INTERNAL_ERROR500Sunucu tarafında beklenmeyen bir hata oluştu.

Hata yanıtı biçimi:

{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED_DOMAIN",
    "message": "Bu domain'den erişim izni yok"
  }
}

Kullanım, limit ve güvenlik

30 istekte 1 kontör

Her yanıtta bir sonraki kontöre kaç istek kaldığınımeta.usagealanında görürsünüz.

Dakikalık istek limiti

Her IP adresi için dakikada 60 istek. Limit aşılırsa yanıt 429 döner.

Alan adı zorunlu

En az bir izinli alan adı tanımlamak zorunludur; anahtarınız yalnızca o adreslerden çalışır. IP kısıtı isteğe bağlıdır.

Geçmiş veri dahil

Tarih aralığı verin, günlük kayıtları veya aylık ortalamaları tek istekte alın.

Üç adımda başlayın

Kayıt olduktan sonra modülün panelinde API anahtarınız ve size özel hazır örnek istekler sizi bekliyor.

01

Ücretsiz kayıt olun

Mağazanızı oluşturun, kurulum gerektirmez.

02

Kur API modülünü ekleyin

Uygulama mağazasından modülü mağazanıza ekleyip aktif edin.

03

Anahtarınızı alın, çağırın

En az bir izinli alan adı tanımlayın — bu zorunludur — ve isteği gönderin.

Sıkça Sorulan Sorular

Kur API Hakkında

ONEPiR Kur API, altın ve döviz kurlarını JSON biçiminde döndüren bir web servisidir. Kendi sitenizden tek bir adrese istek atarak altın, dolar ve euro değerlerini alır; dilerseniz geçmiş tarih aralığındaki kayıtları da çekebilirsiniz. Veriyi kendi arayüzünüzde göstermek, fiyat hesaplamak veya grafik çizmek için kullanabilirsiniz.

type parametresiyle altın (gold), dolar (usd) veya euro (eur) verisini çekersiniz; her istek tek bir kur döndürür. Altında dönen cins seçtiğiniz kaynağa bağlıdır: varsayılan kaynak gram altın, ONEPiR kaynağı has altın verir. Kaynağı source parametresiyle seçersiniz. Her kaynak her kur tipini vermez: Merkez Bankası kaynağı dolar ve euro içindir, altınla birlikte istenirse yanıt 400 UNSUPPORTED_SOURCE döner.

Evet. startDate ve endDate parametrelerine YYYY-MM-DD biçiminde tarih vererek istediğiniz aralığı çekebilirsiniz. Tarih vermezseniz son 30 günlük veri döner. period=daily günlük kayıtları, period=monthly ise ay bazında ortalamaları döndürür; aylık sonuçlarda tarih alanı ilgili ayın ilk gününü gösterir.

Evet. period=hourly bugünün saatlik kapanışlarını döndürür: her saat için o saatteki son kur değeri, Türkiye saatine göre etiketlenmiş olarak. Tarih alanı ISO 8601 biçimindedir ve saat dilimi bilgisini taşır (örneğin 2026-08-09T14:00:00+03:00). Bu mod yalnızca içinde bulunduğunuz günü kapsar; geçmiş bir günün saatlik dökümü için tarih seçilemez, geçmiş veriler günlük kayıt olarak sunulur.

Kur verileri gün boyunca otomatik olarak toplanır. Saatlik modda (period=hourly) noktalar, yaklaşık yirmi dakikada bir tazelenen kayıtlardan üretilir. Günlük ve aylık modlarda kullanılan gün kaydı ise iki saatte bir tazelenir ve her gün için tek satır tutulur. Yanıtlar ayrıca beş dakikalık önbellek başlığıyla gelir. Yani saniyelik hareketi izleyen bir borsa akışı değil, gün içinde düzenli güncellenen bir kur kaydı sunar.

Kullanım kontör üzerinden ilerler: her 30 istekte 1 kontör düşülür. Her yanıtın meta.usage alanında bir sonraki kontöre kaç istek kaldığını, o istekte kontör düşülüp düşülmediğini ve toplam istek sayınızı görürsünüz. Böylece tüketiminizi kendi tarafınızdan da takip edebilirsiniz.

Evet. Her IP adresi için dakikalık bir istek limiti uygulanır; varsayılan değer dakikada 60 istektir. Limit aşıldığında API 429 durum koduyla RATE_LIMIT_EXCEEDED döndürür. Sitenizin trafiği bu sınırın üzerindeyse bizimle iletişime geçin.

Anahtar tarayıcıdan çağrıldığında adres satırında görünebildiği için tek başına bırakılmaz. Panelden izin verilen alan adlarını tanımlamanız zorunludur — liste boşken API hiçbir isteği kabul etmez. Listede olmayan bir siteden gelen istek de UNAUTHORIZED_DOMAIN hatasıyla reddedilir. Dilerseniz IP kısıtı da ekleyerek erişimi belirli adreslerle sınırlayabilirsiniz.

API, isteğin izin verdiğiniz alan adından geldiğini Origin veya Referer bilgisiyle doğrular; bu bilgiyi taşımayan istekler UNAUTHORIZED_DOMAIN hatası alır. Bu nedenle kullanım tarayıcı tarafına göre tasarlanmıştır. Sunucu tarafında ya da mobil uygulamada kullanmanız gereken bir senaryo varsa bizimle iletişime geçin.

Ücretsiz kayıt olduktan sonra uygulama mağazasından Kur API modülünü mağazanıza ekleyin. Modülün panelinde API anahtarınızı alır, izin verilen alan adlarını tanımlar (en az bir tane zorunludur), varsayılan kur tipi ile kaynağı seçer ve size özel hazır örnek istekleri görürsünüz.

Kur API ile birlikte çalışan çözümler

Altın ve döviz kuru tek başına veri değil, fiyatlandırma zincirinin ilk halkasıdır. Aşağıdaki modüller bu kuru mağazanıza ve pazaryerlerine taşır.

Altın fiyatı otomatik güncelleme

Kuyumcu ürünlerinde has altın, milyem ve işçilik hesabıyla fiyatlar kur değiştiğinde kendiliğinden güncellenir.

Gelişmiş fiyat güncellemeyi görün

ikas entegrasyonu

Kur API'den gelen fiyat, ikas mağazanıza tek tıkla bağlanan entegrasyonla ürünlere işlenir.

ikas entegrasyonunu inceleyin

Pazaryerlerinde kura göre fiyat

Aynı kur kuralı Trendyol, Hepsiburada ve diğer pazaryerlerindeki ürünlerinize de uygulanır.

Pazaryeri entegrasyonlarını görün

Kontör maliyetini hesaplayın

Aylık API isteği ve fiyat güncelleme hacminize göre kaç kontör gerektiğini önceden görün.

Kontör hesaplayıcıya gidin

Bu konuda yazdığımız rehberler için Altın API yazılarına göz atabilirsiniz.

Kur verinizi bugün bağlayın

Ücretsiz kayıt olun, Kur API modülünü aktif edin ve anahtarınızı alın — ilk isteğinizi birkaç dakika içinde gönderebilirsiniz.

Ücretsiz Kayıt OlBize Ulaşın