README / README.md
AllRates's picture
Org card: 123 central banks + 6 tax authorities, 1,219 commercial bank boards, mid-market rates; drop jsDelivr
045db32 verified
|
Raw History Blame Contribute Delete
3.78 kB
---
title: README
emoji: 🏦
colorFrom: green
colorTo: blue
sdk: static
pinned: false
license: cc-by-nc-4.0
short_description: Official rates from 123 central banks + 1,219 bank boards
---
<p class="mb-2 text-lg">
πŸ‘‹ Hi! We publish the <strong>official exchange rates of 123 central banks and 6 tax authorities</strong> as open data, refreshed daily, with history back to 1914.
</p>
<p class="mb-4">
Every table comes from the institution's own publication, cross-checked against the other banks for unit and direction errors. What you load here is what the bank printed. The same pipeline powers the live API at <a href="https://allratestoday.com/?utm_source=huggingface&utm_medium=org_card" class="underline">allratestoday.com</a>.
</p>
<p class="mb-4">
The live API also carries <strong>real-time mid-market rates</strong> for 160+ currencies and the <strong>buy and sell boards of 1,219 commercial banks in 124 countries</strong> (SBI, HSBC, DBS, Emirates NBD, Bank of America and more), each with its spread and the official central bank rate: <a href="https://allratestoday.com/bank-exchange-rate-api/?utm_source=huggingface&utm_medium=org_card" class="underline">Bank Exchange Rate API</a> Β· <a href="https://www.npmjs.com/package/bank-exchange-rates" class="underline">bank-exchange-rates on npm</a>.
</p>
<div class="grid grid-cols-1 md:grid-cols-3 gap-4 mb-4">
<div class="rounded-lg border p-4">
<p class="font-semibold mb-1">πŸ“Š Load the dataset</p>
<p class="text-sm mb-2">One CSV per institution plus <code>latest/*.json</code>. Lags the live service by two days.</p>
<a href="https://huggingface.co/datasets/AllRatesToday/central-bank-exchange-rates" class="underline text-sm">central-bank-exchange-rates β†’</a>
</div>
<div class="rounded-lg border p-4">
<p class="font-semibold mb-1">πŸ€– For AI agents</p>
<p class="text-sm mb-2">Agents should fetch rates, not remember them. Hosted MCP endpoint, keyless, no sign-up.</p>
<a href="https://allratestoday.com/mcp/?utm_source=huggingface&utm_medium=org_card" class="underline text-sm">allratestoday.com/api/mcp β†’</a>
</div>
<div class="rounded-lg border p-4">
<p class="font-semibold mb-1">⚑ Live, today's table</p>
<p class="text-sm mb-2">Open REST and CDN JSON, four refreshes a day, plus date lookups with holiday fallback.</p>
<a href="https://allratestoday.com/central-bank-rates-api/?utm_source=huggingface&utm_medium=org_card" class="underline text-sm">Central Bank Rates API β†’</a>
</div>
</div>
```python
from datasets import load_dataset
ds = load_dataset("AllRatesToday/central-bank-exchange-rates", "rates")
```
```bash
curl "https://allratestoday.com/api/open/central-bank/ecb?source=EUR&target=USD"
```
<p class="mb-2">
πŸ™ <a href="https://github.com/AllRates-Today" class="underline">GitHub</a> (open data repo, SDKs for JS, Python, Go, PHP, Rust, one npm package per central bank, <a href="https://github.com/AllRates-Today/bank-exchange-rates" class="underline">bank-exchange-rates</a> for commercial banks) Β·
πŸ““ <a href="https://www.kaggle.com/datasets/allratestoday/central-bank-exchange-rates" class="underline">Kaggle mirror</a> Β·
βœ‰οΈ <a href="mailto:support@allratestoday.com" class="underline">support@allratestoday.com</a>
</p>
<p class="text-sm">
Datasets are <strong>CC BY-NC 4.0</strong>: free for research, education and personal projects with a credit linking to allratestoday.com. Commercial use is covered by the <a href="https://allratestoday.com/pricing/?utm_source=huggingface&utm_medium=org_card#official" class="underline">Official Rates plan</a>. The figures are public information published by each institution; verify against the source before relying on one for a legal or tax filing.
</p>