@allratestoday/sbv-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 +9 -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 State Bank of Vietnam 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 State Bank of Vietnam 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', 'VND', { apiKey: 'art_live_...' });
|
|
|
85
85
|
{
|
|
86
86
|
bank: 'sbv',
|
|
87
87
|
name: 'State Bank of Vietnam',
|
|
88
|
-
rate_date: '2026-09-
|
|
88
|
+
rate_date: '2026-09-26', // State Bank of Vietnam's own publication date
|
|
89
89
|
source: 'USD',
|
|
90
90
|
target: 'VND',
|
|
91
|
-
rate:
|
|
91
|
+
rate: 25641,
|
|
92
92
|
rate_type: 'reference',
|
|
93
93
|
derived: false,
|
|
94
94
|
method: 'published',
|
|
@@ -113,11 +113,9 @@ 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-
|
|
116
|
+
rate_date: '2026-09-26',
|
|
117
117
|
rates: [
|
|
118
|
-
{ "base": "USD", "quote": "VND", "type": "reference", "value":
|
|
119
|
-
{ "base": "USD", "quote": "VND", "type": "sell", "value": 26823 },
|
|
120
|
-
{ "base": "USD", "quote": "VND", "type": "buy", "value": 24365 },
|
|
118
|
+
{ "base": "USD", "quote": "VND", "type": "reference", "value": 25641 },
|
|
121
119
|
// โฆ the rest of the published table (28 currencies vs VND)
|
|
122
120
|
],
|
|
123
121
|
disclaimer: 'โฆ'
|
|
@@ -157,7 +155,7 @@ Paid plans. One resolved rate per publication date โ ready for charting, reval
|
|
|
157
155
|
import { getHistory } from '@allratestoday/sbv-exchange-rate';
|
|
158
156
|
|
|
159
157
|
const series = await getHistory(
|
|
160
|
-
{ source: 'USD', target: 'VND', from: '2026-01-01', to: '2026-09-
|
|
158
|
+
{ source: 'USD', target: 'VND', from: '2026-01-01', to: '2026-09-26' },
|
|
161
159
|
{ apiKey: 'art_live_...' }
|
|
162
160
|
);
|
|
163
161
|
```
|
|
@@ -170,11 +168,11 @@ const series = await getHistory(
|
|
|
170
168
|
source: 'USD',
|
|
171
169
|
target: 'VND',
|
|
172
170
|
from: '2026-01-01',
|
|
173
|
-
to: '2026-09-
|
|
171
|
+
to: '2026-09-26',
|
|
174
172
|
count: 152,
|
|
175
173
|
rates: [
|
|
176
174
|
// one entry per publication date
|
|
177
|
-
{ date: '2026-09-
|
|
175
|
+
{ date: '2026-09-26', rate: 25641, rate_type: 'reference', derived: false, method: 'published' },
|
|
178
176
|
// โฆ
|
|
179
177
|
],
|
|
180
178
|
disclaimer: 'โฆ'
|
|
@@ -222,6 +220,7 @@ curl "https://allratestoday.com/api/v1/central-bank/sbv/latest?format=xml&api_ke
|
|
|
222
220
|
## ๐ค AI agents
|
|
223
221
|
|
|
224
222
|
- 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
|
+
- 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
|
|
225
224
|
- Machine-readable site guide: [llms.txt](https://allratestoday.com/llms.txt) ยท [for-ai-agents](https://allratestoday.com/for-ai-agents/)
|
|
226
225
|
|
|
227
226
|
## โ๏ธ 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.4",
|
|
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",
|