The BittyTaxAPI is a free service for current and historical foreign exchange rates published by the European Central Bank. The reference rates are updated around 16:00 CET every working day.

BittyTaxAPI was created in response to the discontinuation of a free, and usable service, by both RatesAPI and ExchangeRatesAPI.

The rates returned by BittyTaxAPI are fully backwards compatible with those of RatesAPI and ExchangeRatesAPI, i.e. rounded to 10 decimal places.

This API may evolve to support other functions in the future.

You can check the uptime of the BittyTaxAPI server here.

You are granted license to use this API server for personal use only. If you would like a license to use it for commercial purposes, please get in touch.

If you have problems, either the API response, or connectivity, please raise an issue on GitHub or contact via Discord.

If you would like to support the BittyTax project and the hosting of this API server, please consider sponsoring us. You can also donate via PayPal or in bitcoin. All donations are gratefully received.

Disclosure: All donations go to Nano Nano Ltd, the creator and maintainer of this project. Nano Nano Ltd is not a charity, or non-profit organisation.

Get a list of all the supported currencies.

https://api.bitty.tax/v1/symbols

{
   "success":true,
   "symbols":{
      "AUD":"Australian Dollar",
      "BGN":"Bulgarian Lev",
      "BRL":"Brazilian Real",
      "CAD":"Canadian Dollar",
      [...]
   }
}

Get the latest foreign exchange rates.

https://api.bitty.tax/v1/latest
    ? base = USD
    & symbols = GBP, EUR, CAD

{
   "success":true,
   "base":"USD",
   "date":"2021-11-10",
   "rates":{
      "CAD":1.243381208,
      "EUR":0.865201592,
      "GBP":0.7401626579
   }
}

Get historical rates for any day since 1999, date format must be YYYY-MM-DD.

https://api.bitty.tax/v1/2021-07-31
    ? base = USD
    & symbols = GBP, EUR, CAD

{
   "success":true,
   "base":"USD",
   "date":"2021-07-30",
   "rates":{
      "CAD":1.243881928,
      "EUR":0.8409721638,
      "GBP":0.7160037003
   }
}

Get historical daily rates for a time period of your choice, with a maximum of 31 days.

https://api.bitty.tax/v1/history
    ? start_at = 2022-01-03
    & end_at = 2022-01-04
    & base = USD
    & symbols = GBP, EUR, CAD

{
   "success":true,
   "base":"USD",
   "rates":{
      "2022-01-03":{
         "CAD":1.269925143,
         "EUR":0.8806693087,
         "GBP":0.7409511229
      },
      "2022-01-04":{
         "CAD":1.275113042,
         "EUR":0.8866034223,
         "GBP":0.7413600496
      },
      "2022-01-05":{
         "CAD":1.272108844,
         "EUR":0.8834702712,
         "GBP":0.7381040728
      }
   }
}