TCMB Verileri

Description

TCMB (Türkiye Cumhuriyet Merkez Bankası) tarafından yayımlanan makroekonomik verilerin tarihsel olarak sorgulanmasını sağlar. İhracat-ithalat, iç/dış borçlar, ödemeler dengesi, cari işlemler dengesi ve finans hesapları gibi farklı veri setlerine type parametresi ile erişilir. İstek atıldığında ilgili type için tablodaki tüm veriler döner. Bir veri seti diğer veri setleri ile birlikte çağırılamaz.

Endpoint

HTTP GET
Endpoint https://apitest.matriksdata.com/dumrul/v1/tcmb

Query Parameters

Parameter	Type	Required	Example	Description
type	text	true	trade	Veri seti tipi. Aşağıdaki tabloda belirtilen değerlerden biri verilmelidir. İstek atıldığında ilgili type için tablodaki tüm veriler döner.

Type Değerleri

Type	Ekran	Periyot
trade	İhracat-İthalat	Aylık
debt	Borçlar	Çeyreklik
externalDebt	Dış Borçlar	Çeyreklik
domesticDebt	İç Borçlar	Aylık
bop	Ödemeler Dengesi (Aylık)	Aylık
bopAnnual	Ödemeler Dengesi (Yıllık)	Yıllık
currentAccount	Cari İşlemler Dengesi	Aylık
financialAccount	Finans Hesapları	Aylık

Response Description

İhracat-İthalat (type=trade)

Her bir aya ait veri ayrı bir obje olarak döner. Fark ve karşılama oranı hesaplanarak döner. Dolar kuru ilgili ay sonu değeridir.

"date": "Tarih (Ay Sonu)"
"exports": "İhracat (bin USD)"
"imports": "İthalat (bin USD)"
"balance": "Fark (İhracat - İthalat)"
"coverageRatio": "Karşılama Oranı (İhracat / İthalat * 100)"
"usdRate": "Dolar Kuru (İlgili Ay Sonu)"

Borçlar (type=debt)

Çeyreklik veri döner. İç borç ve dış borç USD cinsindendir. Toplam hesaplanarak döner.

"date": "Tarih (Çeyrek Sonu)"
"domesticDebt": "İç Borç Stoku (Milyon USD)"
"externalDebt": "Dış Borç Stoku (Milyon USD)"
"totalDebt": "Toplam Borç (İç + Dış)"

Dış Borçlar (type=externalDebt)

Çeyreklik veri döner. Tüm değerler dolar cinsindendir. Kısa vadeli yüzdesi hesaplanarak döner.

"date": "Tarih (Çeyrek Sonu)"
"shortTerm": "Kısa Vadeli Dış Borç (Milyon USD)"
"longTerm": "Uzun Vadeli Dış Borç (Milyon USD)"
"shortTermPct": "Kısa Vadeli Yüzdesi (Kısa Vadeli / Toplam * 100)"
"total": "Toplam Dış Borç (Milyon USD)"

İç Borçlar (type=domesticDebt)

Aylık veri döner. Tüm değerler TL cinsindendir. Diğer kalemi toplam üzerinden hesaplanarak döner.

"date": "Tarih (Çeyrek Sonu)"
"bond": "Tahvil (Bin TL)"
"bill": "Bono (Bin TL)"
"other": "Diğer (Bin TL) — Toplam - (Tahvil + Bono)"
"total": "Toplam İç Borç Stoku (Bin TL)"

Ödemeler Dengesi — Aylık (type=bop)

Aylık veri döner. Tüm değerler milyon dolar cinsindendir.

"date": "Tarih (Ay Sonu)"
"currentAccount": "Cari İşlemler Dengesi (Milyon USD)"
"financialAccount": "Finansal Hesaplar (Milyon USD)"
"netErrors": "Net Hata Noksan (Milyon USD)"

Ödemeler Dengesi — Yıllık (type=bopAnnual)

Yıllık veri döner. Aynı verilerin yıllık kırılımıdır. Tüm değerler milyon dolar cinsindendir.

"date": "Tarih (Yıl Sonu)"
"currentAccount": "Cari İşlemler Dengesi (Milyon USD)"
"financialAccount": "Finansal Hesaplar (Milyon USD)"
"netErrors": "Net Hata Noksan (Milyon USD)"

Cari İşlemler Dengesi (type=currentAccount)

Aylık veri döner. Cari işlemler dengesinin alt kırılımlarını gösterir. Tüm değerler milyon dolar cinsindendir.

"date": "Tarih (Ay Sonu)"
"tradeBalance": "Dış Ticaret Dengesi (Milyon USD)"
"servicesBalance": "Hizmetler Dengesi (Milyon USD)"
"primaryIncome": "Birincil Gelir Dengesi (Milyon USD)"
"secondaryIncome": "İkincil Gelir Dengesi (Milyon USD)"

Finans Hesapları (type=financialAccount)

Aylık veri döner. Finansal hesapların alt kırılımlarını gösterir. Tüm değerler milyon dolar cinsindendir.

"date": "Tarih (Ay Sonu)"
"directInvestment": "Doğrudan Yatırımlar (Milyon USD)"
"portfolioInvestment": "Portföy Yatırımları (Milyon USD)"
"otherInvestment": "Diğer Yatırımlar (Milyon USD)"
"reserveAssets": "Rezerv Varlıklar (Milyon USD)"

Sample Request-Response

İhracat-İthalat

https://apitest.matriksdata.com/dumrul/v1/tcmb?type=trade

[
    {
        "date": "2020-01",
        "exports": 14701547.01,
        "imports": 19214398.178,
        "usdRate": 5.98,
        "balance": -4512851.17,
        "coverageRatio": 76.51
    },
    {
        "date": "2020-02",
        "exports": 14608457.412,
        "imports": 17643981.702,
        "usdRate": 6.16,
        "balance": -3035524.29,
        "coverageRatio": 82.8
    },
    {
        "date": "2020-03",
        "exports": 13353541.661,
        "imports": 18822162.535,
        "usdRate": 6.52,
        "balance": -5468620.87,
        "coverageRatio": 70.95
    }
]

Borçlar

https://apitest.matriksdata.com/dumrul/v1/tcmb?type=debt

[
    {
        "date": "2020-Q1",
        "domesticDebt": 785555663.6666666,
        "externalDebt": 374177,
        "totalDebt": 374177
    },
    {
        "date": "2020-Q2",
        "domesticDebt": 942981206.6666666,
        "externalDebt": 372925,
        "totalDebt": 372925
    },
    {
        "date": "2020-Q3",
        "domesticDebt": 1083641428.6666667,
        "externalDebt": 371580,
        "totalDebt": 371580
    },
    {
        "date": "2020-Q4",
        "domesticDebt": 1081252491.6666667,
        "externalDebt": 390692,
        "totalDebt": 390692
    }
]

Dış Borçlar

https://apitest.matriksdata.com/dumrul/v1/tcmb?type=externalDebt

[
    {
        "date": "2020-Q1",
        "shortTerm": 92291,
        "longTerm": 281886,
        "total": 374177,
        "shortTermPct": 24.67
    },
    {
        "date": "2020-Q2",
        "shortTerm": 98937,
        "longTerm": 273988,
        "total": 372925,
        "shortTermPct": 26.53
    },
    {
        "date": "2020-Q3",
        "shortTerm": 105910,
        "longTerm": 265670,
        "total": 371580,
        "shortTermPct": 28.5
    }
]

İç Borçlar

https://apitest.matriksdata.com/dumrul/v1/tcmb?type=domesticDebt

[
    {
        "date": "2020-01",
        "bond": 745520809,
        "bill": 16385819,
        "total": 761906628,
        "other": 0
    },
    {
        "date": "2020-02",
        "bond": 774000378,
        "bill": 11992024,
        "total": 785992402,
        "other": 0
    },
    {
        "date": "2020-03",
        "bond": 796775936,
        "bill": 11992024,
        "total": 808767961,
        "other": 1
    }
]

Ödemeler Dengesi (Aylık)

https://apitest.matriksdata.com/dumrul/v1/tcmb?type=bop

[
    {
        "date": "2020-01",
        "currentAccount": -1160,
        "financialAccount": -1786,
        "netErrors": -618
    },
    {
        "date": "2020-02",
        "currentAccount": -587,
        "financialAccount": -1062,
        "netErrors": -473
    },
    {
        "date": "2020-03",
        "currentAccount": -4943,
        "financialAccount": -9684,
        "netErrors": -4738
    }
]

Ödemeler Dengesi (Yıllık)

https://apitest.matriksdata.com/dumrul/v1/tcmb?type=bopAnnual

[
    {
        "date": "2020",
        "currentAccount": -2585.33333333,
        "financialAccount": -3228.83333333,
        "netErrors": -640.5
    },
    {
        "date": "2021",
        "currentAccount": -589,
        "financialAccount": 279.91666667,
        "netErrors": 874.16666667
    },
    {
        "date": "2022",
        "currentAccount": -3889,
        "financialAccount": -1518.25,
        "netErrors": 2373.66666667
    }
]

Cari İşlemler Dengesi

https://apitest.matriksdata.com/dumrul/v1/tcmb?type=currentAccount

[
    {
        "date": "2020-01",
        "tradeBalance": -3318,
        "servicesBalance": 2336,
        "primaryIncome": -272,
        "secondaryIncome": 94
    },
    {
        "date": "2020-02",
        "tradeBalance": -1943,
        "servicesBalance": 2157,
        "primaryIncome": -671,
        "secondaryIncome": -130
    },
    {
        "date": "2020-03",
        "tradeBalance": -4355,
        "servicesBalance": 780,
        "primaryIncome": -1102,
        "secondaryIncome": -266
    }
]

Finans Hesapları

https://apitest.matriksdata.com/dumrul/v1/tcmb?type=financialAccount

[
    {
        "date": "2020-01",
        "directInvestment": -766,
        "portfolioInvestment": 1544,
        "otherInvestment": 370,
        "reserveAssets": -2934
    },
    {
        "date": "2020-02",
        "directInvestment": -352,
        "portfolioInvestment": -938,
        "otherInvestment": -2772,
        "reserveAssets": 3000
    },
    {
        "date": "2020-03",
        "directInvestment": -739,
        "portfolioInvestment": 5112,
        "otherInvestment": 2532,
        "reserveAssets": -16589
    }
]