@allratestoday/bcstp-exchange-rate 1.3.2 → 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.
Files changed (2) hide show
  1. package/README.md +4 -3
  2. 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 Banco Central de São Tomé e Príncipe itself published, fixed once printed and carrying the central bank's own `rate_date` — what filings and audits require. Need the live interbank midpoint 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.
19
+ > **Official rate, not mid-market:** every value here is a number Banco Central de São Tomé e Príncipe 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
 
@@ -115,9 +115,9 @@ console.log(table.rate_date, table.rates.length);
115
115
  name: 'Banco Central de São Tomé e Príncipe',
116
116
  rate_date: '2026-09-25',
117
117
  rates: [
118
- { "base": "USD", "quote": "STN", "type": "buy", "value": 21.5536 },
119
- { "base": "USD", "quote": "STN", "type": "sell", "value": 21.8769 },
120
118
  { "base": "USD", "quote": "STN", "type": "middle", "value": 21.7153 },
119
+ { "base": "USD", "quote": "STN", "type": "sell", "value": 21.8769 },
120
+ { "base": "USD", "quote": "STN", "type": "buy", "value": 21.5536 },
121
121
  // … the rest of the published table (14 currencies vs STN)
122
122
  ],
123
123
  disclaimer: '…'
@@ -222,6 +222,7 @@ curl "https://allratestoday.com/api/v1/central-bank/bcstp/latest?format=xml&api_
222
222
  ## 🤖 AI agents
223
223
 
224
224
  - 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
225
+ - 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('bcstp')` 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
226
  - Machine-readable site guide: [llms.txt](https://allratestoday.com/llms.txt) · [for-ai-agents](https://allratestoday.com/for-ai-agents/)
226
227
 
227
228
  ## ⚖️ Published vs derived rates
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@allratestoday/bcstp-exchange-rate",
3
- "version": "1.3.2",
3
+ "version": "1.3.4",
4
4
  "description": "Official Banco Central de São Tomé e Príncipe (São Tomé and Príncipe) daily exchange rates — 14 currencies vs STN, history since 2026. Zero-dependency Node.js/TypeScript client.",
5
5
  "keywords": [
6
6
  "bcstp",