AllRates commited on
Commit
5471e45
Β·
verified Β·
1 Parent(s): bdcdce4

Org card v2: banner + HTML layout

Browse files
Files changed (2) hide show
  1. README.md +39 -29
  2. banner.png +0 -0
README.md CHANGED
@@ -1,45 +1,55 @@
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.
 
 
 
 
 
 
 
 
1
  ---
2
  title: README
3
  emoji: 🏦
4
+ colorFrom: green
5
+ colorTo: blue
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
+ <img src="https://huggingface.co/spaces/AllRatesToday/README/resolve/main/banner.png" alt="AllRatesToday: official exchange rates from 121 central banks and 3 tax authorities, as open data" class="w-full rounded-lg mb-4" />
13
+
14
+ <p class="mb-2 text-lg">
15
+ πŸ‘‹ Hi! We publish the <strong>official exchange rates of 121 central banks and 3 tax authorities</strong> as open data, refreshed daily, with history back to 1914.
16
+ </p>
17
+ <p class="mb-4">
18
+ 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>.
19
+ </p>
20
+
21
+ <div class="grid grid-cols-1 md:grid-cols-3 gap-4 mb-4">
22
+ <div class="rounded-lg border p-4">
23
+ <p class="font-semibold mb-1">πŸ“Š Load the dataset</p>
24
+ <p class="text-sm mb-2">One CSV per institution plus <code>latest/*.json</code>. Lags the live service by two days.</p>
25
+ <a href="https://huggingface.co/datasets/AllRatesToday/central-bank-exchange-rates" class="underline text-sm">central-bank-exchange-rates β†’</a>
26
+ </div>
27
+ <div class="rounded-lg border p-4">
28
+ <p class="font-semibold mb-1">πŸ€– For AI agents</p>
29
+ <p class="text-sm mb-2">Agents should fetch rates, not remember them. Hosted MCP endpoint, keyless, no sign-up.</p>
30
+ <a href="https://allratestoday.com/mcp/?utm_source=huggingface&utm_medium=org_card" class="underline text-sm">allratestoday.com/api/mcp β†’</a>
31
+ </div>
32
+ <div class="rounded-lg border p-4">
33
+ <p class="font-semibold mb-1">⚑ Live, today's table</p>
34
+ <p class="text-sm mb-2">Open REST and CDN JSON, four refreshes a day, plus date lookups with holiday fallback.</p>
35
+ <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>
36
+ </div>
37
+ </div>
38
 
39
  ```python
40
  from datasets import load_dataset
41
  ds = load_dataset("AllRatesToday/central-bank-exchange-rates", "rates")
42
  ```
43
 
44
+ ```bash
45
+ curl "https://allratestoday.com/api/open/central-bank/ecb?source=EUR&target=USD"
46
+ ```
 
 
 
 
 
 
 
 
 
 
 
 
47
 
48
+ <p class="mb-2">
49
+ πŸ™ <a href="https://github.com/AllRates-Today" class="underline">GitHub</a> (data repo on jsDelivr, SDKs for JS, Python, Go, PHP, Rust, one npm package per bank) Β·
50
+ πŸ““ <a href="https://www.kaggle.com/datasets/allratestoday/central-bank-exchange-rates" class="underline">Kaggle mirror</a> Β·
51
+ βœ‰οΈ <a href="mailto:support@allratestoday.com" class="underline">support@allratestoday.com</a>
52
+ </p>
53
+ <p class="text-sm">
54
+ 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.
55
+ </p>
banner.png ADDED