Geliştiriciler İçin Döviz & Altın Kurları REST API Dokümantasyonu
Stateless mimariyle çalışan, harici kimlik doğrulama gerektirmeyen, 2 saatlik akıllı önbelleğe sahip, 170+ dünya para birimi ve Türkiye altın kurlarını sunan yüksek performanslı REST API.
curl -s https://clskn.net/api/exchange
Stateless RESTful Döviz ve Altın Servisi
clskn.net Döviz API; oturum, çerez veya karmaşık API anahtarları gerektirmeyen tamamen stateless, milisaniyeler seviyesinde çalışan modern bir mikroservistir. 170'ten fazla küresel ISO para birimini, anlık ters kur matrislerini (inverse rates) ve Türkiye serbest piyasa altın türlerini (Gram 24K/22K, Çeyrek, Yarım, Ata Lira, Ajda bilezik) hesaplayarak sunar.
API anahtarı veya oturum gerektirmeden standart HTTP GET istekleriyle doğrudan JSON döner.
XAU ve XAG üzerinden Gram, Çeyrek, Yarım, Ata Lira ve Ajda bilezik kurlarını anlık çözer.
2 saatlik hafıza önbelleği ve anlık yerel snapshot yedeği ile kesintisiz erişilebilirlik sağlar.
API Uç Noktaları (Endpoints)
| Metot | Uç Nokta | Açıklama | Oran Limiti |
|---|---|---|---|
| GET | /api/exchange/{base?} |
Belirtilen baz para birimine göre kurları getirir (Varsayılan: TRY). |
60 istek / dk |
| GET | /api/v1/exchange/{base?} |
v1 versiyonlanmış kurlar uç noktası. | 60 istek / dk |
| GET | /api/rates/{base?} |
Kısa takma ad (alias) rotası. | 60 istek / dk |
| GET | /api/v1/rates/{base?} |
v1 versiyonlanmış kısa takma ad rotası. | 60 istek / dk |
Desteklenen Parametreler
| Parametre | Tür | Konum | Açıklama | Örnek |
|---|---|---|---|---|
base |
string |
Path / Query | Baz para birimi. Varsayılan: TRY. |
base=USD veya /api/exchange/EUR |
symbols |
string |
Query | Virgülle ayrılmış sembol filtresi. Yanıtta sadece istenen kurlar döner. | symbols=USD,EUR,GAU,CEYREK |
from |
string |
Query | Anlık çevrim için kaynak para birimi (to ile birlikte kullanılır). | from=USD |
to |
string |
Query | Anlık çevrim için hedef para birimi (from ile birlikte kullanılır). | to=TRY |
amount |
float |
Query | Çevrilecek miktar. Pozitif sayı olmalıdır (Varsayılan: 1.0). |
amount=250.5 |
refresh |
boolean |
Query | Önbelleği atlayarak güncel kurları doğrudan sağlayıcıdan çeker. | refresh=1 |
Örnek İstek ve Yanıt
cURL İsteği:
curl -s "https://clskn.net/api/exchange/TRY?symbols=USD,EUR,GAU,CEYREK&from=USD&to=TRY&amount=100"JavaScript (Fetch API):
const res = await fetch('https://clskn.net/api/v1/exchange/TRY?symbols=USD,EUR,GAU');
const data = await res.json();
console.log(data.rates);Başarılı JSON Yanıtı (200 OK):
{
"success": true,
"base": "TRY",
"fetched_at": "2026-09-08T17:45:00+03:00",
"cached": true,
"rates": {
"USD": 0.0242,
"EUR": 0.0223,
"GAU": 0.00026,
"CEYREK": 0.00016
},
"inverse_rates": {
"USD": 41.25,
"EUR": 44.78,
"GAU": 3795.50,
"CEYREK": 6205.80
},
"conversion": {
"from": "USD",
"to": "TRY",
"amount": 100,
"result": 4125,
"unit_rate": 41.25
}
}