@allratestoday/bccr-exchange-rate 1.3.7 โ 1.3.13
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 -14
- package/package.json +11 -2
package/README.md
CHANGED
|
@@ -37,15 +37,17 @@ The open endpoint serves the *latest* table only and asks for a visible attribut
|
|
|
37
37
|
|
|
38
38
|
## ๐ Latest published table
|
|
39
39
|
|
|
40
|
-
|
|
40
|
+
[](https://allratestoday.com/central-bank-rates-api/bccr/)
|
|
41
|
+
|
|
42
|
+
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.
|
|
41
43
|
|
|
42
44
|
<!-- daily-table:start -->
|
|
43
|
-
Published **2026-10-
|
|
45
|
+
Published **2026-10-13** by Banco Central de Costa Rica โ 2 rates. Updated 2026-10-14.
|
|
44
46
|
|
|
45
47
|
| Base | Quote | Type | Rate |
|
|
46
48
|
| --- | --- | --- | ---: |
|
|
47
|
-
| USD | CRC | buy |
|
|
48
|
-
| USD | CRC | sell |
|
|
49
|
+
| USD | CRC | buy | 449.11 |
|
|
50
|
+
| USD | CRC | sell | 454.48 |
|
|
49
51
|
|
|
50
52
|
Source: [Official rates published by BCCR, served by AllRatesToday](https://allratestoday.com/central-bank-rates-api/bccr/). Rates are as printed by the central bank; AllRatesToday is not affiliated with it.
|
|
51
53
|
<!-- daily-table:end -->
|
|
@@ -102,10 +104,10 @@ const pair = await getRate('USD', 'CRC', { apiKey: 'art_live_...' });
|
|
|
102
104
|
{
|
|
103
105
|
bank: 'bccr',
|
|
104
106
|
name: 'Banco Central de Costa Rica',
|
|
105
|
-
rate_date: '2026-10-
|
|
107
|
+
rate_date: '2026-10-13', // Banco Central de Costa Rica's own publication date
|
|
106
108
|
source: 'USD',
|
|
107
109
|
target: 'CRC',
|
|
108
|
-
rate:
|
|
110
|
+
rate: 454.48,
|
|
109
111
|
rate_type: 'sell',
|
|
110
112
|
derived: false,
|
|
111
113
|
method: 'published',
|
|
@@ -130,10 +132,10 @@ console.log(table.rate_date, table.rates.length);
|
|
|
130
132
|
{
|
|
131
133
|
bank: 'bccr',
|
|
132
134
|
name: 'Banco Central de Costa Rica',
|
|
133
|
-
rate_date: '2026-10-
|
|
135
|
+
rate_date: '2026-10-13',
|
|
134
136
|
rates: [
|
|
135
|
-
{ "base": "USD", "quote": "CRC", "type": "sell", "value":
|
|
136
|
-
{ "base": "USD", "quote": "CRC", "type": "buy", "value":
|
|
137
|
+
{ "base": "USD", "quote": "CRC", "type": "sell", "value": 454.48 },
|
|
138
|
+
{ "base": "USD", "quote": "CRC", "type": "buy", "value": 449.11 },
|
|
137
139
|
// โฆ the rest of the published table (2 currencies vs CRC)
|
|
138
140
|
],
|
|
139
141
|
disclaimer: 'โฆ'
|
|
@@ -173,7 +175,7 @@ Paid plans. One resolved rate per publication date โ ready for charting, reval
|
|
|
173
175
|
import { getHistory } from '@allratestoday/bccr-exchange-rate';
|
|
174
176
|
|
|
175
177
|
const series = await getHistory(
|
|
176
|
-
{ source: 'USD', target: 'CRC', from: '2026-01-01', to: '2026-10-
|
|
178
|
+
{ source: 'USD', target: 'CRC', from: '2026-01-01', to: '2026-10-13' },
|
|
177
179
|
{ apiKey: 'art_live_...' }
|
|
178
180
|
);
|
|
179
181
|
```
|
|
@@ -186,11 +188,11 @@ const series = await getHistory(
|
|
|
186
188
|
source: 'USD',
|
|
187
189
|
target: 'CRC',
|
|
188
190
|
from: '2026-01-01',
|
|
189
|
-
to: '2026-10-
|
|
191
|
+
to: '2026-10-13',
|
|
190
192
|
count: 152,
|
|
191
193
|
rates: [
|
|
192
194
|
// one entry per publication date
|
|
193
|
-
{ date: '2026-10-
|
|
195
|
+
{ date: '2026-10-13', rate: 454.48, rate_type: 'sell', derived: false, method: 'published' },
|
|
194
196
|
// โฆ
|
|
195
197
|
],
|
|
196
198
|
disclaimer: 'โฆ'
|
|
@@ -240,6 +242,7 @@ curl "https://allratestoday.com/api/v1/central-bank/bccr/latest?format=xml&api_k
|
|
|
240
242
|
- 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
|
|
241
243
|
- 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('bccr')` 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
|
|
242
244
|
- 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 bccr ...` command
|
|
245
|
+
- 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`
|
|
243
246
|
- Machine-readable site guide: [llms.txt](https://allratestoday.com/llms.txt) ยท [for-ai-agents](https://allratestoday.com/for-ai-agents/)
|
|
244
247
|
|
|
245
248
|
## โ๏ธ Published vs derived rates
|
|
@@ -308,9 +311,9 @@ getRate('USD', 'CRC', { apiKey: 'art_live_...' }).then((pair) => console.log(pai
|
|
|
308
311
|
|
|
309
312
|
Need the whole archive rather than an API call? The same published tables are mirrored daily as open data:
|
|
310
313
|
|
|
311
|
-
- Hugging Face: [
|
|
314
|
+
- Hugging Face: [AllRatesToday/central-bank-exchange-rates](https://huggingface.co/datasets/AllRatesToday/central-bank-exchange-rates) โ one CSV per institution (`rates/bccr.csv`)
|
|
312
315
|
- Kaggle: [allratestoday/central-bank-exchange-rates](https://www.kaggle.com/datasets/allratestoday/central-bank-exchange-rates)
|
|
313
|
-
-
|
|
316
|
+
- Raw JSON on GitHub: `https://raw.githubusercontent.com/AllRates-Today/central-bank-exchange-rates/main/data/bccr/latest.json`
|
|
314
317
|
|
|
315
318
|
## ๐ Links
|
|
316
319
|
|
package/package.json
CHANGED
|
@@ -1,20 +1,29 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@allratestoday/bccr-exchange-rate",
|
|
3
|
-
"version": "1.3.
|
|
3
|
+
"version": "1.3.13",
|
|
4
4
|
"description": "Official Banco Central de Costa Rica (Costa Rica) daily exchange rates โ 2 currencies vs CRC, current table, archive from 2026. Zero-dependency Node.js/TypeScript client.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"bccr",
|
|
7
|
+
"banco-central-de-costa-rica",
|
|
7
8
|
"banco",
|
|
8
9
|
"central",
|
|
9
|
-
"de",
|
|
10
10
|
"costa",
|
|
11
11
|
"rica",
|
|
12
12
|
"exchange-rate",
|
|
13
13
|
"exchange-rates",
|
|
14
|
+
"exchangerate",
|
|
15
|
+
"exchange rate",
|
|
16
|
+
"crc-exchange-rate",
|
|
14
17
|
"currency",
|
|
15
18
|
"forex",
|
|
16
19
|
"fx",
|
|
17
20
|
"crc",
|
|
21
|
+
"currency-api",
|
|
22
|
+
"currency-exchange-rates",
|
|
23
|
+
"forex-api",
|
|
24
|
+
"currency-conversion",
|
|
25
|
+
"currency-exchange",
|
|
26
|
+
"currency-rates",
|
|
18
27
|
"central-bank",
|
|
19
28
|
"official-rates",
|
|
20
29
|
"costa-rica",
|