Türkiye Cumhuriyeti Merkez Bankası (TCMB) Verilerine EVDS Python Kütüphanesi ile Kapsamlı Erişim Kılavuzu

Türkiye Cumhuriyet Merkez Bankası’nın (TCMB) Elektronik Veri Dağıtım Sistemi (EVDS), ekonomik ve finansal verilerin erişimini kolaylaştıran kapsamlı bir platformdur. evds Python kütüphanesi, bu verileri çekebilmenizi ve analiz edebilmenizi sağlar. Bu makalede, evds kütüphanesinin tüm fonksiyonlarını ve kullanım şekillerini detaylı bir şekilde inceleyeceğiz.

API Anahtarı Alma

Verilere erişim sağlamak için bir EVDS API Anahtarı’na ihtiyacınız olacak. API anahtarı almak için

1. **EVDS Web Sitesi**’ne gidin ve bir hesap oluşturun.
2. Giriş yaptıktan sonra, profil sayfanıza gidin.

1.1 Profil Ekranı

3. API anahtarınızı alın ve kaydedin.

Kütüphanenin Kurulumu

Kütüphaneyi kullanmaya başlamak için önce aşağıdaki komut ile kütüphaneyi yüklemeniz gerekir.

pip install evds

API Anahtarını Ayarlama

import evds

api_key = "Sizin API anahtarınız"
evds = evdsAPI(api_key)

get_data()

Bu fonksiyon, EVDS sisteminden veri çekmek için en temel fonksiyondur. İlgili veri serileri, tarih aralıkları ve isteğe bağlı diğer parametrelerle birlikte kullanılabilir.

Parametreler:

**series* (zorunlu)*: Çekmek istediğiniz veri serilerinin kodlarını içeren liste. Birden fazla seri bir liste içinde tanımlanabilir.

**startdate (zorunlu): Verilerin başlangıç tarihi. Tarih formatı “gg-aa-yyyy”** şeklinde olmalıdır.

**enddate* (isteğe bağlı)*: Verilerin bitiş tarihi. Eğer belirtilmezse, startdate ile aynı tarih alınır.

**aggregation_types* (isteğe bağlı)*: Verilerin çekilmesi sırasında kullanılacak toplulaştırma yöntemleri. Tek bir string değeri veya bir liste olabilir.

Kullanılabilecek toplulaştırma yöntemleri şunlardır:

• **avg**: Ortalama
• **min**: En düşük değer
• **max**: En yüksek değer
• **first**: İlk değer
• **last**: Son değer
• **sum**: Kümülatif toplam

**formulas* (isteğe bağlı)*: Veriler üzerinde formüller uygulanarak sonuçlar elde edilmesini sağlar. Tek bir string değeri veya bir liste olabilir.

Kullanılabilecek formüller:

• **1**: Yüzde Değişim
• **2**: Fark
• **3**: Yıllık Yüzde Değişim
• **4**: Yıllık Fark
• **5**: Bir Önceki Yılın Sonuna Göre Yüzde Değişim
• **6**: Bir Önceki Yılın Sonuna Göre Fark
• **7**: Hareketli Ortalama
• **8**: Hareketli Toplam

**frequency* (isteğe bağlı)*: Verilerin hangi sıklıkla çekileceğini belirler. Günlük, aylık, yıllık gibi frekanslar alınabilir.

Örnek sıklıklar:

• **1**: Günlük
• **2**: İşgünü
• **3**: Haftalık
• **4**: Ayda 2 Kez
• **5**: Aylık
• **6**: 3 Aylık
• **7**: 6 Aylık
• **8**: Yıllık

Kullanım:

data = evds.get_data(
    ['TP.DK.USD.A.YTL', 'TP.DK.EUR.A.YTL'], 
    startdate="01-01-2020", 
    enddate="01-01-2021"
)

Bu komut ile belirtilen tarihler arasında USD ve EUR alış kurları çekilecektir.

evds.get_data() komutu dışında EVDS sisteminde bulunan bütün raporlara ulaşabileceğimiz birkaç fonksiyon bulunmaktadır. Bu fonksiyonları sadece ilgili seri isimlerini bulmak için kullanacağız.

main_categories()

Bu fonksiyon, EVDS üzerinde bulunan ana veri kategorilerini listelemek için kullanılır. Veri kategorileri finansal ve ekonomik konulara göre organize edilmiştir. Sistem üzerinden çekebileceğiniz bütün kategorilere buradan bakabilirsiniz.

Kullanım:

categories = evds.main_categories
print(categories)

Bu komut aşağıdaki gibi bir sonuç döndürür;

get_sub_categories()

Bir ana kategori altında bulunan alt kategorileri listelemek için kullanılır. Ana kategori ID’si ya da adı ile çağrılabilir. main_categories() komutundan listelediğimiz ID’lerden veya adından çağırabiliriz.

Parametreler:

• **category_id**: Ana kategori ID’si veya adı. Alt kategorilerin hangi ana kategoriye ait olduğunu belirtir.

Kullanım:

sub_categories = evds.get_sub_categories(6)  # Ana kategori ID'si ile kullanım
print(sub_categories)

Alternatif olarak ana kategori adı ile de çağırılabilir

sub_categories = evds.get_sub_categories("KURLAR")
print(sub_categories)

Örnek Çıktı:

get_series()

Alt kategorilerdeki veri serilerini listelemek için kullanılır. Alt kategori adı ile ilgili veri serilerini çağırabilirsiniz.

Parametreler:

• **category_name**: Alt kategori adı. Hangi alt kategori altındaki veri serilerinin getirileceğini belirtir.

Kullanım:

series = evds.get_series('bie_dbdborc')  # Alt kategori kodu
print(series)

Örnek bir çıktı: (Özel olarak start_date verilmezse ilk veri tarihini alır.)

Temel olarak sadece evds.get_data() komutunu kullanacağız. Örnek olarak aylık kur grafiğini görüntülemek için bu şekilde daha kapsamlı bir kod yazabiliriz.

data = evds.get_data(
    series=['TP.DK.USD.A.YTL', 'TP.DK.EUR.A.YTL'],  # Döviz kurları serileri
    startdate="01-01-2023",  # Verilerin başlangıç tarihi
    enddate="31-12-2023",    # Verilerin bitiş tarihi
    frequency=5,
    aggregation_types='avg',
)

SONUÇ

Bu yazıda, EVDS API’sine Python aracılığıyla nasıl erişileceği, hangi parametrelerin kullanılabileceği ve verilerin nasıl çekileceği detaylıca açıklanmıştır. **evds.get_data()** fonksiyonunun sunduğu tüm esnek parametreler ile döviz kurları, faiz oranları gibi kritik verilere ulaşarak kendi analizlerinizi yapabilirsiniz.

Seri gruplarının ve serilerin kodlarını bulmak oldukça zor olduğundan Mert Alabaş’ın yaptığı listeden hepsine ulaşabilirsiniz. Kendisine ayrıca teşekkür ederim. **Liste için buraya tıklayın**

Benimle LinkedIn üzerinden bağlantı kurmak isterseniz buradan ulaşabilirsiniz.