@allratestoday/sbv-exchange-rate 1.3.19 → 1.3.24

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 +42 -56
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -24,75 +24,60 @@
24
24
 
25
25
  Get a free API key at [allratestoday.com/register](https://allratestoday.com/register) — no credit card required. Latest rates are on every plan, including free.
26
26
 
27
- ## ⚡ Try it without a key
28
-
29
- The latest State Bank of Vietnam table is also served keyless, CORS-open and edge-cached, for evaluation, embeds and AI agents:
30
-
31
- ```bash
32
- curl "https://allratestoday.com/api/open/central-bank/sbv?source=USD&target=VND"
33
- ```
34
-
35
- ```js
36
- const r = await fetch('https://allratestoday.com/api/open/central-bank/sbv').then((x) => x.json());
37
- console.log(r.rate_date, r.rates.length); // the central bank's latest published table, no key
38
- ```
39
-
40
- The open endpoint serves the *latest* table only (JSON by default; add `?format=csv`, `xml` or `xlsx` for a file) and is free to use with a visible, followable link where the rates are shown: `<a href="https://allratestoday.com">Exchange rates by AllRatesToday</a>` (terms: <https://allratestoday.com/terms/#attribution>). The client below uses the keyed API, which adds point-in-time tables and history; with a key the link is appreciated, not required.
41
-
42
27
  ## 📈 Latest published table
43
28
 
44
29
  [![Latest State Bank of Vietnam table](https://allratestoday.com/api/open/central-bank/sbv/table.svg)](https://allratestoday.com/central-bank-rates-api/sbv/)
45
30
 
46
- The image is rendered live from the keyless endpoint above, so it follows the central bank's publications on npm and on GitHub alike without a new release. The same table as text is folded below for search and copy-paste: on GitHub [a daily Action](.github/workflows/daily-table.yml) refreshes it whenever the central bank publishes a new table; on npm it is as of the package's publish date.
31
+ The image is rendered live from the keyless endpoint, so it follows the central bank's publications on npm and on GitHub alike without a new release. The same table as text is folded below for search and copy-paste: on GitHub [a daily Action](.github/workflows/daily-table.yml) refreshes it whenever the central bank publishes a new table; on npm it is as of the package's publish date.
47
32
 
48
33
  <!-- daily-table:start -->
49
34
  <details>
50
- <summary>Table as text: published 2026-10-27 by State Bank of Vietnam — 42 rates. Updated 2026-10-27.</summary>
35
+ <summary>Table as text: published 2026-10-30 by State Bank of Vietnam — 42 rates. Updated 2026-10-30.</summary>
51
36
 
52
37
  | Base | Quote | Type | Rate |
53
38
  | --- | --- | --- | ---: |
54
- | AED | VND | reference | 6979.8 |
55
- | AUD | VND | buy | 17087 |
56
- | AUD | VND | reference | 17987.38 |
57
- | AUD | VND | sell | 18886 |
58
- | BRL | VND | reference | 5102.21 |
59
- | CAD | VND | buy | 17373 |
60
- | CAD | VND | reference | 18231.86 |
61
- | CAD | VND | sell | 19201 |
62
- | CHF | VND | buy | 29417 |
63
- | CHF | VND | reference | 31048.93 |
64
- | CHF | VND | sell | 32513 |
65
- | CNY | VND | reference | 3838.17 |
66
- | DKK | VND | reference | 3850.45 |
67
- | EUR | VND | buy | 27207 |
68
- | EUR | VND | reference | 28776.73 |
69
- | EUR | VND | sell | 30070 |
70
- | GBP | VND | buy | 32493 |
71
- | GBP | VND | reference | 34272.66 |
72
- | GBP | VND | sell | 35914 |
73
- | HKD | VND | reference | 3266.48 |
74
- | IDR | VND | reference | 1.43 |
75
- | INR | VND | reference | 270.46 |
39
+ | AED | VND | reference | 6978.98 |
40
+ | AUD | VND | buy | 17107 |
41
+ | AUD | VND | reference | 18018.59 |
42
+ | AUD | VND | sell | 18908 |
43
+ | BRL | VND | reference | 4789.32 |
44
+ | CAD | VND | buy | 17437 |
45
+ | CAD | VND | reference | 18224.54 |
46
+ | CAD | VND | sell | 19272 |
47
+ | CHF | VND | buy | 29687 |
48
+ | CHF | VND | reference | 30891.89 |
49
+ | CHF | VND | sell | 32812 |
50
+ | CNY | VND | reference | 3844.34 |
51
+ | DKK | VND | reference | 3813.63 |
52
+ | EUR | VND | buy | 27296 |
53
+ | EUR | VND | reference | 28501.67 |
54
+ | EUR | VND | sell | 30169 |
55
+ | GBP | VND | buy | 32638 |
56
+ | GBP | VND | reference | 34076.41 |
57
+ | GBP | VND | sell | 36074 |
58
+ | HKD | VND | reference | 3267.3 |
59
+ | IDR | VND | reference | 1.41 |
60
+ | INR | VND | reference | 269.43 |
76
61
  | JPY | VND | buy | 155 |
77
- | JPY | VND | reference | 162 |
62
+ | JPY | VND | reference | 162.26 |
78
63
  | JPY | VND | sell | 171 |
79
- | KHR | VND | reference | 6.3 |
80
- | KRW | VND | reference | 19.31 |
64
+ | KHR | VND | reference | 6.29 |
65
+ | KRW | VND | reference | 19.14 |
81
66
  | LAK | VND | reference | 1.14 |
82
- | MOP | VND | reference | 3171.35 |
83
- | MYR | VND | reference | 6282.84 |
84
- | NOK | VND | reference | 2727.43 |
85
- | NZD | VND | reference | 14547.3 |
86
- | PLN | VND | reference | 6591.75 |
87
- | RUB | VND | reference | 310.9 |
88
- | SEK | VND | reference | 2587.75 |
89
- | SGD | VND | reference | 20057.9 |
90
- | THB | VND | reference | 761.78 |
91
- | TRY | VND | reference | 516.99 |
92
- | TWD | VND | reference | 786.66 |
93
- | USD | VND | buy | 24402 |
94
- | USD | VND | reference | 25633 |
95
- | USD | VND | sell | 26864 |
67
+ | MOP | VND | reference | 3172.15 |
68
+ | MYR | VND | reference | 6282.11 |
69
+ | NOK | VND | reference | 2747.04 |
70
+ | NZD | VND | reference | 14376.43 |
71
+ | PLN | VND | reference | 6478.04 |
72
+ | RUB | VND | reference | 317.33 |
73
+ | SEK | VND | reference | 2574.56 |
74
+ | SGD | VND | reference | 20002.34 |
75
+ | THB | VND | reference | 757.87 |
76
+ | TRY | VND | reference | 514.54 |
77
+ | TWD | VND | reference | 790.57 |
78
+ | USD | VND | buy | 24406 |
79
+ | USD | VND | reference | 25637 |
80
+ | USD | VND | sell | 26868 |
96
81
 
97
82
  </details>
98
83
 
@@ -259,6 +244,7 @@ The State Bank of Vietnam announces a daily USD/VND central rate — each announ
259
244
 
260
245
  - Publisher's own page: [Central exchange rate](https://www.sbv.gov.vn/bieu-do-ty-gia-trung-tam) · [www.sbv.gov.vn](https://www.sbv.gov.vn)
261
246
  - Publication: every business day; the exact schedule, freshness status and any current delay are on the [State Bank of Vietnam rates page](https://allratestoday.com/central-bank-rates-api/sbv/)
247
+ - In the API: usually by **02:20 UTC** (measured over the last 13 publications). Schedule a sync at or after that time and retry hourly until `rate_date` moves; every response carries the same figure as `available_by_utc` — see [when to poll](https://allratestoday.com/docs/#when-to-poll)
262
248
  - Values are stored unmodified, with the publisher's own `rate_date` on every row — see the [methodology](https://allratestoday.com/official-rates-methodology/)
263
249
 
264
250
  ## 🧭 Reading the numbers
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@allratestoday/sbv-exchange-rate",
3
- "version": "1.3.19",
3
+ "version": "1.3.24",
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",