İçeriğe geç
SanaterServisBelgeler
Ücretsiz hesap

Finans

Başlangıç ve kimlik doğrulamaŞehirlerNamaz vakitleriFinansHava durumuPuan durumuFikstürDünya yerleşim verisiGeçmiş ve arşiv

BIST 100, Dolar, Euro ve Gram Altın; değer, günlük değişim ve yön.

Erişimanahtar gerekliküme adı: finans
Uç noktalar3aşağıda tek tek açıklanır
Kaynakhaber7
TazelemeSaatte birdört kalem birden

Dört kalem izlenir. Değerler ondalık nokta ile sayı olarak döner (kaynak virgüllü metin verir, servis çevirir); doğrudan hesaplamada kullanabilirsiniz.

Geçmiş serisi arşivden okunur ve her çekimde bir nokta biriktirir — grafik çizmek için /gecmis ucunu kullanın.

Uç noktalar

GET/v1/finans
Dört kalemin tamamı.
GET/v1/finans/{kod}
Tek kalem. {kod}: BIST100, DOLAR, EURO, ALTIN.
GET/v1/finans/gecmis
Arşivden zaman serisi.

Parametreler

ParametreYerAçıklama
{kod}yolKalem kodu; büyük/küçük harf duyarsızdır.
kodsorguYalnız /gecmis ucunda: hangi kalem. Varsayılan DOLAR.
gunsorguYalnız /gecmis ucunda: kaç günlük seri. Varsayılan 30, en çok 3650.

Alanlar

kalemler[] / kalem

AlanTipAçıklama
kodstringBIST100, DOLAR, EURO ya da ALTIN.
adstringGörüntülenecek ad (ör. Gram Altın).
degerfloatGüncel değer.
birimstringTL ya da BIST 100 için puan.
degisim_yuzdefloatGünlük değişim yüzdesi; düşüşte negatif.
yonstringyukari, asagi ya da sabit. Renk/ok seçmek için degisim_yuzde işaretine bakmak yerine bunu kullanın.

gecmis · seri[]

AlanTipAçıklama
zamanstringÖlçümün alındığı an, YYYY-AA-GG SS:DD:SS.
degerfloatO andaki değer.
degisimfloatO andaki günlük değişim yüzdesi.

Örnek yanıt

Örnek yanıt · /v1/finans
{
  "ok": true,
  "kume": "finans",
  "kaynak": "haber7",
  "guncelleme": "2026-09-30T17:10:02+03:00",
  "yas_sn": 1828,
  "bayat": false,
  "kalemler": [
    { "kod": "BIST100", "ad": "BIST 100", "deger": 11937.68,
      "birim": "puan", "degisim_yuzde": -2.87, "yon": "asagi" },
    { "kod": "DOLAR", "ad": "Dolar", "deger": 49.01,
      "birim": "TL", "degisim_yuzde": 0.06, "yon": "yukari" },
    { "kod": "EURO", "ad": "Euro", "deger": 55.72,
      "birim": "TL", "degisim_yuzde": 0.23, "yon": "yukari" },
    { "kod": "ALTIN", "ad": "Gram Altın", "deger": 6586.914,
      "birim": "TL", "degisim_yuzde": 0, "yon": "sabit" }
  ]
}

Kullanım

curl
curl -H "X-Api-Key: ss_…" \
  "https://api.sanater.com/v1/finans/DOLAR"
PHP · kur şeridi
$veri = json_decode(file_get_contents(
    'https://api.sanater.com/v1/finans?anahtar=ss_…'), true);

foreach ($veri['kalemler'] as $k) {
    $ok = ['yukari' => '▲', 'asagi' => '▼', 'sabit' => '='][$k['yon']];
    printf("%-10s %10s %s %+.2f%%\n",
        $k['ad'], number_format($k['deger'], 2, ',', '.'), $ok, $k['degisim_yuzde']);
}

Bilinmesi gerekenler

← Tüm belgelerÜcretsiz anahtar alın