AllRates commited on
Commit
2cbe45b
·
verified ·
1 Parent(s): 3113f94
Files changed (1) hide show
  1. README.md +39 -4
README.md CHANGED
@@ -1,10 +1,45 @@
1
  ---
2
  title: README
3
- emoji: 🚀
4
- colorFrom: green
5
- colorTo: green
6
  sdk: static
7
  pinned: false
 
 
8
  ---
9
 
10
- Edit this `README.md` markdown file to author your organization card.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
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.