Extended rates (Bid\Ask) - Global Exchange Rates

The response returned by the exchange rates endpoints is, by default, a compact format containing only the midpoint rates.

💡

If the provider does not publish midpoint data directly, it is calculated from the original Bid/Ask values.

You can request the extended response by setting the extended query parameter to true. In this case, the response will include an array of exchange rates with Bid and Ask values in addition to the midpoint rate.

📌

The extended rates (Bid/Ask) are only available for subscribers to the ENTERPRISE plan.

The extended response is avaiable for all supported formats (json, xml, csv).

{
    "provider": "TCMB",
    "date": "2025-09-08",
    "base": "TRY",
    "exchangeRates": [
        {
            "currency": "USD",
            "mid": 0.0242608331,
            "bid": 0.0242390161,
            "ask": 0.0242826894
        }
    ]
}

💡

Bid/Ask rates are available only for providers that support them.

You can check which providers support Bid/Ask by calling the /provider endpoint and verifying the bidAsk field.

{
        "code": "TCMB",
        "description": "Central Bank of the Republic of Türkiye",
        "country": "TURKEY",
        "referenceCurrency": "TRY",
        "timeSeries": true,
        "monthly": false,
        "countryCode": "TR",
        "bidAsk": true
    }