Service metadata

Code snippets

curl "https://api.oanor.com/tcmb-api/v1/meta" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/tcmb-api/v1/meta", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/tcmb-api/v1/meta");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);

import requests
requests.get(
    "https://api.oanor.com/tcmb-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "date": "2026-06-10",
        "source": "TCMB daily exchange-rate XML (tcmb.gov.tr, live)",
        "service": "tcmb-api",
        "usd_try": 46.132,
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/rate": "One currency's four rates, mid and inverse (currency=USD).",
            "GET /v1/rates": "TCMB forex + banknote buy/sell for every currency vs the lira (optional date=YYYY-MM-DD).",
            "GET /v1/convert": "Convert an amount between two currencies at TCMB forex mid rates (from=USD, to=EUR, amount=100).",
            "GET /v1/currencies": "TCMB list of quoted currencies."
        },
        "description": "Live official exchange-rate data for the Turkish lira (TRY) from the Central Bank of the Republic of Türkiye (TCMB), via its public daily rate XML. The TCMB publishes four rates per currency — forex buying, forex selling, banknote buying and banknote selling. The rates endpoint returns all of these for every published currency against the lira, for the latest or any past business day, normalised to one unit; the rate endpoint returns one currency's four rates and the inverse; the convert endpoint converts an amount between any two published currencies (including TRY) at the forex mid rate; the currencies endpoint lists the quoted currencies. Live, no key, nothing stored. Distinct from the ECB, BCRA, BCRP, NRB and other central-bank feeds and from market mid-rates — this is the TCMB's own forex and banknote lira rates.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-10T22:58:46.812Z",
        "request_id": "1e5959c1-bcb0-49dc-84a5-2e79bf7755c6"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}