@allratestoday/brh-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.
Files changed (2) hide show
  1. package/README.md +11 -10
  2. 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 Banque de la République d'Haïti itself published, fixed once printed and carrying the central bank's own `rate_date` — what filings and audits require. Need the live interbank midpoint 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.
19
+ > **Official rate, not mid-market:** every value here is a number Banque de la République d'Haïti 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', 'HTG', { apiKey: 'art_live_...' });
85
85
  {
86
86
  bank: 'brh',
87
87
  name: 'Banque de la République d\'Haïti',
88
- rate_date: '2026-09-09', // Banque de la République d'Haïti's own publication date
88
+ rate_date: '2026-09-25', // Banque de la République d'Haïti's own publication date
89
89
  source: 'USD',
90
90
  target: 'HTG',
91
- rate: 130.4876,
91
+ rate: 130.6863,
92
92
  rate_type: 'reference',
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: 'brh',
115
115
  name: 'Banque de la République d\'Haïti',
116
- rate_date: '2026-09-09',
116
+ rate_date: '2026-09-25',
117
117
  rates: [
118
- { "base": "USD", "quote": "HTG", "type": "reference", "value": 130.4876 },
119
- { "base": "USD", "quote": "HTG", "type": "sell", "value": 131.1807 },
120
- { "base": "USD", "quote": "HTG", "type": "buy", "value": 130.2794 },
118
+ { "base": "USD", "quote": "HTG", "type": "reference", "value": 130.6863 },
119
+ { "base": "USD", "quote": "HTG", "type": "sell", "value": 131.2042 },
120
+ { "base": "USD", "quote": "HTG", "type": "buy", "value": 130.5439 },
121
121
  // … the rest of the published table (1 currency vs HTG)
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/brh-exchange-rate';
158
158
 
159
159
  const series = await getHistory(
160
- { source: 'USD', target: 'HTG', from: '2026-01-01', to: '2026-09-09' },
160
+ { source: 'USD', target: 'HTG', 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: 'HTG',
172
172
  from: '2026-01-01',
173
- to: '2026-09-09',
173
+ to: '2026-09-25',
174
174
  count: 152,
175
175
  rates: [
176
176
  // one entry per publication date
177
- { date: '2026-09-09', rate: 130.4876, rate_type: 'reference', derived: false, method: 'published' },
177
+ { date: '2026-09-25', rate: 130.6863, rate_type: 'reference', derived: false, method: 'published' },
178
178
  // …
179
179
  ],
180
180
  disclaimer: '…'
@@ -222,6 +222,7 @@ curl "https://allratestoday.com/api/v1/central-bank/brh/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('brh')` 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/brh-exchange-rate",
3
- "version": "1.3.1",
3
+ "version": "1.3.4",
4
4
  "description": "Official Banque de la République d'Haïti (Haiti) daily exchange rates — 1 currency vs HTG, current table, archive from 2026. Zero-dependency Node.js/TypeScript client.",
5
5
  "keywords": [
6
6
  "brh",