@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.
Files changed (2) hide show
  1. package/README.md +29 -29
  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,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 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
 
@@ -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-06 by Reserve Bank of India โ€” 6 rates. Updated 2026-11-08.</summary>
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.6313 |
40
- | EUR | INR | reference | 105.3758 |
41
- | GBP | INR | reference | 126.387 |
42
- | IDR | INR | reference | 0.0051902 |
43
- | JPY | INR | reference | 0.5962 |
44
- | USD | INR | reference | 94.1402 |
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 published table
79
- - [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
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 *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).
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-10-14', // Reserve Bank of India's own publication date
99
+ rate_date: '2026-11-11', // Reserve Bank of India's own publication date
100
100
  source: 'USD',
101
101
  target: 'INR',
102
- rate: 95.0317,
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 published table
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-10-14',
127
+ rate_date: '2026-11-11',
128
128
  rates: [
129
- { "base": "USD", "quote": "INR", "type": "reference", "value": 95.0317 },
130
- // โ€ฆ 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)
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-10-14' },
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-10-14',
182
+ to: '2026-11-11',
183
183
  count: 152,
184
184
  rates: [
185
185
  // one entry per publication date
186
- { 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' },
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
- ## โš–๏ธ Published vs derived rates
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 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.
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 published table |
298
- | `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 |
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 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:
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.29",
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",