bddkR

Türkçe tercih edenler için:

Those who prefer English can scroll down the page.

Paket Hakkında

bddkR, Türkiye'deki bankacılık sektörünün finansal verilerine kolay erişim sağlayan özel olarak geliştirilmiş ilk R paketidir. Bu paket, Python'da bddkdata kütüphanesinin R ekosistemine uyarlanmış versiyonudur. BDDK'nın (Bankacılık Düzenleme ve Denetleme Kurumu) resmi web sitesinden yayınlanan aylık finansal raporları, bankacılık istatistikleri ve sektörel göstergeleri otomatik olarak çeker ve analiz için hazır hale getirir. Araştırmacılar, finans uzmanları ve veri analistleri için tasarlanan bu araç, bankacılık verilerini hızla tibble formatında sunar.

Özellikler

Kurulum

Yakında CRAN'da

R ortamınızda paketi kullanmaya başlamak için:

  1. R yazılımını indirin ve kurun: https://www.r-project.org/

  2. Bağımlı paketleri sisteminize ekleyin:

  3. R yazılımını indirin ve kurun: https://www.r-project.org/

  4. Bağımlı paketleri sisteminize ekleyin:

install.packages(c("httr", "jsonlite", "dplyr", "writexl", "lubridate"))
  1. GitHub deposundan bddkR paketini yükleyin:
# devtools kurulu değilse önce yükleyin
install.packages("devtools")

Ana paketi GitHub'dan çekin

devtools::install_github("ozancanozdemir/bddkR")

Ana Fonksiyon

fetch_data : BDDK'nın API sisteminden bankacılık verilerini çeker ve düzenler.

Parametreler:

Çıktı:

tibble formatında bankacılık verisi (veri bulunamadığında NULL)

Erişilebilir Finansal Tablolar:

Banka Kategorileri:

Kullanım Örnekleri

library(bddkR)

# 2024 yılı bilanço verilerini çek
bilanço_verileri <- fetch_data(
  start_year = 2024,
  start_month = 1,
  end_year = 2024,
  end_month = 12,
  table_no = 1,
  currency = "TL",
  group = 10001,
  lang = "tr",
  save_excel = FALSE
)

# Sonuçları incele
head(bilanço_verileri)

# Gelir tablosunu İngilizce olarak çek ve Excel'e kaydet
income_statement <- fetch_data(
  start_year = 2023,
  start_month = 6,
  end_year = 2024,
  end_month = 6,
  table_no = 2,
  currency = "TL",
  group = 10004,
  lang = "en",
  save_excel = TRUE
)

# Çoklu tablo analizi için döngü
sektör_analizi <- list()
for (tablo in c(1, 2, 3, 15)) {  # Bilanço, Gelir, Kredi, Oranlar
  sektör_analizi[[tablo]] <- fetch_data(
    start_year = 2024,
    start_month = 1,
    end_year = 2024,
    end_month = 6,
    table_no = tablo,
    currency = "TL",
    group = 10001,
    lang = "tr"
  )
}

Teknik Notlar

Paket, BDDK'nın güncel web servislerini kullanır ve veri erişiminde herhangi bir kısıtlama yoktur. API çağrıları sırasında SSL doğrulama ayarları BDDK sunucularına uygun şekilde yapılandırılmıştır. Veri yapısı optimizasyonu için gereksiz sütunlar otomatik olarak temizlenir. Tüm fonksiyonlar package::function formatında yazılarak ad çakışmaları önlenmiştir. Hata durumlarında detaylı bilgi mesajları görüntülenir.

Lisans

MIT Lisansı altında açık kaynak olarak sunulmaktadır.

About the Package

bddkR is the first R package specifically developed to provide easy access to financial data from the banking sector in Turkey. This package is an adaptation of the Python library bddkdata for the R ecosystem. It automatically retrieves monthly financial reports, banking statistics, and sectoral indicators published by the BRSA (Banking Regulation and Supervision Agency) and prepares them for analysis. Designed for researchers, finance professionals, and data analysts, this tool delivers banking data quickly in tibble format.

Features

Installation

To start using the package in your R environment:

  1. Download and install R: https://www.r-project.org/
  2. Add the required dependencies to your system:
install.packages(c("httr", "jsonlite", "dplyr", "writexl", "lubridate"))
  1. Install the bddkR package from GitHub:
#Install devtools if not already installed
install.packages("devtools")

Pull the main package from GitHub

devtools::install_github("ozancanozdemir/bddkR")

Main Function

fetch_data : Retrieves and organizes banking data from the BRSA's API system.

Parameters:

Output:

Banking data in tibble format (NULL if no data is found)

Available Financial Tables:

Bank Categories:

Usage Examples

library(bddkR)

Retrieve 2024 balance sheet data
balance_data <- fetch_data(
start_year = 2024,
start_month = 1,
end_year = 2024,
end_month = 12,
table_no = 1,
currency = "TL",
group = 10001,
lang = "tr",
save_excel = FALSE
)

View results
head(balance_data)

Retrieve income statement in English and save to Excel
income_statement <- fetch_data(
start_year = 2023,
start_month = 6,
end_year = 2024,
end_month = 6,
table_no = 2,
currency = "TL",
group = 10004,
lang = "en",
save_excel = TRUE
)

Loop for multi-table analysis
sector_analysis <- list()
for (table in c(1, 2, 3, 15)) { # Balance Sheet, Income, Loans, Ratios
sector_analysis[[table]] <- fetch_data(
start_year = 2024,
start_month = 1,
end_year = 2024,
end_month = 6,
table_no = table,
currency = "TL",
group = 10001,
lang = "tr"
)
}

Technical Notes

The package uses the BRSA's updated web services with no restrictions on data access.
SSL verification settings are configured according to BRSA servers during API calls.
Unnecessary columns are automatically cleaned for optimized data structure.
All functions are written in package::function format to prevent naming conflicts.
Detailed error messages are displayed in case of issues.

License

Released under the MIT License as open-source software.