@allratestoday/sbv-exchange-rate 1.3.1 โ 1.3.3
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 +8 -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: 'โฆ'
|
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.3",
|
|
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",
|