@allratestoday/sbv-exchange-rate 1.2.7 → 1.3.0
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 +17 -9
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -70,10 +70,10 @@ const pair = await getRate('USD', 'VND', { apiKey: 'art_live_...' });
|
|
|
70
70
|
{
|
|
71
71
|
bank: 'sbv',
|
|
72
72
|
name: 'State Bank of Vietnam',
|
|
73
|
-
rate_date: '2026-
|
|
73
|
+
rate_date: '2026-09-09', // State Bank of Vietnam's own publication date
|
|
74
74
|
source: 'USD',
|
|
75
75
|
target: 'VND',
|
|
76
|
-
rate:
|
|
76
|
+
rate: 25594,
|
|
77
77
|
rate_type: 'reference',
|
|
78
78
|
derived: false,
|
|
79
79
|
method: 'published',
|
|
@@ -98,11 +98,11 @@ console.log(table.rate_date, table.rates.length);
|
|
|
98
98
|
{
|
|
99
99
|
bank: 'sbv',
|
|
100
100
|
name: 'State Bank of Vietnam',
|
|
101
|
-
rate_date: '2026-
|
|
101
|
+
rate_date: '2026-09-09',
|
|
102
102
|
rates: [
|
|
103
|
-
{ "base": "USD", "quote": "VND", "type": "reference", "value":
|
|
104
|
-
{ "base": "USD", "quote": "VND", "type": "sell", "value":
|
|
105
|
-
{ "base": "USD", "quote": "VND", "type": "buy", "value":
|
|
103
|
+
{ "base": "USD", "quote": "VND", "type": "reference", "value": 25594 },
|
|
104
|
+
{ "base": "USD", "quote": "VND", "type": "sell", "value": 26823 },
|
|
105
|
+
{ "base": "USD", "quote": "VND", "type": "buy", "value": 24365 },
|
|
106
106
|
// … the rest of the published table (28 currencies vs VND)
|
|
107
107
|
],
|
|
108
108
|
disclaimer: '…'
|
|
@@ -142,7 +142,7 @@ Paid plans. One resolved rate per publication date — ready for charting, reval
|
|
|
142
142
|
import { getHistory } from '@allratestoday/sbv-exchange-rate';
|
|
143
143
|
|
|
144
144
|
const series = await getHistory(
|
|
145
|
-
{ source: 'USD', target: 'VND', from: '2026-01-01', to: '2026-
|
|
145
|
+
{ source: 'USD', target: 'VND', from: '2026-01-01', to: '2026-09-09' },
|
|
146
146
|
{ apiKey: 'art_live_...' }
|
|
147
147
|
);
|
|
148
148
|
```
|
|
@@ -155,11 +155,11 @@ const series = await getHistory(
|
|
|
155
155
|
source: 'USD',
|
|
156
156
|
target: 'VND',
|
|
157
157
|
from: '2026-01-01',
|
|
158
|
-
to: '2026-
|
|
158
|
+
to: '2026-09-09',
|
|
159
159
|
count: 152,
|
|
160
160
|
rates: [
|
|
161
161
|
// one entry per publication date
|
|
162
|
-
{ date: '2026-
|
|
162
|
+
{ date: '2026-09-09', rate: 25594, rate_type: 'reference', derived: false, method: 'published' },
|
|
163
163
|
// …
|
|
164
164
|
],
|
|
165
165
|
disclaimer: '…'
|
|
@@ -238,6 +238,14 @@ getRate('USD', 'VND', { apiKey: 'art_live_...' }).then((pair) => console.log(pai
|
|
|
238
238
|
| `getRatesForDate(date, { apiKey, source?, target? })` | Paid | The official table (or one pair) for a YYYY-MM-DD date |
|
|
239
239
|
| `getHistory({ symbol \| source+target, from?, to? }, { apiKey })` | Paid | Daily series since 2009 |
|
|
240
240
|
|
|
241
|
+
## 📥 Bulk data (no key)
|
|
242
|
+
|
|
243
|
+
Need the whole archive rather than an API call? The same published tables are mirrored daily as open data:
|
|
244
|
+
|
|
245
|
+
- Hugging Face: [AllRates/central-bank-exchange-rates](https://huggingface.co/datasets/AllRates/central-bank-exchange-rates) — one CSV per institution (`rates/sbv.csv`)
|
|
246
|
+
- Kaggle: [allratestoday/central-bank-exchange-rates](https://www.kaggle.com/datasets/allratestoday/central-bank-exchange-rates)
|
|
247
|
+
- CDN JSON: `https://cdn.jsdelivr.net/gh/AllRates-Today/central-bank-exchange-rates@main/data/sbv/latest.json`
|
|
248
|
+
|
|
241
249
|
## 🔗 Links
|
|
242
250
|
|
|
243
251
|
- [State Bank of Vietnam rates page](https://allratestoday.com/central-bank-rates-api/sbv/) — live table, publication cadence, FAQ
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@allratestoday/sbv-exchange-rate",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.3.0",
|
|
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",
|