@allratestoday/sbv-exchange-rate 1.3.3 → 1.3.5
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 +10 -7
- 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-
|
|
88
|
+
rate_date: '2026-10-06', // State Bank of Vietnam's own publication date
|
|
89
89
|
source: 'USD',
|
|
90
90
|
target: 'VND',
|
|
91
|
-
rate:
|
|
91
|
+
rate: 25645,
|
|
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-
|
|
116
|
+
rate_date: '2026-10-06',
|
|
117
117
|
rates: [
|
|
118
|
-
{ "base": "USD", "quote": "VND", "type": "reference", "value":
|
|
118
|
+
{ "base": "USD", "quote": "VND", "type": "reference", "value": 25645 },
|
|
119
|
+
{ "base": "USD", "quote": "VND", "type": "sell", "value": 26877 },
|
|
120
|
+
{ "base": "USD", "quote": "VND", "type": "buy", "value": 24413 },
|
|
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-
|
|
160
|
+
{ source: 'USD', target: 'VND', from: '2026-01-01', to: '2026-10-06' },
|
|
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-
|
|
173
|
+
to: '2026-10-06',
|
|
172
174
|
count: 152,
|
|
173
175
|
rates: [
|
|
174
176
|
// one entry per publication date
|
|
175
|
-
{ date: '2026-
|
|
177
|
+
{ date: '2026-10-06', rate: 25645, rate_type: 'reference', derived: false, method: 'published' },
|
|
176
178
|
// …
|
|
177
179
|
],
|
|
178
180
|
disclaimer: '…'
|
|
@@ -220,6 +222,7 @@ curl "https://allratestoday.com/api/v1/central-bank/sbv/latest?format=xml&api_ke
|
|
|
220
222
|
## 🤖 AI agents
|
|
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
|
|
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
|
|
223
226
|
- Machine-readable site guide: [llms.txt](https://allratestoday.com/llms.txt) · [for-ai-agents](https://allratestoday.com/for-ai-agents/)
|
|
224
227
|
|
|
225
228
|
## ⚖️ 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.
|
|
3
|
+
"version": "1.3.5",
|
|
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",
|