Dış Ticaret (İhracat / İthalat / Denge)
get_trade_balanceRead-onlyIdempotent
Retrieve Turkey's foreign trade data: exports, imports, or trade balance (in thousand USD) for a specified period. Use to answer questions about monthly trade figures or deficits.
Instructions
Türkiye dış ticareti: ihracat, ithalat veya dış ticaret dengesi (aylık, bin USD).
Ne zaman kullanılır:
"İhracat/ithalat X ayında ne kadardı", "dış ticaret açığı son dönemde nasıl" sorularında.
flow='balance' → ihracat − ithalat (negatif = açık).
Parametreler:
flow: 'export' | 'import' | 'balance'
period: { start, end }
Dönüş: ortak şema — unit 'bin USD', basis 'düzey' (balance için 'düzey (ihracat − ithalat)'). Seri: Genel Ticaret Sistemi, ISIC Rev.4 Toplam (ihracat TP.IHRISICREV4.TT / ithalat TP.ITHISICREV4.TT).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| flow | Yes | 'export' = ihracat, 'import' = ithalat, 'balance' = denge (ihracat − ithalat). | |
| period | Yes | Inclusive date range to query. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | Methodology, caveats, or verification warnings, when relevant. | |
| unit | Yes | Unit of the values, e.g. '%', 'TL', 'endeks (2003=100)'. | |
| basis | Yes | What the numbers represent: 'nominal' | 'reel' | 'düzey' | 'yıllık % değişim' | ... | |
| label | Yes | Human-readable Turkish name of the series. | |
| series | Yes | EVDS series code that produced these observations (e.g. 'TP.DK.USD.A.YTL'). | |
| source | Yes | Always 'TCMB EVDS'. | |
| fetchedAt | Yes | ISO-8601 timestamp of when the data was fetched. | |
| observations | Yes | The time series, oldest to newest. |