Turkish central bank exchange rates on a date
get_rates_on_dateReturns the TCMB bulletin published on a given date (history back to 1996). If no bulletin was published that day (weekend, holiday, or today before ~15:30 TRT), returns the previous bulletin with is_fallback=true and a fallback_reason. Bulletins before 2005-01-01 are in old Turkish lira (domestic_currency TRL). Source: Central Bank of the Republic of Türkiye (CBRT/TCMB) daily indicative bulletin, published on business days around 15:30 Türkiye time (UTC+3). Rates are TRY per unit of currency (JPY is per 100). Decimals are strings. Every result includes source_url, bulletin_date and a disclaimer; rates are indicative, not for official use.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"date": "<date>"
},
"name": "get_rates_on_date"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | Yes | Bulletin date, YYYY-MM-DD | |
| currencies | No | Currency codes to include; omit for all (about 20 currencies) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| rates | Yes | ||
| source | Yes | ||
| disclaimer | Yes | ||
| source_url | Yes | ||
| bulletin_no | Yes | ||
| is_fallback | Yes | ||
| retrieved_at | Yes | ||
| bulletin_date | Yes | ||
| requested_date | Yes | ||
| fallback_reason | Yes | ||
| domestic_currency | Yes |