@allratestoday/sbv-exchange-rate 1.3.7 → 1.3.13

package/README.md

@@ -37,32 +37,34 @@ The open endpoint serves the *latest* table only and asks for a visible attribut
 
 ## 📈 Latest published table
 
-Today's full State Bank of Vietnam table, straight from the central bank's latest publication. On GitHub it is refreshed by [a daily Action](.github/workflows/daily-table.yml) that reads the keyless endpoint above and commits only when the central bank publishes a new table; the copy on npm is as of the package's publish date.
+[![Latest State Bank of Vietnam table](https://allratestoday.com/api/open/central-bank/sbv/table.svg)](https://allratestoday.com/central-bank-rates-api/sbv/)
+
+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 text copy below is there 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.
 
 <!-- daily-table:start -->
-Published **2026-10-09** by State Bank of Vietnam — 42 rates. Updated 2026-10-09.
+Published **2026-10-14** by State Bank of Vietnam — 42 rates. Updated 2026-10-14.
 
 | Base | Quote | Type | Rate |
 | --- | --- | --- | ---: |
 | AED | VND | reference | 6980.7 |
-| AUD | VND | buy | 16962 |
+| AUD | VND | buy | 17031 |
 | AUD | VND | reference | 17869.69 |
-| AUD | VND | sell | 18747 |
+| AUD | VND | sell | 18824 |
 | BRL | VND | reference | 5145.3 |
-| CAD | VND | buy | 17127 |
+| CAD | VND | buy | 17148 |
 | CAD | VND | reference | 18030.8 |
-| CAD | VND | sell | 18930 |
-| CHF | VND | buy | 29294 |
+| CAD | VND | sell | 18953 |
+| CHF | VND | buy | 29267 |
 | CHF | VND | reference | 30789 |
-| CHF | VND | sell | 32377 |
+| CHF | VND | sell | 32348 |
 | CNY | VND | reference | 3824 |
 | DKK | VND | reference | 3850.71 |
-| EUR | VND | buy | 27318 |
+| EUR | VND | buy | 27297 |
 | EUR | VND | reference | 28778.66 |
-| EUR | VND | sell | 30194 |
-| GBP | VND | buy | 32231 |
+| EUR | VND | sell | 30170 |
+| GBP | VND | buy | 32310 |
 | GBP | VND | reference | 33960.09 |
-| GBP | VND | sell | 35624 |
+| GBP | VND | sell | 35711 |
 | HKD | VND | reference | 3267.03 |
 | IDR | VND | reference | 1.43 |
 | INR | VND | reference | 265.17 |
@@ -83,9 +85,9 @@ Published **2026-10-09** by State Bank of Vietnam — 42 rates. Updated 2026-10-
 | THB | VND | reference | 761.45 |
 | TRY | VND | reference | 521.18 |
 | TWD | VND | reference | 804.78 |
-| USD | VND | buy | 24398 |
-| USD | VND | reference | 25629 |
-| USD | VND | sell | 26860 |
+| USD | VND | buy | 24414 |
+| USD | VND | reference | 25646 |
+| USD | VND | sell | 26878 |
 
 Source: [Official rates published by SBV, served by AllRatesToday](https://allratestoday.com/central-bank-rates-api/sbv/). Rates are as printed by the central bank; AllRatesToday is not affiliated with it.
 <!-- daily-table:end -->
@@ -142,10 +144,10 @@ const pair = await getRate('USD', 'VND', { apiKey: 'art_live_...' });
 {
   bank: 'sbv',
   name: 'State Bank of Vietnam',
-  rate_date: '2026-10-08',   // State Bank of Vietnam's own publication date
+  rate_date: '2026-10-14',   // State Bank of Vietnam's own publication date
   source: 'USD',
   target: 'VND',
-  rate: 25634,
+  rate: 25646,
   rate_type: 'reference',
   derived: false,
   method: 'published',
@@ -170,11 +172,11 @@ console.log(table.rate_date, table.rates.length);
 {
   bank: 'sbv',
   name: 'State Bank of Vietnam',
-  rate_date: '2026-10-08',
+  rate_date: '2026-10-14',
   rates: [
-    { "base": "USD", "quote": "VND", "type": "reference", "value": 25634 },
-    { "base": "USD", "quote": "VND", "type": "sell", "value": 26869 },
-    { "base": "USD", "quote": "VND", "type": "buy", "value": 24407 },
+    { "base": "USD", "quote": "VND", "type": "reference", "value": 25646 },
+    { "base": "USD", "quote": "VND", "type": "sell", "value": 26878 },
+    { "base": "USD", "quote": "VND", "type": "buy", "value": 24414 },
     // … the rest of the published table (28 currencies vs VND)
   ],
   disclaimer: '…'
@@ -214,7 +216,7 @@ Paid plans. One resolved rate per publication date — ready for charting, reval
 import { getHistory } from '@allratestoday/sbv-exchange-rate';
 
 const series = await getHistory(
-  { source: 'USD', target: 'VND', from: '2026-01-01', to: '2026-10-08' },
+  { source: 'USD', target: 'VND', from: '2026-01-01', to: '2026-10-14' },
   { apiKey: 'art_live_...' }
 );
 ```
@@ -227,11 +229,11 @@ const series = await getHistory(
   source: 'USD',
   target: 'VND',
   from: '2026-01-01',
-  to: '2026-10-08',
+  to: '2026-10-14',
   count: 152,
   rates: [
     // one entry per publication date
-    { date: '2026-10-08', rate: 25634, rate_type: 'reference', derived: false, method: 'published' },
+    { date: '2026-10-14', rate: 25646, rate_type: 'reference', derived: false, method: 'published' },
     // …
   ],
   disclaimer: '…'
@@ -281,6 +283,7 @@ curl "https://allratestoday.com/api/v1/central-bank/sbv/latest?format=xml&api_ke
 - 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
 - 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
 - Claude Code plugin (no key): `/plugin marketplace add AllRates-Today/claude-code-plugin` then `/plugin install allratestoday@allratestoday` — bundles both MCP servers plus an `/official-rate sbv ...` command
+- Need dated tables or history for an evaluation? Agents can self-issue a trial key with no signup: `POST https://allratestoday.com/api/agent/keys` (send `Content-Type: application/json`) returns a 100-call key valid 7 days; the MCP servers expose it as `request_trial_key`
 - Machine-readable site guide: [llms.txt](https://allratestoday.com/llms.txt) · [for-ai-agents](https://allratestoday.com/for-ai-agents/)
 
 ## ⚖️ Published vs derived rates
@@ -349,9 +352,9 @@ getRate('USD', 'VND', { apiKey: 'art_live_...' }).then((pair) => console.log(pai
 
 Need the whole archive rather than an API call? The same published tables are mirrored daily as open data:
 
-- Hugging Face: [AllRates/central-bank-exchange-rates](https://huggingface.co/datasets/AllRates/central-bank-exchange-rates) — one CSV per institution (`rates/sbv.csv`)
+- Hugging Face: [AllRatesToday/central-bank-exchange-rates](https://huggingface.co/datasets/AllRatesToday/central-bank-exchange-rates) — one CSV per institution (`rates/sbv.csv`)
 - Kaggle: [allratestoday/central-bank-exchange-rates](https://www.kaggle.com/datasets/allratestoday/central-bank-exchange-rates)
-- CDN JSON: `https://cdn.jsdelivr.net/gh/AllRates-Today/central-bank-exchange-rates@main/data/sbv/latest.json`
+- Raw JSON on GitHub: `https://raw.githubusercontent.com/AllRates-Today/central-bank-exchange-rates/main/data/sbv/latest.json`
 
 ## 🔗 Links
 

package/package.json

@@ -1,22 +1,30 @@
 {
   "name": "@allratestoday/sbv-exchange-rate",
-  "version": "1.3.7",
+  "version": "1.3.13",
   "description": "Official State Bank of Vietnam (Vietnam) daily exchange rates — 28 currencies vs VND, history since 2009. Zero-dependency Node.js/TypeScript client.",
   "keywords": [
     "sbv",
+    "state-bank-of-vietnam",
     "state",
     "bank",
-    "of",
     "vietnam",
     "exchange-rate",
     "exchange-rates",
+    "exchangerate",
+    "exchange rate",
+    "vnd-exchange-rate",
     "currency",
     "forex",
     "fx",
     "vnd",
+    "currency-api",
+    "currency-exchange-rates",
+    "forex-api",
+    "currency-conversion",
+    "currency-exchange",
+    "currency-rates",
     "central-bank",
     "official-rates",
-    "vietnam",
     "api",
     "typescript"
   ],