Spaces:
Running
Running
Org card (#1)
Browse files- Org card (2cbe45b45cad3da927c4e4e83b236a2a606d5463)
README.md
CHANGED
|
@@ -1,10 +1,45 @@
|
|
| 1 |
---
|
| 2 |
title: README
|
| 3 |
-
emoji:
|
| 4 |
-
colorFrom:
|
| 5 |
-
colorTo:
|
| 6 |
sdk: static
|
| 7 |
pinned: false
|
|
|
|
|
|
|
| 8 |
---
|
| 9 |
|
| 10 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
---
|
| 2 |
title: README
|
| 3 |
+
emoji: 🏦
|
| 4 |
+
colorFrom: yellow
|
| 5 |
+
colorTo: red
|
| 6 |
sdk: static
|
| 7 |
pinned: false
|
| 8 |
+
license: cc-by-nc-4.0
|
| 9 |
+
short_description: Official exchange rates from 121 central banks, daily
|
| 10 |
---
|
| 11 |
|
| 12 |
+
# AllRatesToday
|
| 13 |
+
|
| 14 |
+
**Official exchange rates from 121 central banks and 3 tax authorities, refreshed daily, as open data for research, backtesting and AI agents.**
|
| 15 |
+
|
| 16 |
+
We run the ingest pipeline behind [allratestoday.com](https://allratestoday.com/?utm_source=huggingface&utm_medium=org_card): it fetches each institution's own publication, cross-checks every table against the other banks for unit and direction errors, and quarantines anything more than ten percent off. What you load here is what the bank printed.
|
| 17 |
+
|
| 18 |
+
## Datasets
|
| 19 |
+
|
| 20 |
+
| Dataset | What it holds |
|
| 21 |
+
|---|---|
|
| 22 |
+
| [central-bank-exchange-rates](https://huggingface.co/datasets/AllRatesToday/central-bank-exchange-rates) | One CSV per institution, history back to 1914, `latest/*.json` snapshots, `load_dataset` ready. Lags the live service by 2 days. |
|
| 23 |
+
|
| 24 |
+
```python
|
| 25 |
+
from datasets import load_dataset
|
| 26 |
+
ds = load_dataset("AllRatesToday/central-bank-exchange-rates", "rates")
|
| 27 |
+
```
|
| 28 |
+
|
| 29 |
+
## For AI agents
|
| 30 |
+
|
| 31 |
+
Agents should fetch rates, not remember them. The same tables are available live and keyless:
|
| 32 |
+
|
| 33 |
+
- **Hosted MCP endpoint**: `https://allratestoday.com/api/mcp` ([docs](https://allratestoday.com/mcp/?utm_source=huggingface&utm_medium=org_card)), also `@allratestoday/mcp-server` and `@allratestoday/central-bank-mcp` on npm
|
| 34 |
+
- **Open REST**: `GET https://allratestoday.com/api/open/central-bank/ecb?source=EUR&target=USD`
|
| 35 |
+
- **CDN files**: `https://cdn.jsdelivr.net/gh/AllRates-Today/central-bank-exchange-rates@main/data/ecb/latest.json`
|
| 36 |
+
|
| 37 |
+
## Elsewhere
|
| 38 |
+
|
| 39 |
+
- GitHub: [AllRates-Today](https://github.com/AllRates-Today) (data repo, SDKs for JS, Python, Go, PHP, Rust, one npm package per central bank)
|
| 40 |
+
- Kaggle: [central-bank-exchange-rates](https://www.kaggle.com/datasets/allratestoday/central-bank-exchange-rates)
|
| 41 |
+
- Live API, publication calendars, date lookups with holiday fallback: [Central Bank Rates API](https://allratestoday.com/central-bank-rates-api/?utm_source=huggingface&utm_medium=org_card)
|
| 42 |
+
|
| 43 |
+
## Licence
|
| 44 |
+
|
| 45 |
+
Datasets are **CC BY-NC 4.0**: free for research, education and personal projects with a credit linking to allratestoday.com. Commercial use is covered by the [Official Rates plan](https://allratestoday.com/pricing/?utm_source=huggingface&utm_medium=org_card#official). The figures themselves are public information published by each institution; verify against the source before relying on one for a legal or tax filing.
|