This repository provides an exchange rate API via GitHub Pages. All exchange rates are obtained from open sources (like central banks).
curl https://doviz.dev/v1/{currency_code}.json
The currency code must be lowercase. Supported currencies are listed below.
{
"USDTRY": 23.7169,
"TRYUSD": 0.04216402649587425,
"AUDTRY": 16.4238,
"TRYAUD": 0.060887248992316026,
"EURTRY": 25.9662,
"TRYEUR": 0.03851160354614845,
"GBPTRY": 30.4036,
"TRYGBP": 0.03289084187398861,
"CHFTRY": 26.6672,
"TRYCHF": 0.0374992500149997,
"JPYTRY": 0.168983,
"TRYJPY": 5.917755040447856,
"_meta": {
"base": "TRY",
"source": "tcmb.gov.tr",
"generated_at": "2023-06-18T16:24:03.281Z",
"updated_at": "2023-06-16T12:30:00.000Z"
}
}| Code | Source | API Link |
|---|---|---|
| USD | floatrates.com | https://doviz.dev/v1/usd.json |
| EUR | ecb.europa.eu | https://doviz.dev/v1/eur.json |
| TRY | tcmb.gov.tr | https://doviz.dev/v1/try.json |
| AUD | rba.gov.au | https://doviz.dev/v1/aud.json |
| DKK | nationalbanken.dk | https://doviz.dev/v1/dkk.json |
| CAD | bankofcanada.ca | https://doviz.dev/v1/cad.json |
| PLN | nbp.pl | https://doviz.dev/v1/pln.json |
-
Is it free to use?
Yes. This is an open source project and everyone can access it for free.
-
Is there any limit?
It depends on GitHub. Currently GitHub Pages bandwidth limit is 100GB monthly, GitHub says. So, please cache the response and use sparingly.
-
How often is it updated?
It depends on the sources. Exchange rates are usually updated daily for central banks. But we fetch data and generate JSON files every 10 minutes.
-
Why would we need this?
Doviz.dev converts data with varying structures from different sources into a standard format.
-
What "doviz" means?
"Döviz" (dö·viz) is a Turkish word means "foreign currency".
-
Which sources using?
We use several open sources to obtain exchange rates. Some sources we use are listed here.
Please feel free to create pull request or create an issue.
Apache License 2.0 - Ekin Karadeniz ©2024