Introduction

evdspy is an open-source Python interface designed to simplify requests to the Central Bank of the Republic of Turkey (CBRT) Electronic Data Delivery System (EVDS). It provides efficient request handling by caching results, a user-friendly menu for data inquiries, and capabilities for managing complex data structures through an accessible API. This makes evdspy ideal for financial analysts, data scientists, and researchers working with CBRT data.

View Source Code

You can view the source code for this project on GitHub: View Source.

What’s New

Updated in this version:

• The API key parameter has been moved to the HTTP header to enhance security and ensure that sensitive information is not exposed in URLs.

• Added a new function, get_series, which improves the handling of data groups and series.

• Deprecated: The get_datagroup function will be deprecated in future versions; get_series will cover its functionalities.

• evdspyChat Application Added

  The evdspyChat application has been added. An API key is not required for questions related to evdspy documentation.

evdspyChat

Key Features

• API Key Management: Automatically saves the API key to a file when provided to the get_series function, ignoring subsequent entries unless explicitly updated.

• Visual and Textual Menu Options: Provides both visual and textual menus to facilitate user interaction for setting up projects, creating output folders, and preparing configuration files.

• Data Request Handling: Utilizes caching to optimize data retrieval, minimizing redundant requests and speeding up the data access process.

Installation

To install evdspy, simply run the following command:

pip install evdspy -U

Quick Start

Here’s a quick example to get you started with using evdspy:

!

Using the get_series function from evdspy:

from evdspy import get_series
index = "TP.ODEMGZS.BDTTOPLAM"
df = get_series(index, start_date="2020-01-21", end_date="2021-12-31", frequency="monthly")
print(df.head())

Using the get_series_exp function from evdspy:

from evdspy import get_series, get_series_exp
index = "TP.ODEMGZS.BDTTOPLAM"
result = get_series_exp(index, start_date="2020-01-21", end_date="2021-12-31", frequency="monthly")
print(result.data)  # data frame of data
print(result.metadata)  # metadata frame of data
result.to_excel('filename.xlsx')  # write output as excel file data and metadata in sheets