@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.
- package/README.md +38 -23
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -4,16 +4,16 @@
|
|
|
4
4
|
[](https://github.com/AllRates-Today/rbi-exchange-rate/blob/main/LICENSE)
|
|
5
5
|
[](https://www.npmjs.com/package/@allratestoday/rbi-exchange-rate)
|
|
6
6
|
[](https://www.typescriptlang.org/)
|
|
7
|
-
[](https://allratestoday.com/central-bank-rates-api/rbi/)
|
|
8
8
|
[](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
|
|
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
|
-
- ๐ **
|
|
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
|
|
27
|
+
## ๐ Latest official table
|
|
28
28
|
|
|
29
29
|
[](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
|
-
|
|
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
|
|
65
|
-
- [Full
|
|
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 *
|
|
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-
|
|
99
|
+
rate_date: '2026-11-11', // Reserve Bank of India's own publication date
|
|
86
100
|
source: 'USD',
|
|
87
101
|
target: 'INR',
|
|
88
|
-
rate:
|
|
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
|
|
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-
|
|
127
|
+
rate_date: '2026-11-11',
|
|
114
128
|
rates: [
|
|
115
|
-
{ "base": "USD", "quote": "INR", "type": "reference", "value":
|
|
116
|
-
// โฆ the rest of the
|
|
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-
|
|
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-
|
|
182
|
+
to: '2026-11-11',
|
|
169
183
|
count: 152,
|
|
170
184
|
rates: [
|
|
171
185
|
// one entry per publication date
|
|
172
|
-
{ date: '2026-
|
|
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
|
-
## โ๏ธ
|
|
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
|
|
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
|
|
284
|
-
| `getLatestRates({ apiKey })` | Free | The central bank's full latest
|
|
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
|
|
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.
|
|
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",
|