@allratestoday/cbe-exchange-rate 1.3.27 โ†’ 1.3.30

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 +69 -24
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -4,16 +4,16 @@
4
4
  [![license](https://img.shields.io/npm/l/@allratestoday%2Fcbe-exchange-rate.svg)](https://github.com/AllRates-Today/cbe-exchange-rate/blob/main/LICENSE)
5
5
  [![zero dependencies](https://img.shields.io/badge/dependencies-0-brightgreen.svg)](https://www.npmjs.com/package/@allratestoday/cbe-exchange-rate)
6
6
  [![TypeScript](https://img.shields.io/badge/TypeScript-types%20included-3178C6.svg)](https://www.typescriptlang.org/)
7
- [![USD/EGP today](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fallratestoday.com%2Fapi%2Fopen%2Fcentral-bank%2Fcbe%3Fsource%3DUSD%26target%3DEGP&query=%24.rate&label=USD%2FEGP%20published%20by%20Central%20Bank%20of%20Egypt&color=0A7E8C&cacheSeconds=3600)](https://allratestoday.com/central-bank-rates-api/cbe/)
7
+ [![USD/EGP today](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fallratestoday.com%2Fapi%2Fopen%2Fcentral-bank%2Fcbe%3Fsource%3DUSD%26target%3DEGP&query=%24.rate&label=USD%2FEGP%20official%2C%20Central%20Bank%20of%20Egypt&color=0A7E8C&cacheSeconds=3600)](https://allratestoday.com/central-bank-rates-api/cbe/)
8
8
  [![rate date](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fallratestoday.com%2Fapi%2Fopen%2Fcentral-bank%2Fcbe%3Fsource%3DUSD%26target%3DEGP&query=%24.rate_date&label=rate%20date&color=555&cacheSeconds=3600)](https://allratestoday.com/central-bank-rates-api/cbe/)
9
9
 
10
10
  **Official Central Bank of Egypt (Egypt) daily exchange rates for Node.js and TypeScript. The published central bank rates behind tax filings, customs valuations, audits, and compliant invoicing โ€” not market estimates, but the numbers Central Bank of Egypt itself prints, every business day.**
11
11
 
12
12
  ## ๐Ÿš€ Why this client?
13
13
 
14
- - ๐Ÿ›๏ธ **Official published rates** โ€” Central Bank of Egypt's own table, with the publisher's own `rate_date` on every response
14
+ - ๐Ÿ›๏ธ **Official rates** โ€” Central Bank of Egypt's own table, with the publisher's own `rate_date` on every response
15
15
  - ๐Ÿ“… **History back to 2026** โ€” point-in-time tables and daily series for any past date
16
- - ๐Ÿ”€ **Published vs derived, always flagged** โ€” computed inverse/cross pairs carry `derived: true`, never mixed with official prints
16
+ - ๐Ÿ”€ **Official vs derived, always flagged** โ€” computed inverse/cross pairs carry `derived: true`, never mixed with official prints
17
17
  - โšก **Zero dependencies** โ€” pure ESM + CJS over global `fetch`; Node 18+, Bun, Deno, and edge runtimes
18
18
  - ๐Ÿ”ท **Type-safe** โ€” full TypeScript definitions shipped with the package
19
19
  - ๐Ÿงพ **Compliance-grade metadata** โ€” `rate_type`, publication date, and source disclaimer on every response
@@ -24,14 +24,58 @@
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
- ## ๐Ÿ“ˆ Latest published table
27
+ ## ๐Ÿ“ˆ Latest official table
28
28
 
29
29
  [![Latest Central Bank of Egypt table](https://allratestoday.com/api/open/central-bank/cbe/table.svg)](https://allratestoday.com/central-bank-rates-api/cbe/)
30
30
 
31
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.
32
32
 
33
33
  <!-- daily-table:start -->
34
- _The table is filled in by the daily workflow._
34
+ <details>
35
+ <summary>Table as text: published 2026-11-11 by Central Bank of Egypt โ€” 36 rates. Updated 2026-11-11.</summary>
36
+
37
+ | Base | Quote | Type | Rate |
38
+ | --- | --- | --- | ---: |
39
+ | AED | EGP | buy | 14.563 |
40
+ | AED | EGP | sell | 14.6013 |
41
+ | AUD | EGP | buy | 36.7027 |
42
+ | AUD | EGP | sell | 36.8025 |
43
+ | BHD | EGP | buy | 141.7998 |
44
+ | BHD | EGP | sell | 142.2402 |
45
+ | CAD | EGP | buy | 37.5848 |
46
+ | CAD | EGP | sell | 37.6842 |
47
+ | CHF | EGP | buy | 64.4809 |
48
+ | CHF | EGP | sell | 64.6625 |
49
+ | CNY | EGP | buy | 8.0177 |
50
+ | CNY | EGP | sell | 8.0393 |
51
+ | DKK | EGP | buy | 7.9673 |
52
+ | DKK | EGP | sell | 7.9884 |
53
+ | EUR | EGP | buy | 59.5576 |
54
+ | EUR | EGP | sell | 59.7217 |
55
+ | GBP | EGP | buy | 71.1803 |
56
+ | GBP | EGP | sell | 71.3797 |
57
+ | JOD | EGP | buy | 75.3336 |
58
+ | JOD | EGP | sell | 75.7409 |
59
+ | JPY | EGP | buy | 0.336121 |
60
+ | JPY | EGP | sell | 0.337071 |
61
+ | KWD | EGP | buy | 173.4897 |
62
+ | KWD | EGP | sell | 173.9928 |
63
+ | NOK | EGP | buy | 5.6067 |
64
+ | NOK | EGP | sell | 5.6259 |
65
+ | OMR | EGP | buy | 138.9125 |
66
+ | OMR | EGP | sell | 139.2882 |
67
+ | QAR | EGP | buy | 14.662 |
68
+ | QAR | EGP | sell | 14.7239 |
69
+ | SAR | EGP | buy | 14.2506 |
70
+ | SAR | EGP | sell | 14.2896 |
71
+ | SEK | EGP | buy | 5.3906 |
72
+ | SEK | EGP | sell | 5.4056 |
73
+ | USD | EGP | buy | 53.4869 |
74
+ | USD | EGP | sell | 53.6246 |
75
+
76
+ </details>
77
+
78
+ Source: [Official rates published by CBE, served by AllRatesToday](https://allratestoday.com/central-bank-rates-api/cbe/). Rates are as printed by the central bank; AllRatesToday is not affiliated with it.
35
79
  <!-- daily-table:end -->
36
80
 
37
81
  ## ๐Ÿ“ฆ Installation
@@ -61,8 +105,8 @@ console.log(pair.rate, pair.rate_date); // the official Central Bank of Egypt ra
61
105
 
62
106
  ## ๐Ÿ“š API reference
63
107
 
64
- - [Latest pair rate](#latest-pair-rate) โ€” one pair from the latest published table
65
- - [Full published table](#full-published-table) โ€” everything the central bank printed, in one call
108
+ - [Latest pair rate](#latest-pair-rate) โ€” one pair from the latest official table
109
+ - [Full official table](#full-official-table) โ€” everything the central bank printed, in one call
66
110
  - [Table for a date](#table-for-a-date) โ€” the official table for an invoice or filing date
67
111
  - [Daily time series](#daily-time-series) โ€” one pair across a date range
68
112
 
@@ -70,7 +114,7 @@ console.log(pair.rate, pair.rate_date); // the official Central Bank of Egypt ra
70
114
 
71
115
  ### Latest pair rate
72
116
 
73
- Free plan and up. Pairs the central bank does not print directly are resolved from its table and flagged (see *Published vs derived rates* below).
117
+ Free plan and up. Pairs the central bank does not print directly are resolved from its table and flagged (see *Official vs derived rates* below).
74
118
 
75
119
  ```js
76
120
  const pair = await getRate('USD', 'EGP', { apiKey: 'art_live_...' });
@@ -82,10 +126,10 @@ const pair = await getRate('USD', 'EGP', { apiKey: 'art_live_...' });
82
126
  {
83
127
  bank: 'cbe',
84
128
  name: 'Central Bank of Egypt',
85
- rate_date: '2026-10-14', // Central Bank of Egypt's own publication date
129
+ rate_date: '2026-11-11', // Central Bank of Egypt's own publication date
86
130
  source: 'USD',
87
131
  target: 'EGP',
88
- rate: 53.1817,
132
+ rate: 53.6246,
89
133
  rate_type: 'sell',
90
134
  derived: false,
91
135
  method: 'published',
@@ -93,7 +137,7 @@ const pair = await getRate('USD', 'EGP', { apiKey: 'art_live_...' });
93
137
  }
94
138
  ```
95
139
 
96
- ### Full published table
140
+ ### Full official table
97
141
 
98
142
  Free plan and up. The complete table for the latest publication date.
99
143
 
@@ -110,11 +154,11 @@ console.log(table.rate_date, table.rates.length);
110
154
  {
111
155
  bank: 'cbe',
112
156
  name: 'Central Bank of Egypt',
113
- rate_date: '2026-10-14',
157
+ rate_date: '2026-11-11',
114
158
  rates: [
115
- { "base": "USD", "quote": "EGP", "type": "sell", "value": 53.1817 },
116
- { "base": "USD", "quote": "EGP", "type": "buy", "value": 53.0417 },
117
- // โ€ฆ the rest of the published table (18 currencies vs EGP)
159
+ { "base": "USD", "quote": "EGP", "type": "sell", "value": 53.6246 },
160
+ { "base": "USD", "quote": "EGP", "type": "buy", "value": 53.4869 },
161
+ // โ€ฆ the rest of the official table (18 currencies vs EGP)
118
162
  ],
119
163
  disclaimer: 'โ€ฆ'
120
164
  }
@@ -153,7 +197,7 @@ Paid plans. One resolved rate per publication date โ€” ready for charting, reval
153
197
  import { getHistory } from '@allratestoday/cbe-exchange-rate';
154
198
 
155
199
  const series = await getHistory(
156
- { source: 'USD', target: 'EGP', from: '2026-01-01', to: '2026-10-14' },
200
+ { source: 'USD', target: 'EGP', from: '2026-01-01', to: '2026-11-11' },
157
201
  { apiKey: 'art_live_...' }
158
202
  );
159
203
  ```
@@ -166,11 +210,11 @@ const series = await getHistory(
166
210
  source: 'USD',
167
211
  target: 'EGP',
168
212
  from: '2026-01-01',
169
- to: '2026-10-14',
213
+ to: '2026-11-11',
170
214
  count: 152,
171
215
  rates: [
172
216
  // one entry per publication date
173
- { date: '2026-10-14', rate: 53.1817, rate_type: 'sell', derived: false, method: 'published' },
217
+ { date: '2026-11-11', rate: 53.6246, rate_type: 'sell', derived: false, method: 'published' },
174
218
  // โ€ฆ
175
219
  ],
176
220
  disclaimer: 'โ€ฆ'
@@ -224,7 +268,7 @@ curl "https://allratestoday.com/api/v1/central-bank/cbe/latest?format=xml&api_ke
224
268
  - Evaluating? 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 that covers the free-plan methods (latest table, pairs); dated tables and history need a [paid plan](https://allratestoday.com/pricing/). The MCP servers expose it as `request_trial_key`
225
269
  - Machine-readable site guide: [llms.txt](https://allratestoday.com/llms.txt) ยท [for-ai-agents](https://allratestoday.com/for-ai-agents/)
226
270
 
227
- ## โš–๏ธ Published vs derived rates
271
+ ## โš–๏ธ Official vs derived rates
228
272
 
229
273
  If Central Bank of Egypt does not print a pair directly, the API resolves it from the central bank's own table and says so โ€” official and computed values are never confused:
230
274
 
@@ -274,21 +318,21 @@ getRate('USD', 'EGP', { apiKey: 'art_live_...' }).then((pair) => console.log(pai
274
318
 
275
319
  ## ๐Ÿ’ก Quota tips
276
320
 
277
- - Rates change once per business day โ€” cache the published table locally and a small monthly quota goes a long way.
321
+ - Rates change once per business day โ€” cache the official table locally and a small monthly quota goes a long way.
278
322
  - Every request counts toward your AllRatesToday quota, shared across all AllRatesToday endpoints on your key.
279
323
 
280
324
  ## ๐Ÿ“– Methods reference
281
325
 
282
326
  | Method | Plan | Description |
283
327
  | ------ | ---- | ----------- |
284
- | `getRate(source, target, { apiKey })` | Free | Latest rate for one pair, resolved from the published table |
285
- | `getLatestRates({ apiKey })` | Free | The central bank's full latest published table |
328
+ | `getRate(source, target, { apiKey })` | Free | Latest rate for one pair, resolved from the official table |
329
+ | `getLatestRates({ apiKey })` | Free | The central bank's full latest official table |
286
330
  | `getRatesForDate(date, { apiKey, source?, target? })` | Paid | The official table (or one pair) for a YYYY-MM-DD date |
287
331
  | `getHistory({ symbol \| source+target, from?, to? }, { apiKey })` | Paid | Daily series since 2026 |
288
332
 
289
333
  ## ๐Ÿ“ฅ Bulk data (no key)
290
334
 
291
- Need the whole archive rather than an API call? The same published tables are mirrored daily as open data:
335
+ Need the whole archive rather than an API call? The same official tables are mirrored daily as open data:
292
336
 
293
337
  - Hugging Face: [AllRatesToday/central-bank-exchange-rates](https://huggingface.co/datasets/AllRatesToday/central-bank-exchange-rates) โ€” one CSV per institution (`rates/cbe.csv`)
294
338
  - Kaggle: [allratestoday/central-bank-exchange-rates](https://www.kaggle.com/datasets/allratestoday/central-bank-exchange-rates)
@@ -298,7 +342,7 @@ Need the whole archive rather than an API call? The same published tables are mi
298
342
 
299
343
  - **Website:** [allratestoday.com](https://allratestoday.com)
300
344
  - [Central Bank of Egypt rates page](https://allratestoday.com/central-bank-rates-api/cbe/) โ€” live table, publication cadence, FAQ
301
- - [All central bank sources](https://allratestoday.com/central-bank-rates-api/)
345
+ - [All central bank sources](https://allratestoday.com/central-bank-rates-api/) ยท [Full list of 130+ central banks and tax authorities](https://allratestoday.com/central-bank-rates-api/institutions/) โ€” one API, the same response shape for every source
302
346
  - [Download central bank rates](https://allratestoday.com/download-central-bank-rates/) โ€” every bank's latest table and history as Excel, CSV or JSON
303
347
  - [Package docs on the site](https://allratestoday.com/docs/sdk/cbe-exchange-rate/) ยท [ERP integration guides](https://allratestoday.com/docs/integrations/)
304
348
  - [API documentation](https://allratestoday.com/docs/#central-bank) ยท [Interactive reference](https://allratestoday.com/api-reference/) ยท [Methodology](https://allratestoday.com/official-rates-methodology/)
@@ -306,6 +350,7 @@ Need the whole archive rather than an API call? The same published tables are mi
306
350
  - [Status](https://allratestoday.com/status)
307
351
  - [Postman collection](https://allratestoday.com/postman/)
308
352
  - [ChatGPT app](https://chatgpt.com/plugins/plugin_asdk_app_6ae1e76098f48191a285ac3f5ab7a83b) โ€” ask ChatGPT for live and official central bank rates
353
+ - [OpenAPI reference on Bump.sh](https://bump.sh/allratestoday/doc/allratestoday-api) โ€” also on [SwaggerHub](https://app.swaggerhub.com/apis-docs/allratestoday/allratestoday-exchange-rate-central-bank-rates-api/2.2.0)
309
354
  - [GitHub](https://github.com/AllRates-Today/cbe-exchange-rate)
310
355
 
311
356
  ## ๐Ÿ“œ License
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@allratestoday/cbe-exchange-rate",
3
- "version": "1.3.27",
3
+ "version": "1.3.30",
4
4
  "description": "Official Central Bank of Egypt (Egypt) daily exchange rates โ€” 18 currencies vs EGP, history since 2026. Zero-dependency Node.js/TypeScript client.",
5
5
  "keywords": [
6
6
  "cbe",