@allratestoday/rbi-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 +38 -23
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -4,16 +4,16 @@
4
4
  [![license](https://img.shields.io/npm/l/@allratestoday%2Frbi-exchange-rate.svg)](https://github.com/AllRates-Today/rbi-exchange-rate/blob/main/LICENSE)
5
5
  [![zero dependencies](https://img.shields.io/badge/dependencies-0-brightgreen.svg)](https://www.npmjs.com/package/@allratestoday/rbi-exchange-rate)
6
6
  [![TypeScript](https://img.shields.io/badge/TypeScript-types%20included-3178C6.svg)](https://www.typescriptlang.org/)
7
- [![USD/INR today](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fallratestoday.com%2Fapi%2Fopen%2Fcentral-bank%2Frbi%3Fsource%3DUSD%26target%3DINR&query=%24.rate&label=USD%2FINR%20published%20by%20Reserve%20Bank%20of%20India&color=0A7E8C&cacheSeconds=3600)](https://allratestoday.com/central-bank-rates-api/rbi/)
7
+ [![USD/INR today](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fallratestoday.com%2Fapi%2Fopen%2Fcentral-bank%2Frbi%3Fsource%3DUSD%26target%3DINR&query=%24.rate&label=USD%2FINR%20official%2C%20Reserve%20Bank%20of%20India&color=0A7E8C&cacheSeconds=3600)](https://allratestoday.com/central-bank-rates-api/rbi/)
8
8
  [![rate date](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fallratestoday.com%2Fapi%2Fopen%2Fcentral-bank%2Frbi%3Fsource%3DUSD%26target%3DINR&query=%24.rate_date&label=rate%20date&color=555&cacheSeconds=3600)](https://allratestoday.com/central-bank-rates-api/rbi/)
9
9
 
10
10
  **Official Reserve Bank of India (India) 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 Reserve Bank of India itself prints, every business day.**
11
11
 
12
12
  ## ๐Ÿš€ Why this client?
13
13
 
14
- - ๐Ÿ›๏ธ **Official published rates** โ€” Reserve Bank of India's own table, with the publisher's own `rate_date` on every response
14
+ - ๐Ÿ›๏ธ **Official rates** โ€” Reserve Bank of India's own table, with the publisher's own `rate_date` on every response
15
15
  - ๐Ÿ“… **History back to 2003** โ€” 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,28 @@
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 Reserve Bank of India table](https://allratestoday.com/api/open/central-bank/rbi/table.svg)](https://allratestoday.com/central-bank-rates-api/rbi/)
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 Reserve Bank of India โ€” 6 rates. Updated 2026-11-11.</summary>
36
+
37
+ | Base | Quote | Type | Rate |
38
+ | --- | --- | --- | ---: |
39
+ | AED | INR | reference | 25.5406 |
40
+ | EUR | INR | reference | 104.666 |
41
+ | GBP | INR | reference | 125.1383 |
42
+ | IDR | INR | reference | 0.00516605 |
43
+ | JPY | INR | reference | 0.5906 |
44
+ | USD | INR | reference | 93.8075 |
45
+
46
+ </details>
47
+
48
+ Source: [Official rates published by RBI, served by AllRatesToday](https://allratestoday.com/central-bank-rates-api/rbi/). Rates are as printed by the central bank; AllRatesToday is not affiliated with it.
35
49
  <!-- daily-table:end -->
36
50
 
37
51
  ## ๐Ÿ“ฆ Installation
@@ -61,8 +75,8 @@ console.log(pair.rate, pair.rate_date); // the official Reserve Bank of India ra
61
75
 
62
76
  ## ๐Ÿ“š API reference
63
77
 
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
78
+ - [Latest pair rate](#latest-pair-rate) โ€” one pair from the latest official table
79
+ - [Full official table](#full-official-table) โ€” everything the central bank printed, in one call
66
80
  - [Table for a date](#table-for-a-date) โ€” the official table for an invoice or filing date
67
81
  - [Daily time series](#daily-time-series) โ€” one pair across a date range
68
82
 
@@ -70,7 +84,7 @@ console.log(pair.rate, pair.rate_date); // the official Reserve Bank of India ra
70
84
 
71
85
  ### Latest pair rate
72
86
 
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).
87
+ 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
88
 
75
89
  ```js
76
90
  const pair = await getRate('USD', 'INR', { apiKey: 'art_live_...' });
@@ -82,10 +96,10 @@ const pair = await getRate('USD', 'INR', { apiKey: 'art_live_...' });
82
96
  {
83
97
  bank: 'rbi',
84
98
  name: 'Reserve Bank of India',
85
- rate_date: '2026-10-14', // Reserve Bank of India's own publication date
99
+ rate_date: '2026-11-11', // Reserve Bank of India's own publication date
86
100
  source: 'USD',
87
101
  target: 'INR',
88
- rate: 95.0317,
102
+ rate: 93.8075,
89
103
  rate_type: 'reference',
90
104
  derived: false,
91
105
  method: 'published',
@@ -93,7 +107,7 @@ const pair = await getRate('USD', 'INR', { apiKey: 'art_live_...' });
93
107
  }
94
108
  ```
95
109
 
96
- ### Full published table
110
+ ### Full official table
97
111
 
98
112
  Free plan and up. The complete table for the latest publication date.
99
113
 
@@ -110,10 +124,10 @@ console.log(table.rate_date, table.rates.length);
110
124
  {
111
125
  bank: 'rbi',
112
126
  name: 'Reserve Bank of India',
113
- rate_date: '2026-10-14',
127
+ rate_date: '2026-11-11',
114
128
  rates: [
115
- { "base": "USD", "quote": "INR", "type": "reference", "value": 95.0317 },
116
- // โ€ฆ the rest of the published table (6 currencies vs INR)
129
+ { "base": "USD", "quote": "INR", "type": "reference", "value": 93.8075 },
130
+ // โ€ฆ the rest of the official table (6 currencies vs INR)
117
131
  ],
118
132
  disclaimer: 'โ€ฆ'
119
133
  }
@@ -152,7 +166,7 @@ Paid plans. One resolved rate per publication date โ€” ready for charting, reval
152
166
  import { getHistory } from '@allratestoday/rbi-exchange-rate';
153
167
 
154
168
  const series = await getHistory(
155
- { source: 'USD', target: 'INR', from: '2026-01-01', to: '2026-10-14' },
169
+ { source: 'USD', target: 'INR', from: '2026-01-01', to: '2026-11-11' },
156
170
  { apiKey: 'art_live_...' }
157
171
  );
158
172
  ```
@@ -165,11 +179,11 @@ const series = await getHistory(
165
179
  source: 'USD',
166
180
  target: 'INR',
167
181
  from: '2026-01-01',
168
- to: '2026-10-14',
182
+ to: '2026-11-11',
169
183
  count: 152,
170
184
  rates: [
171
185
  // one entry per publication date
172
- { date: '2026-10-14', rate: 95.0317, rate_type: 'reference', derived: false, method: 'published' },
186
+ { date: '2026-11-11', rate: 93.8075, rate_type: 'reference', derived: false, method: 'published' },
173
187
  // โ€ฆ
174
188
  ],
175
189
  disclaimer: 'โ€ฆ'
@@ -223,7 +237,7 @@ curl "https://allratestoday.com/api/v1/central-bank/rbi/latest?format=xml&api_ke
223
237
  - 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`
224
238
  - Machine-readable site guide: [llms.txt](https://allratestoday.com/llms.txt) ยท [for-ai-agents](https://allratestoday.com/for-ai-agents/)
225
239
 
226
- ## โš–๏ธ Published vs derived rates
240
+ ## โš–๏ธ Official vs derived rates
227
241
 
228
242
  If Reserve Bank of India 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:
229
243
 
@@ -273,21 +287,21 @@ getRate('USD', 'INR', { apiKey: 'art_live_...' }).then((pair) => console.log(pai
273
287
 
274
288
  ## ๐Ÿ’ก Quota tips
275
289
 
276
- - Rates change once per business day โ€” cache the published table locally and a small monthly quota goes a long way.
290
+ - Rates change once per business day โ€” cache the official table locally and a small monthly quota goes a long way.
277
291
  - Every request counts toward your AllRatesToday quota, shared across all AllRatesToday endpoints on your key.
278
292
 
279
293
  ## ๐Ÿ“– Methods reference
280
294
 
281
295
  | Method | Plan | Description |
282
296
  | ------ | ---- | ----------- |
283
- | `getRate(source, target, { apiKey })` | Free | Latest rate for one pair, resolved from the published table |
284
- | `getLatestRates({ apiKey })` | Free | The central bank's full latest published table |
297
+ | `getRate(source, target, { apiKey })` | Free | Latest rate for one pair, resolved from the official table |
298
+ | `getLatestRates({ apiKey })` | Free | The central bank's full latest official table |
285
299
  | `getRatesForDate(date, { apiKey, source?, target? })` | Paid | The official table (or one pair) for a YYYY-MM-DD date |
286
300
  | `getHistory({ symbol \| source+target, from?, to? }, { apiKey })` | Paid | Daily series since 2003 |
287
301
 
288
302
  ## ๐Ÿ“ฅ Bulk data (no key)
289
303
 
290
- Need the whole archive rather than an API call? The same published tables are mirrored daily as open data:
304
+ Need the whole archive rather than an API call? The same official tables are mirrored daily as open data:
291
305
 
292
306
  - Hugging Face: [AllRatesToday/central-bank-exchange-rates](https://huggingface.co/datasets/AllRatesToday/central-bank-exchange-rates) โ€” one CSV per institution (`rates/rbi.csv`)
293
307
  - Kaggle: [allratestoday/central-bank-exchange-rates](https://www.kaggle.com/datasets/allratestoday/central-bank-exchange-rates)
@@ -297,7 +311,7 @@ Need the whole archive rather than an API call? The same published tables are mi
297
311
 
298
312
  - **Website:** [allratestoday.com](https://allratestoday.com)
299
313
  - [Reserve Bank of India rates page](https://allratestoday.com/central-bank-rates-api/rbi/) โ€” live table, publication cadence, FAQ
300
- - [All central bank sources](https://allratestoday.com/central-bank-rates-api/)
314
+ - [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
301
315
  - [Download central bank rates](https://allratestoday.com/download-central-bank-rates/) โ€” every bank's latest table and history as Excel, CSV or JSON
302
316
  - [Package docs on the site](https://allratestoday.com/docs/sdk/rbi-exchange-rate/) ยท [ERP integration guides](https://allratestoday.com/docs/integrations/)
303
317
  - [API documentation](https://allratestoday.com/docs/#central-bank) ยท [Interactive reference](https://allratestoday.com/api-reference/) ยท [Methodology](https://allratestoday.com/official-rates-methodology/)
@@ -305,6 +319,7 @@ Need the whole archive rather than an API call? The same published tables are mi
305
319
  - [Status](https://allratestoday.com/status)
306
320
  - [Postman collection](https://allratestoday.com/postman/)
307
321
  - [ChatGPT app](https://chatgpt.com/plugins/plugin_asdk_app_6ae1e76098f48191a285ac3f5ab7a83b) โ€” ask ChatGPT for live and official central bank rates
322
+ - [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)
308
323
  - [GitHub](https://github.com/AllRates-Today/rbi-exchange-rate)
309
324
 
310
325
  ## ๐Ÿ“œ License
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@allratestoday/rbi-exchange-rate",
3
- "version": "1.3.27",
3
+ "version": "1.3.30",
4
4
  "description": "Official Reserve Bank of India (India) daily exchange rates โ€” 6 currencies vs INR, history since 2003. Zero-dependency Node.js/TypeScript client.",
5
5
  "keywords": [
6
6
  "rbi",