@allratestoday/sbv-exchange-rate 1.3.4 → 1.3.6

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 +10 -7
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -85,10 +85,10 @@ const pair = await getRate('USD', 'VND', { apiKey: 'art_live_...' });
85
85
  {
86
86
  bank: 'sbv',
87
87
  name: 'State Bank of Vietnam',
88
- rate_date: '2026-09-26', // State Bank of Vietnam's own publication date
88
+ rate_date: '2026-10-08', // State Bank of Vietnam's own publication date
89
89
  source: 'USD',
90
90
  target: 'VND',
91
- rate: 25641,
91
+ rate: 25634,
92
92
  rate_type: 'reference',
93
93
  derived: false,
94
94
  method: 'published',
@@ -113,9 +113,11 @@ console.log(table.rate_date, table.rates.length);
113
113
  {
114
114
  bank: 'sbv',
115
115
  name: 'State Bank of Vietnam',
116
- rate_date: '2026-09-26',
116
+ rate_date: '2026-10-08',
117
117
  rates: [
118
- { "base": "USD", "quote": "VND", "type": "reference", "value": 25641 },
118
+ { "base": "USD", "quote": "VND", "type": "reference", "value": 25634 },
119
+ { "base": "USD", "quote": "VND", "type": "sell", "value": 26869 },
120
+ { "base": "USD", "quote": "VND", "type": "buy", "value": 24407 },
119
121
  // … the rest of the published table (28 currencies vs VND)
120
122
  ],
121
123
  disclaimer: '…'
@@ -155,7 +157,7 @@ Paid plans. One resolved rate per publication date — ready for charting, reval
155
157
  import { getHistory } from '@allratestoday/sbv-exchange-rate';
156
158
 
157
159
  const series = await getHistory(
158
- { source: 'USD', target: 'VND', from: '2026-01-01', to: '2026-09-26' },
160
+ { source: 'USD', target: 'VND', from: '2026-01-01', to: '2026-10-08' },
159
161
  { apiKey: 'art_live_...' }
160
162
  );
161
163
  ```
@@ -168,11 +170,11 @@ const series = await getHistory(
168
170
  source: 'USD',
169
171
  target: 'VND',
170
172
  from: '2026-01-01',
171
- to: '2026-09-26',
173
+ to: '2026-10-08',
172
174
  count: 152,
173
175
  rates: [
174
176
  // one entry per publication date
175
- { date: '2026-09-26', rate: 25641, rate_type: 'reference', derived: false, method: 'published' },
177
+ { date: '2026-10-08', rate: 25634, rate_type: 'reference', derived: false, method: 'published' },
176
178
  // …
177
179
  ],
178
180
  disclaimer: '…'
@@ -221,6 +223,7 @@ curl "https://allratestoday.com/api/v1/central-bank/sbv/latest?format=xml&api_ke
221
223
 
222
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
223
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('sbv')` 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
226
+ - 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 sbv ...` command
224
227
  - Machine-readable site guide: [llms.txt](https://allratestoday.com/llms.txt) · [for-ai-agents](https://allratestoday.com/for-ai-agents/)
225
228
 
226
229
  ## ⚖️ Published vs derived rates
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@allratestoday/sbv-exchange-rate",
3
- "version": "1.3.4",
3
+ "version": "1.3.6",
4
4
  "description": "Official State Bank of Vietnam (Vietnam) daily exchange rates — 28 currencies vs VND, history since 2009. Zero-dependency Node.js/TypeScript client.",
5
5
  "keywords": [
6
6
  "sbv",