@allratestoday/rbi-exchange-rate 1.3.29 โ 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 +29 -29
- 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,7 +24,7 @@
|
|
|
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
|
|
|
@@ -32,16 +32,16 @@ The image is rendered live from the keyless endpoint, so it follows the central
|
|
|
32
32
|
|
|
33
33
|
<!-- daily-table:start -->
|
|
34
34
|
<details>
|
|
35
|
-
<summary>Table as text: published 2026-11-
|
|
35
|
+
<summary>Table as text: published 2026-11-11 by Reserve Bank of India โ 6 rates. Updated 2026-11-11.</summary>
|
|
36
36
|
|
|
37
37
|
| Base | Quote | Type | Rate |
|
|
38
38
|
| --- | --- | --- | ---: |
|
|
39
|
-
| AED | INR | reference | 25.
|
|
40
|
-
| EUR | INR | reference |
|
|
41
|
-
| GBP | INR | reference |
|
|
42
|
-
| IDR | INR | reference | 0.
|
|
43
|
-
| JPY | INR | reference | 0.
|
|
44
|
-
| USD | INR | reference |
|
|
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
45
|
|
|
46
46
|
</details>
|
|
47
47
|
|
|
@@ -75,8 +75,8 @@ console.log(pair.rate, pair.rate_date); // the official Reserve Bank of India ra
|
|
|
75
75
|
|
|
76
76
|
## ๐ API reference
|
|
77
77
|
|
|
78
|
-
- [Latest pair rate](#latest-pair-rate) โ one pair from the latest
|
|
79
|
-
- [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
|
|
80
80
|
- [Table for a date](#table-for-a-date) โ the official table for an invoice or filing date
|
|
81
81
|
- [Daily time series](#daily-time-series) โ one pair across a date range
|
|
82
82
|
|
|
@@ -84,7 +84,7 @@ console.log(pair.rate, pair.rate_date); // the official Reserve Bank of India ra
|
|
|
84
84
|
|
|
85
85
|
### Latest pair rate
|
|
86
86
|
|
|
87
|
-
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).
|
|
88
88
|
|
|
89
89
|
```js
|
|
90
90
|
const pair = await getRate('USD', 'INR', { apiKey: 'art_live_...' });
|
|
@@ -96,10 +96,10 @@ const pair = await getRate('USD', 'INR', { apiKey: 'art_live_...' });
|
|
|
96
96
|
{
|
|
97
97
|
bank: 'rbi',
|
|
98
98
|
name: 'Reserve Bank of India',
|
|
99
|
-
rate_date: '2026-
|
|
99
|
+
rate_date: '2026-11-11', // Reserve Bank of India's own publication date
|
|
100
100
|
source: 'USD',
|
|
101
101
|
target: 'INR',
|
|
102
|
-
rate:
|
|
102
|
+
rate: 93.8075,
|
|
103
103
|
rate_type: 'reference',
|
|
104
104
|
derived: false,
|
|
105
105
|
method: 'published',
|
|
@@ -107,7 +107,7 @@ const pair = await getRate('USD', 'INR', { apiKey: 'art_live_...' });
|
|
|
107
107
|
}
|
|
108
108
|
```
|
|
109
109
|
|
|
110
|
-
### Full
|
|
110
|
+
### Full official table
|
|
111
111
|
|
|
112
112
|
Free plan and up. The complete table for the latest publication date.
|
|
113
113
|
|
|
@@ -124,10 +124,10 @@ console.log(table.rate_date, table.rates.length);
|
|
|
124
124
|
{
|
|
125
125
|
bank: 'rbi',
|
|
126
126
|
name: 'Reserve Bank of India',
|
|
127
|
-
rate_date: '2026-
|
|
127
|
+
rate_date: '2026-11-11',
|
|
128
128
|
rates: [
|
|
129
|
-
{ "base": "USD", "quote": "INR", "type": "reference", "value":
|
|
130
|
-
// โฆ 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)
|
|
131
131
|
],
|
|
132
132
|
disclaimer: 'โฆ'
|
|
133
133
|
}
|
|
@@ -166,7 +166,7 @@ Paid plans. One resolved rate per publication date โ ready for charting, reval
|
|
|
166
166
|
import { getHistory } from '@allratestoday/rbi-exchange-rate';
|
|
167
167
|
|
|
168
168
|
const series = await getHistory(
|
|
169
|
-
{ source: 'USD', target: 'INR', from: '2026-01-01', to: '2026-
|
|
169
|
+
{ source: 'USD', target: 'INR', from: '2026-01-01', to: '2026-11-11' },
|
|
170
170
|
{ apiKey: 'art_live_...' }
|
|
171
171
|
);
|
|
172
172
|
```
|
|
@@ -179,11 +179,11 @@ const series = await getHistory(
|
|
|
179
179
|
source: 'USD',
|
|
180
180
|
target: 'INR',
|
|
181
181
|
from: '2026-01-01',
|
|
182
|
-
to: '2026-
|
|
182
|
+
to: '2026-11-11',
|
|
183
183
|
count: 152,
|
|
184
184
|
rates: [
|
|
185
185
|
// one entry per publication date
|
|
186
|
-
{ date: '2026-
|
|
186
|
+
{ date: '2026-11-11', rate: 93.8075, rate_type: 'reference', derived: false, method: 'published' },
|
|
187
187
|
// โฆ
|
|
188
188
|
],
|
|
189
189
|
disclaimer: 'โฆ'
|
|
@@ -237,7 +237,7 @@ curl "https://allratestoday.com/api/v1/central-bank/rbi/latest?format=xml&api_ke
|
|
|
237
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`
|
|
238
238
|
- Machine-readable site guide: [llms.txt](https://allratestoday.com/llms.txt) ยท [for-ai-agents](https://allratestoday.com/for-ai-agents/)
|
|
239
239
|
|
|
240
|
-
## โ๏ธ
|
|
240
|
+
## โ๏ธ Official vs derived rates
|
|
241
241
|
|
|
242
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:
|
|
243
243
|
|
|
@@ -287,21 +287,21 @@ getRate('USD', 'INR', { apiKey: 'art_live_...' }).then((pair) => console.log(pai
|
|
|
287
287
|
|
|
288
288
|
## ๐ก Quota tips
|
|
289
289
|
|
|
290
|
-
- 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.
|
|
291
291
|
- Every request counts toward your AllRatesToday quota, shared across all AllRatesToday endpoints on your key.
|
|
292
292
|
|
|
293
293
|
## ๐ Methods reference
|
|
294
294
|
|
|
295
295
|
| Method | Plan | Description |
|
|
296
296
|
| ------ | ---- | ----------- |
|
|
297
|
-
| `getRate(source, target, { apiKey })` | Free | Latest rate for one pair, resolved from the
|
|
298
|
-
| `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 |
|
|
299
299
|
| `getRatesForDate(date, { apiKey, source?, target? })` | Paid | The official table (or one pair) for a YYYY-MM-DD date |
|
|
300
300
|
| `getHistory({ symbol \| source+target, from?, to? }, { apiKey })` | Paid | Daily series since 2003 |
|
|
301
301
|
|
|
302
302
|
## ๐ฅ Bulk data (no key)
|
|
303
303
|
|
|
304
|
-
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:
|
|
305
305
|
|
|
306
306
|
- Hugging Face: [AllRatesToday/central-bank-exchange-rates](https://huggingface.co/datasets/AllRatesToday/central-bank-exchange-rates) โ one CSV per institution (`rates/rbi.csv`)
|
|
307
307
|
- Kaggle: [allratestoday/central-bank-exchange-rates](https://www.kaggle.com/datasets/allratestoday/central-bank-exchange-rates)
|
|
@@ -311,7 +311,7 @@ Need the whole archive rather than an API call? The same published tables are mi
|
|
|
311
311
|
|
|
312
312
|
- **Website:** [allratestoday.com](https://allratestoday.com)
|
|
313
313
|
- [Reserve Bank of India rates page](https://allratestoday.com/central-bank-rates-api/rbi/) โ live table, publication cadence, FAQ
|
|
314
|
-
- [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
|
|
315
315
|
- [Download central bank rates](https://allratestoday.com/download-central-bank-rates/) โ every bank's latest table and history as Excel, CSV or JSON
|
|
316
316
|
- [Package docs on the site](https://allratestoday.com/docs/sdk/rbi-exchange-rate/) ยท [ERP integration guides](https://allratestoday.com/docs/integrations/)
|
|
317
317
|
- [API documentation](https://allratestoday.com/docs/#central-bank) ยท [Interactive reference](https://allratestoday.com/api-reference/) ยท [Methodology](https://allratestoday.com/official-rates-methodology/)
|
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",
|