Banca Centrală a Republicii Turcia (CBRT) oferă o mulțime de date economice cruciale pentru cercetători, analiști și factorii de decizie politică. Prin intermediul Sistemului electronic de furnizare a datelor (EVDS), utilizatorii pot accesa date din serii temporale privind diverși indicatori economici. Cu CBRT Pachetul R, acest proces devine eficient, dând putere utilizatorilor să integreze datele CBRT direct în fluxurile lor de lucru R. Această postare de blog analizează detaliile accesării datelor CBRT folosind pachetul, explicând totul, de la obținerea unei chei API până la exemple practice de recuperare a serii economice.
Introducere
CBRT servește ca bancă centrală a Turciei, însărcinată cu implementarea politicilor monetare și menținerea stabilității financiare. EVDS (Elektronik Veri Dağıtım Sistemi) este platforma online de livrare a datelor a CBRT, care oferă acces la un depozit vast de date economice, inclusiv indici de preț, rate de schimb, agregate monetare și multe altele. EVDS acceptă recuperarea datelor bazată pe API, permițând accesul programatic la seturile sale de date.
EVDS
Sistemul electronic de furnizare a datelor (EVDS) este un sistem dinamic și interactiv care prezintă date statistice în serie de timp produse de CBRT și/sau date produse de alte instituții și compilate de CBRT. Aceste date sunt publicate pe pagini web dinamice. Ele pot fi raportate și în format xls sau prin clientul serviciului web (json, csv, xml), vizualizate în format grafic și primite prin e-mail prin abonarea la sistem. EVDS a fost introdus pentru prima dată în 1995 și este disponibil în turcă și engleză.
Sistemul oferă o gamă bogată de date și informații economice pentru a sprijini educația economică și pentru a promova cercetarea economică. Infrastructura sa tehnică a fost revizuită în octombrie 2017. EVDS servește publicului cu noile sale facilități și conținut, cum ar fi serviciul web REST, personalizare, rapoarte, diagrame interactive, grupuri de date utilizate frecvent, grupuri de date actualizate recent și date afișate pe Turcia și hărțile lumii.
Configurarea accesului: cheia API
Pentru a accesa datele EVDS în mod programatic, aveți nevoie de o cheie API, care servește ca un identificator unic pentru autentificarea solicitărilor dvs.
-
Solicitarea unei chei API:
Vizitați EVDS și creați un cont. Odată autentificat, navigați la secțiunea de acces API pentru a vă genera cheia personală API. -
Stocarea cheii dvs. API în siguranță:
Evitați să vă codificați cheia API în scripturi. În schimb, salvați-l într-un.txtfișier și citiți-l în sesiunea dvs. R. De exemplu:
api_key <- readLines("path/to/your_api_key.txt")
Pachetul CBRT
The Pachetul CBRT Rdezvoltat de prof. dr. Erol Taymaz de la Universitatea Tehnică din Orientul Mijlociu, este un instrument puternic conceput pentru a simplifica recuperarea datelor din sistemul electronic de livrare a datelor (EVDS) al Băncii Centrale a Republicii Turcia (CBRT). Acest pachet permite utilizatorilor să acceseze și să analizeze eficient indicatorii economici prin furnizarea de funcții pentru interogarea serii de date, preluarea metadatelor și căutarea seturilor de date relevante prin API-ul EVDS. Pachetul CBRT include funcții pentru găsirea și descărcarea datelor din baza de date a Băncii Centrale a Republicii Turcia. Baza de date CBRT acoperă mai mult de 40.000 de variabile de serie de timp. Pentru documentație detaliată și informații suplimentare despre pachet, puteți vizita acest link.
Pachetul este acum disponibil la CRAN (13 noiembrie 2024) și poate fi instalat de
Funcții de bază
Toate serii de date (variabile) sunt clasificate în grupuri de dateși grupuri de date în categorii de date. Există 44 de categorii de date (inclusiv cele arhivate), 499 de grupuri de date și 40.826 de serii de date.
getAllCategoriesInfo
The getAllCategoriesInfo funcţia în Pachetul CBRT R oferă o modalitate convenabilă de a accesa informații despre principalele categorii de date disponibile în sistemul electronic de livrare a datelor (EVDS) al Băncii Centrale a Republicii Turcia (CBRT). Această funcție necesită o cheie API validă ca argument pentru a vă autentifica solicitarea. Prin preluarea unei liste structurate a acestor categorii, utilizatorii pot explora organizarea la nivel înalt a datelor economice oferite de API-ul EVDS.
library(CBRT)
my_api_key <- readLines("D:/evds_api_key.txt",warn=FALSE)
Categories <- getAllCategoriesInfo(CBRTKey = my_api_key)
head(Categories)
cid topic 1: 1 MARKET DATA (CBRT) 2: 2 EXCHANGE RATES (CBRT) 3: 3 INTEREST RATE STATISTICS (CBRT) 4: 4 MONTHLY MONEY AND BANK STATISTICS (CBRT) 5: 5 SECURITIES STATISTICS (CBRT) 6: 12 FINANCIAL SERVICES SURVEY (CBRT)
getAllGroupsInfo
The Pachetul CBRT R oferă getAllGroupsInfo funcția, care permite utilizatorilor să acceseze informații detaliate despre grupurile din anumite categorii din Sistemul Electronic de Livrare a Datelor (EVDS) al Băncii Centrale a Republicii Turcia (CBRT). Similar cu getAllCategoriesInfoaceastă funcție necesită o cheie API validă pentru autentificare. Grupurile reprezintă subcategorii sau clasificări mai fine ale datelor în cadrul principalelor categorii mai largi. Prin pârghie cid (ID categorie) variabilă din tabelul de categorii, utilizatorii pot stabili o relație între categorii și grupurile corespunzătoare. Această funcționalitate oferă o abordare structurată pentru explorarea ierarhiei datelor economice în EVDS, permițând utilizatorilor să navigheze și să identifice eficient seturile de date cele mai relevante pentru cercetarea sau analiza lor.
Groups <- getAllGroupsInfo(CBRTKey = my_api_key) head(Groups)
cid groupCode
1: 1 bie_pyrepo
2: 0 bie_mkbral
3: 25 bie_mkaltytl
4: 1 bie_ppibsm
5: 1 bie_pyintbnk
6: 1 bie_tldov
groupName
1: Open Market Repo and Reverse Repo Transactions
2: Istanbul Gold Exchange (TRY_USD) (Archive)
3: Gold Prices (Averaged) - Free Market (TRY)
4: Free Deposits of Banks and Total Liquidity (Beginning of the Day)(Million TRY)(CBRT)
5: Interbank Money Market Transactions Summary (TRY Thousand or %)
6: Total Volume of FX Transaction of Banks Against Turkish Lira (Million USD, CBRT)
freq source sourceLink revisionPolicy appLink firstDate lastDate
1: 5 CBRT 01-08-2020 01-05-1989
2: 2 BORSA ISTANBUL 29-06-2018 27-07-1995
3: 5 Market 01-11-2024 01-12-1950
4: 2 CBRT 31-12-2024 04-01-2007
5: 2 CBRT 30-12-2024 04-11-1996
6: 2 CBRT 23-12-2024 14-10-2002
În plus, tabelul de grupuri conține metadate valoroase, inclusiv intervalele de date pentru datele disponibile, frecvența datelor și sursele de date. Frecvența datelor este indicată prin coduri de frecvență predefinite:
-
Zilnic
-
Zi de lucru
-
Săptămânal
-
Bisăptămânal
-
Lunar
-
Trimestrial
-
Semianual
-
Anual
getAllSeriesInfo
The getAllSeriesInfo funcţia în Pachetul CBRT R permite utilizatorilor să recupereze metadate actualizate pentru seriile de date disponibile în Sistemul Electronic de Livrare a Datelor (EVDS) al Băncii Centrale a Republicii Turcia (CBRT). Această funcție, ca și altele din pachet, necesită o cheie API validă pentru autentificare. Metadatele includ detalii esențiale, cum ar fi coduri de grup, nume de serie și alte informații relevante despre seturile de date dintr-un subiect ales. Aceste detalii ajută utilizatorii să identifice și să filtreze anumite serii de interese. În plus, prin utilizarea variabilelor cheie, metadatele seriei pot fi legate de tabelele de categorii și grupuri, permițând utilizatorilor să stabilească relații în întreaga ierarhie a datelor. Această capacitate asigură o explorare structurată și interconectată a seturilor de date economice, simplificând procesul de localizare și analiză a datelor relevante pentru cercetare sau analiză.
Series <- getAllSeriesInfo(CBRTKey = my_api_key)
head(Series)
cid topic
1: 7 DEPOSITS AND PARTICIPATION FUNDS SUBJECT TO REQUIRED RESERVES (CBRT)
2: 7 DEPOSITS AND PARTICIPATION FUNDS SUBJECT TO REQUIRED RESERVES (CBRT)
3: 7 DEPOSITS AND PARTICIPATION FUNDS SUBJECT TO REQUIRED RESERVES (CBRT)
4: 7 DEPOSITS AND PARTICIPATION FUNDS SUBJECT TO REQUIRED RESERVES (CBRT)
5: 7 DEPOSITS AND PARTICIPATION FUNDS SUBJECT TO REQUIRED RESERVES (CBRT)
6: 7 DEPOSITS AND PARTICIPATION FUNDS SUBJECT TO REQUIRED RESERVES (CBRT)
groupCode
1: bie_KYBKATFON
2: bie_KYBKATFON
3: bie_KYBKATFON
4: bie_KYBKATFON
5: bie_KYBKATFON
6: bie_KYBKATFON
groupName freq
1: Breakdown of Participation Funds Subject to Reserve Requirements 3
2: Breakdown of Participation Funds Subject to Reserve Requirements 3
3: Breakdown of Participation Funds Subject to Reserve Requirements 3
4: Breakdown of Participation Funds Subject to Reserve Requirements 3
5: Breakdown of Participation Funds Subject to Reserve Requirements 3
6: Breakdown of Participation Funds Subject to Reserve Requirements 3
seriesCode seriesName start end
1: TP.KYBKATFON.KB1 Turkish Lira_Turkish Lira Accounts 10-05-2002 13-12-2024
2: TP.KYBKATFON.KB2 Fx Accounts (USD) 10-05-2002 13-12-2024
3: TP.KYBKATFON.KB3 Fx Accounts (EURO) 10-05-2002 13-12-2024
4: TP.KYBKATFON.KB4 Fx Accounts Precious Minerals (USD) 14-10-2011 13-12-2024
5: TP.KYBKATFON.KB5 Fx Accounts Other (USD) 10-05-2002 13-12-2024
6: TP.KYBKATFON.KB6 Total Fx Accounts (USD) 10-05-2002 13-12-2024
aggMethod freqname tag
1: last Week
2: last Week
3: last Week
4: last Week
5: last Week
6: last Week
cautăCBRT
The searchCBRT funcţia în Pachetul CBRT R oferă un instrument puternic pentru căutarea oricărei categorii, grup sau nume de serie în cadrul Sistemului electronic de livrare a datelor (EVDS) al Băncii Centrale a Republicii Turcia (CBRT). Prin specificarea cuvintelor cheie și a câmpului dorit în care să caute, utilizatorii pot localiza eficient seturile de date relevante. Această funcție simplifică procesul de găsire a informațiilor specifice în depozitul extins EVDS, permițând accesul direct la tabelul sau setul de date dorit. Fie că se caută subiecte ample, grupuri specifice sau serii de date individuale, searchCBRT oferă o modalitate flexibilă și eficientă de a naviga prin sistem și de a identifica datele necesare pentru analiză.
Să presupunem că dorim să găsim seturi de date legate de „Prețurile de consum” în cadrul sistemului EVDS. Folosind searchCBRT funcție, putem căuta acest cuvânt cheie în câmpurile relevante pentru a localiza tabelele sau seriile dorite. Iată cum să o faci:
searchCBRT("consumer price", field = "series")
seriesCode
1: TP.ENFBEK.TEA12
2: TP.ENFBEK.TEA345
3: TP.FE.OKTG01
4: TP.FG.A09
5: TP.FG.A10
6: TP.TG2.Y14
7: TP.TG2.Y15
8: TP.FG.F19
9: TP.FG.F20
seriesName
1: Percentage of households expecting consumer prices to increase more rapidly or at the same rate (%)
2: Percentage of households expecting consumer prices to stay about the same, fall or increase at a slower rate (%)
3: Consumer Price Index
4: Consumer Prices Index of Ankara (Archive)
5: Consumer Prices Index of Istanbul (Archive)
6: Assessment on Consumer prices change rate (over the last 12 months)
7: Expectation for consumer prices change rate (over the next 12 months compared to the past 12 months)
8: Ankara Consumer Price Index (Archive)
9: Istanbul Consumer Price Index (Archive)
groupCode
1: bie_enfbek
2: bie_enfbek
3: bie_feoktg
4: bie_fgtukfiy2
5: bie_fgtukfiy2
6: bie_mbgven2
7: bie_mbgven2
8: bie_tukfiy1
9: bie_tukfiy1
groupName
1: Sectoral Inflation Expectations
2: Sectoral Inflation Expectations
3: TURKSTAT- Consumer Price Index-Indicators for the CPI's Having Specified Coverages (2003=100)(New Series)
4: Consumer Price Index (1987=100) (TURKSTAT) (Archive)
5: Consumer Price Index (1987=100) (TURKSTAT) (Archive)
6: Seasonally unadjusted Consumer Confidence Index and Indices of Consumer Tendency Survey Questions (*)
7: Seasonally unadjusted Consumer Confidence Index and Indices of Consumer Tendency Survey Questions (*)
8: Consumer Price Index (1978_1979=100) (TURKSTAT) (Archive)
9: Consumer Price Index (1978_1979=100) (TURKSTAT) (Archive)
getDataSeries
The getDataSeries funcţia în Pachetul CBRT R este un instrument versatil pentru importarea uneia sau mai multor serii de timp direct din EVDS. Această funcție oferă utilizatorilor mai multe funcții avansate pentru a-și personaliza recuperarea datelor. De exemplu, utilizatorii pot specifica nivelul de frecvență (freq), cum ar fi zilnic, săptămânal sau lunar și setați un interval de date utilizând startDate şi endDate argumente în format DD-MM-YYYY. Dacă endDate nu este specificat, funcția preia automat date până la cel mai recent punct disponibil.
O caracteristică suplimentară a getDataSeries este capacitatea sa de a agrega date cu frecvență mai mare în formate cu frecvență mai joasă folosind aggType argument. Metodele de agregare acceptate includ:
-
avg: valoare medie, -
first: Prima observație, -
last: Ultima observatie, -
max: valoarea maximă, -
min: valoare minimă, -
sum: Însumarea valorilor.
De exemplu, dacă datele săptămânale sunt agregate la o frecvență lunară, se aplică metoda de agregare pentru a calcula valorile rezultate. În plus, cel na.rm Argumentul permite utilizatorilor să renunțe la toate datele lipsă, asigurând date curate și continue din seria temporală.
Iată un exemplu care demonstrează utilizarea acestuia:
# Import a time series (e.g., CPI data) with specific parameters
cpi_data <- getDataSeries(
series = c("TP.FE.OKTG01"), # Example series ID
CBRTKey = my_api_key, # Your API key
freq = 5, # Monthly frequency
startDate = "01-01-2010", # Start date
endDate = "31-12-2023", # End date
na.rm = TRUE # Remove missing dates
)
# View the imported data
head(cpi_data)
time TP.FE.OKTG01 1: 2010-01-15 174.07 2: 2010-02-15 176.59 3: 2010-03-15 177.62 4: 2010-04-15 178.68 5: 2010-05-15 178.04 6: 2010-06-15 177.04
De exemplu, dorim să obținem cursuri de schimb pentru USD, EUR și GBP față de lira turcească (TRY) pentru o anumită perioadă de timp, cu frecvență lunară.
# Define the series IDs for USD, EUR, and GBP (Sales rate against TRY) usd_series <- "TP.DK.USD.S" eur_series <- "TP.DK.EUR.S" gbp_series <- "TP.DK.GBP.S" # Define the frequency method freq <- 5 # Monthly frequency # Define the date range for the data (e.g., from 01-01-2020 to 31-12-2024) startDate <- "01-01-2020" endDate <- "31-12-2024" # Fetch the data for USD, EUR, and GBP exchange rates exchange_data <- getDataSeries( series = c(usd_series,eur_series,gbp_series), CBRTKey = my_api_key, freq = freq, startDate = startDate, endDate = endDate, na.rm = TRUE ) head(exchange_data)
time TP.DK.USD.S TP.DK.EUR.S TP.DK.GBP.S 1: 2020-01-15 5.928827 6.586905 7.763218 2: 2020-02-15 6.055370 6.605785 7.872095 3: 2020-03-15 6.325805 7.001341 7.858764 4: 2020-04-15 6.831252 7.430133 8.493257 5: 2020-05-15 6.964488 7.573124 8.588112 6: 2020-06-15 6.821091 7.676245 8.560195
Concluzie
The CBRT Pachetul R este un instrument puternic pentru accesarea și analiza datelor economice turcești. Combinând funcționalitatea pachetului cu instrumentele analitice robuste ale lui R, utilizatorii își pot debloca informații și își pot eficientiza cercetarea. Indiferent dacă urmăriți tendințele inflației, analizați impactul politicii monetare sau studiați ratele de schimb, CBRT pachetul oferă o experiență perfectă.
