@allratestoday/boz-exchange-rate 1.3.7 → 1.3.13

package/README.md

@@ -37,19 +37,21 @@ The open endpoint serves the *latest* table only and asks for a visible attribut
 
 ## 📈 Latest published table
 
-Today's full Bank of Zambia table, straight from the central bank's latest publication. On GitHub it is refreshed by [a daily Action](.github/workflows/daily-table.yml) that reads the keyless endpoint above and commits only when the central bank publishes a new table; the copy on npm is as of the package's publish date.
+[![Latest Bank of Zambia table](https://allratestoday.com/api/open/central-bank/boz/table.svg)](https://allratestoday.com/central-bank-rates-api/boz/)
+
+The image is rendered live from the keyless endpoint above, so it follows the central bank's publications on npm and on GitHub alike without a new release. The text copy below is there for search and copy-paste: on GitHub [a daily Action](.github/workflows/daily-table.yml) refreshes it whenever the central bank publishes a new table; on npm it is as of the package's publish date.
 
 <!-- daily-table:start -->
-Published **2026-10-09** by Bank of Zambia — 6 rates. Updated 2026-10-09.
+Published **2026-10-14** by Bank of Zambia — 6 rates. Updated 2026-10-14.
 
 | Base | Quote | Type | Rate |
 | --- | --- | --- | ---: |
-| CNY | ZMW | buy | 2.9691 |
-| CNY | ZMW | middle | 2.9728 |
-| CNY | ZMW | sell | 2.9766 |
-| USD | ZMW | buy | 19.882 |
-| USD | ZMW | middle | 19.907 |
-| USD | ZMW | sell | 19.932 |
+| CNY | ZMW | buy | 2.9736 |
+| CNY | ZMW | middle | 2.9774 |
+| CNY | ZMW | sell | 2.9812 |
+| USD | ZMW | buy | 19.9018 |
+| USD | ZMW | middle | 19.9268 |
+| USD | ZMW | sell | 19.9518 |
 
 Source: [Official rates published by BOZ, served by AllRatesToday](https://allratestoday.com/central-bank-rates-api/boz/). Rates are as printed by the central bank; AllRatesToday is not affiliated with it.
 <!-- daily-table:end -->
@@ -106,10 +108,10 @@ const pair = await getRate('USD', 'ZMW', { apiKey: 'art_live_...' });
 {
   bank: 'boz',
   name: 'Bank of Zambia',
-  rate_date: '2026-10-08',   // Bank of Zambia's own publication date
+  rate_date: '2026-10-14',   // Bank of Zambia's own publication date
   source: 'USD',
   target: 'ZMW',
-  rate: 19.915,
+  rate: 19.9268,
   rate_type: 'middle',
   derived: false,
   method: 'published',
@@ -134,11 +136,11 @@ console.log(table.rate_date, table.rates.length);
 {
   bank: 'boz',
   name: 'Bank of Zambia',
-  rate_date: '2026-10-08',
+  rate_date: '2026-10-14',
   rates: [
-    { "base": "USD", "quote": "ZMW", "type": "middle", "value": 19.915 },
-    { "base": "USD", "quote": "ZMW", "type": "sell", "value": 19.94 },
-    { "base": "USD", "quote": "ZMW", "type": "buy", "value": 19.89 },
+    { "base": "USD", "quote": "ZMW", "type": "middle", "value": 19.9268 },
+    { "base": "USD", "quote": "ZMW", "type": "sell", "value": 19.9518 },
+    { "base": "USD", "quote": "ZMW", "type": "buy", "value": 19.9018 },
     // … the rest of the published table (2 currencies vs ZMW)
   ],
   disclaimer: '…'
@@ -178,7 +180,7 @@ Paid plans. One resolved rate per publication date — ready for charting, reval
 import { getHistory } from '@allratestoday/boz-exchange-rate';
 
 const series = await getHistory(
-  { source: 'USD', target: 'ZMW', from: '2026-01-01', to: '2026-10-08' },
+  { source: 'USD', target: 'ZMW', from: '2026-01-01', to: '2026-10-14' },
   { apiKey: 'art_live_...' }
 );
 ```
@@ -191,11 +193,11 @@ const series = await getHistory(
   source: 'USD',
   target: 'ZMW',
   from: '2026-01-01',
-  to: '2026-10-08',
+  to: '2026-10-14',
   count: 152,
   rates: [
     // one entry per publication date
-    { date: '2026-10-08', rate: 19.915, rate_type: 'middle', derived: false, method: 'published' },
+    { date: '2026-10-14', rate: 19.9268, rate_type: 'middle', derived: false, method: 'published' },
     // …
   ],
   disclaimer: '…'
@@ -245,6 +247,7 @@ curl "https://allratestoday.com/api/v1/central-bank/boz/latest?format=xml&api_ke
 - MCP server: `npx -y @allratestoday/central-bank-mcp` (stdio) or the hosted endpoint `https://allratestoday.com/api/mcp` — tools for official rates, history, cross-bank comparison and publication calendars
 - Already using the general SDK or MCP server? Since 2026-10-01 [`@allratestoday/sdk`](https://www.npmjs.com/package/@allratestoday/sdk) 1.4+ has `officialRates('boz')` and [`@allratestoday/mcp-server`](https://www.npmjs.com/package/@allratestoday/mcp-server) 0.6+ has a `get_official_rates` tool — both return this source's latest table with no key, so you can add it without a second dependency
 - Claude Code plugin (no key): `/plugin marketplace add AllRates-Today/claude-code-plugin` then `/plugin install allratestoday@allratestoday` — bundles both MCP servers plus an `/official-rate boz ...` command
+- Need dated tables or history for an evaluation? Agents can self-issue a trial key with no signup: `POST https://allratestoday.com/api/agent/keys` (send `Content-Type: application/json`) returns a 100-call key valid 7 days; the MCP servers expose it as `request_trial_key`
 - Machine-readable site guide: [llms.txt](https://allratestoday.com/llms.txt) · [for-ai-agents](https://allratestoday.com/for-ai-agents/)
 
 ## ⚖️ Published vs derived rates
@@ -313,9 +316,9 @@ getRate('USD', 'ZMW', { apiKey: 'art_live_...' }).then((pair) => console.log(pai
 
 Need the whole archive rather than an API call? The same published tables are mirrored daily as open data:
 
-- Hugging Face: [AllRates/central-bank-exchange-rates](https://huggingface.co/datasets/AllRates/central-bank-exchange-rates) — one CSV per institution (`rates/boz.csv`)
+- Hugging Face: [AllRatesToday/central-bank-exchange-rates](https://huggingface.co/datasets/AllRatesToday/central-bank-exchange-rates) — one CSV per institution (`rates/boz.csv`)
 - Kaggle: [allratestoday/central-bank-exchange-rates](https://www.kaggle.com/datasets/allratestoday/central-bank-exchange-rates)
-- CDN JSON: `https://cdn.jsdelivr.net/gh/AllRates-Today/central-bank-exchange-rates@main/data/boz/latest.json`
+- Raw JSON on GitHub: `https://raw.githubusercontent.com/AllRates-Today/central-bank-exchange-rates/main/data/boz/latest.json`
 
 ## 🔗 Links
 

package/package.json

@@ -1,21 +1,29 @@
 {
   "name": "@allratestoday/boz-exchange-rate",
-  "version": "1.3.7",
+  "version": "1.3.13",
   "description": "Official Bank of Zambia (Zambia) daily exchange rates — 2 currencies vs ZMW, history since 2026. Zero-dependency Node.js/TypeScript client.",
   "keywords": [
     "boz",
+    "bank-of-zambia",
     "bank",
-    "of",
     "zambia",
     "exchange-rate",
     "exchange-rates",
+    "exchangerate",
+    "exchange rate",
+    "zmw-exchange-rate",
     "currency",
     "forex",
     "fx",
     "zmw",
+    "currency-api",
+    "currency-exchange-rates",
+    "forex-api",
+    "currency-conversion",
+    "currency-exchange",
+    "currency-rates",
     "central-bank",
     "official-rates",
-    "zambia",
     "api",
     "typescript"
   ],