Spaces:
Running
Running
|
Download README.md from AllRatesToday/README: direct link, hf CLI and curl.
- Browser
- Download file 3.78 kB
-
https://huggingface.co/spaces/AllRatesToday/README/resolve/main/README.md
- Command line
-
hf download hf://spaces/AllRatesToday/README/README.md
-
curl -L -o README.md https://huggingface.co/spaces/AllRatesToday/README/resolve/main/README.md
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> | |