@allratestoday/boz-exchange-rate 1.3.1 โ 1.3.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +11 -10
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -16,7 +16,7 @@
|
|
|
16
16
|
- ๐ท **Type-safe** โ full TypeScript definitions shipped with the package
|
|
17
17
|
- ๐งพ **Compliance-grade metadata** โ `rate_type`, publication date, and source disclaimer on every response
|
|
18
18
|
|
|
19
|
-
> **Official rate, not mid-market:** every value here is a number Bank of Zambia itself published, fixed once printed and carrying the central bank's own `rate_date` โ what filings and audits require. Need the live
|
|
19
|
+
> **Official rate, not mid-market:** every value here is a number Bank of Zambia itself published, fixed once printed and carrying the central bank's own `rate_date` โ what filings and audits require. Need the live mid-market rate for pricing or display instead? Use the [mid-market API](https://allratestoday.com/docs/) or [`@allratestoday/sdk`](https://www.npmjs.com/package/@allratestoday/sdk). The two can diverge by several percent.
|
|
20
20
|
|
|
21
21
|
## โก Try it without a key
|
|
22
22
|
|
|
@@ -85,10 +85,10 @@ const pair = await getRate('USD', 'ZMW', { apiKey: 'art_live_...' });
|
|
|
85
85
|
{
|
|
86
86
|
bank: 'boz',
|
|
87
87
|
name: 'Bank of Zambia',
|
|
88
|
-
rate_date: '2026-09-
|
|
88
|
+
rate_date: '2026-09-25', // Bank of Zambia's own publication date
|
|
89
89
|
source: 'USD',
|
|
90
90
|
target: 'ZMW',
|
|
91
|
-
rate: 19.
|
|
91
|
+
rate: 19.5,
|
|
92
92
|
rate_type: 'middle',
|
|
93
93
|
derived: false,
|
|
94
94
|
method: 'published',
|
|
@@ -113,11 +113,11 @@ console.log(table.rate_date, table.rates.length);
|
|
|
113
113
|
{
|
|
114
114
|
bank: 'boz',
|
|
115
115
|
name: 'Bank of Zambia',
|
|
116
|
-
rate_date: '2026-09-
|
|
116
|
+
rate_date: '2026-09-25',
|
|
117
117
|
rates: [
|
|
118
|
-
{ "base": "USD", "quote": "ZMW", "type": "middle", "value": 19.
|
|
119
|
-
{ "base": "USD", "quote": "ZMW", "type": "sell", "value": 19.
|
|
120
|
-
{ "base": "USD", "quote": "ZMW", "type": "buy", "value": 19.
|
|
118
|
+
{ "base": "USD", "quote": "ZMW", "type": "middle", "value": 19.5 },
|
|
119
|
+
{ "base": "USD", "quote": "ZMW", "type": "sell", "value": 19.525 },
|
|
120
|
+
{ "base": "USD", "quote": "ZMW", "type": "buy", "value": 19.475 },
|
|
121
121
|
// โฆ the rest of the published table (2 currencies vs ZMW)
|
|
122
122
|
],
|
|
123
123
|
disclaimer: 'โฆ'
|
|
@@ -157,7 +157,7 @@ Paid plans. One resolved rate per publication date โ ready for charting, reval
|
|
|
157
157
|
import { getHistory } from '@allratestoday/boz-exchange-rate';
|
|
158
158
|
|
|
159
159
|
const series = await getHistory(
|
|
160
|
-
{ source: 'USD', target: 'ZMW', from: '2026-01-01', to: '2026-09-
|
|
160
|
+
{ source: 'USD', target: 'ZMW', from: '2026-01-01', to: '2026-09-25' },
|
|
161
161
|
{ apiKey: 'art_live_...' }
|
|
162
162
|
);
|
|
163
163
|
```
|
|
@@ -170,11 +170,11 @@ const series = await getHistory(
|
|
|
170
170
|
source: 'USD',
|
|
171
171
|
target: 'ZMW',
|
|
172
172
|
from: '2026-01-01',
|
|
173
|
-
to: '2026-09-
|
|
173
|
+
to: '2026-09-25',
|
|
174
174
|
count: 152,
|
|
175
175
|
rates: [
|
|
176
176
|
// one entry per publication date
|
|
177
|
-
{ date: '2026-09-
|
|
177
|
+
{ date: '2026-09-25', rate: 19.5, rate_type: 'middle', derived: false, method: 'published' },
|
|
178
178
|
// โฆ
|
|
179
179
|
],
|
|
180
180
|
disclaimer: 'โฆ'
|
|
@@ -222,6 +222,7 @@ curl "https://allratestoday.com/api/v1/central-bank/boz/latest?format=xml&api_ke
|
|
|
222
222
|
## ๐ค AI agents
|
|
223
223
|
|
|
224
224
|
- 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
|
|
225
|
+
- 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
|
|
225
226
|
- Machine-readable site guide: [llms.txt](https://allratestoday.com/llms.txt) ยท [for-ai-agents](https://allratestoday.com/for-ai-agents/)
|
|
226
227
|
|
|
227
228
|
## โ๏ธ Published vs derived rates
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@allratestoday/boz-exchange-rate",
|
|
3
|
-
"version": "1.3.
|
|
3
|
+
"version": "1.3.4",
|
|
4
4
|
"description": "Official Bank of Zambia (Zambia) daily exchange rates โ 2 currencies vs ZMW, history since 2026. Zero-dependency Node.js/TypeScript client.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"boz",
|