@allratestoday/sdk 1.4.4 → 1.5.0

package/dist/index.d.mts

@@ -19,13 +19,21 @@ interface RateResponse {
         currency: string;
         amount: number;
     };
+    /** Units of `to` per 1 unit of `from`. */
     rate: number;
+    /** Rate type label, e.g. `interbank` (live mid-market). */
     source: string;
+    /** Rate timestamp (ISO 8601, UTC) when the API returns one. */
+    time?: string;
 }
 interface AuthRateResponse {
+    /** Units of `target` per 1 unit of `source`. */
     rate: number;
+    /** Base currency code. */
     source: string;
+    /** Quote currency code. */
     target: string;
+    /** Rate timestamp (ISO 8601, UTC). */
     time: string;
 }
 interface LatestOptions extends RequestOptions {
@@ -36,19 +44,24 @@ interface LatestOptions extends RequestOptions {
 }
 interface LatestResponse {
     base: string;
+    /** Timestamp of the rates (ISO 8601, UTC). */
     date: string;
+    /** Units of each currency per 1 unit of `base`. */
     rates: Record<string, number>;
 }
 interface ForDateOptions extends RequestOptions {
     /** Base currency code. Default: `USD` */
     base?: string;
-    /** Array of target currency codes. */
-    symbols?: string[];
+    /** Target currency codes (required). Each symbol is one history request. */
+    symbols: string[];
 }
 interface ForDateResponse {
     base: string;
+    /** The date you asked for (YYYY-MM-DD). */
     date: string;
     rates: Record<string, number>;
+    /** Date of the data point actually used per currency. Equal to `date` unless no point exists for that day (then the closest earlier one). */
+    rateDates: Record<string, string>;
 }
 interface ConvertOptions extends RequestOptions {
     /** Historical date for conversion (YYYY-MM-DD or Date object). */
@@ -60,13 +73,16 @@ interface ConvertResponse {
     amount: number;
     result: number;
     rate: number;
+    /** Requested date, for historical conversions. */
     date?: string;
+    /** Date of the data point actually used, for historical conversions. */
+    rateDate?: string;
 }
 interface TimeSeriesOptions extends RequestOptions {
     /** Base currency code. Default: `USD` */
     base?: string;
-    /** Array of target currency codes. */
-    symbols?: string[];
+    /** Target currency codes (required). Each symbol is one history request. */
+    symbols: string[];
 }
 interface TimeSeriesResponse {
     base: string;
@@ -74,21 +90,42 @@ interface TimeSeriesResponse {
     endDate: string;
     rates: Record<string, Record<string, number>>;
 }
+type HistoryPeriod = '1d' | '7d' | '30d' | '1y';
+interface HistoryPoint {
+    /** `YYYY-MM-DD` for daily/weekly points, full ISO timestamp for hourly (`1d`) points. */
+    date: string;
+    rate: number;
+    /** Unix time in milliseconds. */
+    timestamp: number;
+}
 interface HistoricalRateResponse {
     source: string;
     target: string;
     period: string;
+    /** Most recent point in the series. */
     current: {
         rate: number;
         time: string;
     };
+    /** Points oldest first. `time` is the point's date (or timestamp for `1d`). */
     rates: Array<{
         rate: number;
         time: string;
     }>;
+    /** Raw points as the API returns them. */
+    data: HistoryPoint[];
+}
+interface CurrencyInfo {
+    code: string;
+    name: string;
+    symbol: string;
 }
 interface SymbolsResponse {
+    /** Code → name, e.g. `{ USD: 'US Dollar' }`. */
     symbols: Record<string, string>;
+    /** Full list with display symbols. */
+    currencies: CurrencyInfo[];
+    count: number;
 }
 interface OfficialRateOptions extends RequestOptions {
     /** Base currency of the pair, e.g. `USD`. Give together with `target` to narrow to one pair. */
@@ -120,14 +157,33 @@ interface OfficialRatesResponse {
     target?: string;
     rate?: number;
     rate_type?: string;
-    /** True when the pair was cross-computed inside the bank's own table rather than published directly. */
+    /** True when the pair is not published as-is: the inverse of a published rate (keyless), or a cross via the bank's base (`officialRatesOn`). */
     derived?: boolean;
-    method?: 'published' | 'inverse';
+    method?: 'published' | 'inverse' | 'cross';
     /** True when the institution is behind its own publication schedule. */
     stale?: boolean;
     attribution: OfficialRateAttribution;
     free_key: string;
 }
+interface DatedOfficialRatesResponse {
+    bank: string;
+    /** Institution name, e.g. `European Central Bank`. */
+    name: string;
+    /** The date you asked for (YYYY-MM-DD). */
+    requested_date: string;
+    /** Publication date of the table actually returned. Earlier than `requested_date` on weekends/holidays. */
+    rate_date: string;
+    published_on_requested_date: boolean;
+    /** Full published table. Present when no pair was requested. */
+    rates?: OfficialRateEntry[];
+    source?: string;
+    target?: string;
+    rate?: number;
+    rate_type?: string;
+    derived?: boolean;
+    method?: 'published' | 'inverse' | 'cross';
+    disclaimer?: string;
+}
 interface OfficialSource {
     /** Pass this as `bank` to `officialRates()`. */
     code: string;
@@ -144,10 +200,17 @@ interface OfficialSourcesResponse {
     docs: string;
     free_key: string;
 }
+type AllRatesTodayErrorCode = 'missing_key' | 'invalid_argument' | 'http' | 'timeout' | 'network';
 declare class AllRatesTodayError extends Error {
-    /** HTTP status code (when available). */
+    /** HTTP status code, for `code: 'http'` errors. */
     status?: number;
-    constructor(message: string, status?: number);
+    /** What went wrong: `missing_key`, `invalid_argument`, `http`, `timeout` or `network`. */
+    code: AllRatesTodayErrorCode;
+    /** Parsed JSON error body from the API, e.g. `{ error, used, limit, plan, resets_at }` on 429. */
+    details?: Record<string, unknown>;
+    constructor(message: string, status?: number, code?: AllRatesTodayErrorCode, details?: Record<string, unknown>, options?: {
+        cause?: unknown;
+    });
 }
 declare class AllRatesToday {
     private apiKey?;
@@ -166,6 +229,16 @@ declare class AllRatesToday {
     private resolveKey;
     private request;
     private formatDate;
+    private requireSymbols;
+    /**
+     * Smallest history window that reaches back to `start`. Market history is
+     * served as windows ending today (7 days, 30 days, 1 year), so older dates
+     * are not available from the market-rate API.
+     */
+    private windowFor;
+    private history;
+    /** Last point on or before `date` (YYYY-MM-DD). */
+    private pointOn;
     /**
      * Get the latest exchange rates.
      *
@@ -179,36 +252,34 @@ declare class AllRatesToday {
      */
     latest(options?: LatestOptions): Promise<LatestResponse>;
     /**
-     * Get exchange rates for a specific historical date.
-     *
-     * ```ts
-     * // Using a string
-     * const data = await client.forDate('2026-01-15');
+     * Get mid-market rates for a past date within the last 365 days.
      *
-     * // Using a Date object
-     * const data = await client.forDate(new Date('2026-01-15'));
+     * One history request per symbol. Billed per request by window: dates up to
+     * 29 days ago cost 1 call per symbol, older dates (up to 1 year) cost 12,
+     * because the 1-year window is weekly points. If a day has no point, the
+     * closest earlier one is used and reported in `rateDates`.
      *
-     * // With options
-     * const data = await client.forDate('2026-01-15', { base: 'EUR', symbols: ['USD', 'GBP'] });
+     * ```ts
+     * const data = await client.forDate('2026-10-01', { base: 'USD', symbols: ['EUR', 'GBP'] });
+     * // { base: 'USD', date: '2026-10-01', rates: { EUR: 0.85, GBP: 0.74 }, rateDates: { ... } }
      * ```
      */
-    forDate(date: string | Date, options?: ForDateOptions): Promise<ForDateResponse>;
+    forDate(date: string | Date, options: ForDateOptions): Promise<ForDateResponse>;
     /**
-     * Get exchange rate time series between two dates.
+     * Daily mid-market rates between two dates within the last 365 days.
      *
-     * ```ts
-     * const data = await client.timeSeries('2026-01-01', '2026-03-31', {
-     *   base: 'USD',
-     *   symbols: ['EUR', 'GBP'],
-     * });
+     * One history request per symbol. Ranges starting up to 29 days ago return
+     * daily points (1 call per symbol); older starts use the 1-year window,
+     * which has weekly points and costs 12 calls per symbol.
      *
-     * // Access rates by date
-     * console.log(data.rates['2026-01-15']); // { EUR: 0.92, GBP: 0.78 }
+     * ```ts
+     * const data = await client.timeSeries('2026-10-01', '2026-10-10', { symbols: ['EUR', 'GBP'] });
+     * console.log(data.rates['2026-10-05']); // { EUR: 0.86, GBP: 0.75 }
      * ```
      */
-    timeSeries(startDate: string | Date, endDate: string | Date, options?: TimeSeriesOptions): Promise<TimeSeriesResponse>;
+    timeSeries(startDate: string | Date, endDate: string | Date, options: TimeSeriesOptions): Promise<TimeSeriesResponse>;
     /**
-     * Get all supported currency symbols.
+     * Get all supported currency codes and names. **No API key needed.**
      *
      * ```ts
      * const { symbols } = await client.symbols();
@@ -231,14 +302,27 @@ declare class AllRatesToday {
      * const table = await client.officialRates('ecb');
      * console.log(table.rate_date, table.rates);
      *
-     * // One pair — cross-computed inside the bank's table when not published directly
+     * // One pair — published as-is or the inverse of a published rate (`derived: true`)
      * const usd = await client.officialRates('ecb', { source: 'EUR', target: 'USD' });
      * console.log(`ECB ${usd.rate_date}: 1 EUR = ${usd.rate} USD`);
      * ```
      *
-     * Dated tables and history need a free key: see `/api/v1/central-bank/{bank}/{date}`.
+     * Cross pairs and past dates need a key: use `officialRatesOn()`.
      */
     officialRates(bank: string, options?: OfficialRateOptions): Promise<OfficialRatesResponse>;
+    /**
+     * Official table (or one pair) as published on a given date. Needs an API
+     * key; 1 call. On weekends and holidays the last earlier publication is
+     * returned (`published_on_requested_date: false`). Unlike the keyless
+     * `officialRates()`, any pair inside the table can be cross-computed
+     * (`method: 'cross'`), e.g. USD/GBP from the ECB's EUR table.
+     *
+     * ```ts
+     * const r = await client.officialRatesOn('rbi', '2026-09-30', { source: 'USD', target: 'INR' });
+     * console.log(r.rate_date, r.rate); // 2026-09-30 95.9832
+     * ```
+     */
+    officialRatesOn(bank: string, date: string | Date, options?: OfficialRateOptions): Promise<DatedOfficialRatesResponse>;
     /**
      * Every covered official source with its code, name, latest publication
      * date and whether it is behind schedule. **No API key needed.**
@@ -272,7 +356,8 @@ declare class AllRatesToday {
      */
     getRates(source: string, target: string, options?: RequestOptions): Promise<AuthRateResponse[]>;
     /**
-     * Get historical rates by period.
+     * Mid-market history for a preset window ending today: `1d` (hourly),
+     * `7d` / `30d` (daily) or `1y` (weekly). `1y` is billed as 12 calls.
      *
      * ```ts
      * const history = await client.getHistoricalRates('USD', 'EUR', '30d');
@@ -281,7 +366,7 @@ declare class AllRatesToday {
      * });
      * ```
      */
-    getHistoricalRates(source: string, target: string, period?: '1d' | '7d' | '30d' | '1y', options?: RequestOptions): Promise<HistoricalRateResponse>;
+    getHistoricalRates(source: string, target: string, period?: HistoryPeriod, options?: RequestOptions): Promise<HistoricalRateResponse>;
     /**
      * Convert an amount between two currencies.
      *
@@ -298,4 +383,4 @@ declare class AllRatesToday {
     convert(from: string, to: string, amount: number, options?: ConvertOptions): Promise<ConvertResponse>;
 }
 
-export { AllRatesToday, AllRatesTodayError, type AllRatesTodayOptions, type AuthRateResponse, type ConvertOptions, type ConvertResponse, type ForDateOptions, type ForDateResponse, type HistoricalRateResponse, type LatestOptions, type LatestResponse, type OfficialRateAttribution, type OfficialRateEntry, type OfficialRateOptions, type OfficialRatesResponse, type OfficialSource, type OfficialSourcesResponse, type RateResponse, type RequestOptions, type SymbolsResponse, type TimeSeriesOptions, type TimeSeriesResponse, AllRatesToday as default };
+export { AllRatesToday, AllRatesTodayError, type AllRatesTodayErrorCode, type AllRatesTodayOptions, type AuthRateResponse, type ConvertOptions, type ConvertResponse, type CurrencyInfo, type DatedOfficialRatesResponse, type ForDateOptions, type ForDateResponse, type HistoricalRateResponse, type HistoryPeriod, type HistoryPoint, type LatestOptions, type LatestResponse, type OfficialRateAttribution, type OfficialRateEntry, type OfficialRateOptions, type OfficialRatesResponse, type OfficialSource, type OfficialSourcesResponse, type RateResponse, type RequestOptions, type SymbolsResponse, type TimeSeriesOptions, type TimeSeriesResponse, AllRatesToday as default };

package/dist/index.d.ts

@@ -19,13 +19,21 @@ interface RateResponse {
         currency: string;
         amount: number;
     };
+    /** Units of `to` per 1 unit of `from`. */
     rate: number;
+    /** Rate type label, e.g. `interbank` (live mid-market). */
     source: string;
+    /** Rate timestamp (ISO 8601, UTC) when the API returns one. */
+    time?: string;
 }
 interface AuthRateResponse {
+    /** Units of `target` per 1 unit of `source`. */
     rate: number;
+    /** Base currency code. */
     source: string;
+    /** Quote currency code. */
     target: string;
+    /** Rate timestamp (ISO 8601, UTC). */
     time: string;
 }
 interface LatestOptions extends RequestOptions {
@@ -36,19 +44,24 @@ interface LatestOptions extends RequestOptions {
 }
 interface LatestResponse {
     base: string;
+    /** Timestamp of the rates (ISO 8601, UTC). */
     date: string;
+    /** Units of each currency per 1 unit of `base`. */
     rates: Record<string, number>;
 }
 interface ForDateOptions extends RequestOptions {
     /** Base currency code. Default: `USD` */
     base?: string;
-    /** Array of target currency codes. */
-    symbols?: string[];
+    /** Target currency codes (required). Each symbol is one history request. */
+    symbols: string[];
 }
 interface ForDateResponse {
     base: string;
+    /** The date you asked for (YYYY-MM-DD). */
     date: string;
     rates: Record<string, number>;
+    /** Date of the data point actually used per currency. Equal to `date` unless no point exists for that day (then the closest earlier one). */
+    rateDates: Record<string, string>;
 }
 interface ConvertOptions extends RequestOptions {
     /** Historical date for conversion (YYYY-MM-DD or Date object). */
@@ -60,13 +73,16 @@ interface ConvertResponse {
     amount: number;
     result: number;
     rate: number;
+    /** Requested date, for historical conversions. */
     date?: string;
+    /** Date of the data point actually used, for historical conversions. */
+    rateDate?: string;
 }
 interface TimeSeriesOptions extends RequestOptions {
     /** Base currency code. Default: `USD` */
     base?: string;
-    /** Array of target currency codes. */
-    symbols?: string[];
+    /** Target currency codes (required). Each symbol is one history request. */
+    symbols: string[];
 }
 interface TimeSeriesResponse {
     base: string;
@@ -74,21 +90,42 @@ interface TimeSeriesResponse {
     endDate: string;
     rates: Record<string, Record<string, number>>;
 }
+type HistoryPeriod = '1d' | '7d' | '30d' | '1y';
+interface HistoryPoint {
+    /** `YYYY-MM-DD` for daily/weekly points, full ISO timestamp for hourly (`1d`) points. */
+    date: string;
+    rate: number;
+    /** Unix time in milliseconds. */
+    timestamp: number;
+}
 interface HistoricalRateResponse {
     source: string;
     target: string;
     period: string;
+    /** Most recent point in the series. */
     current: {
         rate: number;
         time: string;
     };
+    /** Points oldest first. `time` is the point's date (or timestamp for `1d`). */
     rates: Array<{
         rate: number;
         time: string;
     }>;
+    /** Raw points as the API returns them. */
+    data: HistoryPoint[];
+}
+interface CurrencyInfo {
+    code: string;
+    name: string;
+    symbol: string;
 }
 interface SymbolsResponse {
+    /** Code → name, e.g. `{ USD: 'US Dollar' }`. */
     symbols: Record<string, string>;
+    /** Full list with display symbols. */
+    currencies: CurrencyInfo[];
+    count: number;
 }
 interface OfficialRateOptions extends RequestOptions {
     /** Base currency of the pair, e.g. `USD`. Give together with `target` to narrow to one pair. */
@@ -120,14 +157,33 @@ interface OfficialRatesResponse {
     target?: string;
     rate?: number;
     rate_type?: string;
-    /** True when the pair was cross-computed inside the bank's own table rather than published directly. */
+    /** True when the pair is not published as-is: the inverse of a published rate (keyless), or a cross via the bank's base (`officialRatesOn`). */
     derived?: boolean;
-    method?: 'published' | 'inverse';
+    method?: 'published' | 'inverse' | 'cross';
     /** True when the institution is behind its own publication schedule. */
     stale?: boolean;
     attribution: OfficialRateAttribution;
     free_key: string;
 }
+interface DatedOfficialRatesResponse {
+    bank: string;
+    /** Institution name, e.g. `European Central Bank`. */
+    name: string;
+    /** The date you asked for (YYYY-MM-DD). */
+    requested_date: string;
+    /** Publication date of the table actually returned. Earlier than `requested_date` on weekends/holidays. */
+    rate_date: string;
+    published_on_requested_date: boolean;
+    /** Full published table. Present when no pair was requested. */
+    rates?: OfficialRateEntry[];
+    source?: string;
+    target?: string;
+    rate?: number;
+    rate_type?: string;
+    derived?: boolean;
+    method?: 'published' | 'inverse' | 'cross';
+    disclaimer?: string;
+}
 interface OfficialSource {
     /** Pass this as `bank` to `officialRates()`. */
     code: string;
@@ -144,10 +200,17 @@ interface OfficialSourcesResponse {
     docs: string;
     free_key: string;
 }
+type AllRatesTodayErrorCode = 'missing_key' | 'invalid_argument' | 'http' | 'timeout' | 'network';
 declare class AllRatesTodayError extends Error {
-    /** HTTP status code (when available). */
+    /** HTTP status code, for `code: 'http'` errors. */
     status?: number;
-    constructor(message: string, status?: number);
+    /** What went wrong: `missing_key`, `invalid_argument`, `http`, `timeout` or `network`. */
+    code: AllRatesTodayErrorCode;
+    /** Parsed JSON error body from the API, e.g. `{ error, used, limit, plan, resets_at }` on 429. */
+    details?: Record<string, unknown>;
+    constructor(message: string, status?: number, code?: AllRatesTodayErrorCode, details?: Record<string, unknown>, options?: {
+        cause?: unknown;
+    });
 }
 declare class AllRatesToday {
     private apiKey?;
@@ -166,6 +229,16 @@ declare class AllRatesToday {
     private resolveKey;
     private request;
     private formatDate;
+    private requireSymbols;
+    /**
+     * Smallest history window that reaches back to `start`. Market history is
+     * served as windows ending today (7 days, 30 days, 1 year), so older dates
+     * are not available from the market-rate API.
+     */
+    private windowFor;
+    private history;
+    /** Last point on or before `date` (YYYY-MM-DD). */
+    private pointOn;
     /**
      * Get the latest exchange rates.
      *
@@ -179,36 +252,34 @@ declare class AllRatesToday {
      */
     latest(options?: LatestOptions): Promise<LatestResponse>;
     /**
-     * Get exchange rates for a specific historical date.
-     *
-     * ```ts
-     * // Using a string
-     * const data = await client.forDate('2026-01-15');
+     * Get mid-market rates for a past date within the last 365 days.
      *
-     * // Using a Date object
-     * const data = await client.forDate(new Date('2026-01-15'));
+     * One history request per symbol. Billed per request by window: dates up to
+     * 29 days ago cost 1 call per symbol, older dates (up to 1 year) cost 12,
+     * because the 1-year window is weekly points. If a day has no point, the
+     * closest earlier one is used and reported in `rateDates`.
      *
-     * // With options
-     * const data = await client.forDate('2026-01-15', { base: 'EUR', symbols: ['USD', 'GBP'] });
+     * ```ts
+     * const data = await client.forDate('2026-10-01', { base: 'USD', symbols: ['EUR', 'GBP'] });
+     * // { base: 'USD', date: '2026-10-01', rates: { EUR: 0.85, GBP: 0.74 }, rateDates: { ... } }
      * ```
      */
-    forDate(date: string | Date, options?: ForDateOptions): Promise<ForDateResponse>;
+    forDate(date: string | Date, options: ForDateOptions): Promise<ForDateResponse>;
     /**
-     * Get exchange rate time series between two dates.
+     * Daily mid-market rates between two dates within the last 365 days.
      *
-     * ```ts
-     * const data = await client.timeSeries('2026-01-01', '2026-03-31', {
-     *   base: 'USD',
-     *   symbols: ['EUR', 'GBP'],
-     * });
+     * One history request per symbol. Ranges starting up to 29 days ago return
+     * daily points (1 call per symbol); older starts use the 1-year window,
+     * which has weekly points and costs 12 calls per symbol.
      *
-     * // Access rates by date
-     * console.log(data.rates['2026-01-15']); // { EUR: 0.92, GBP: 0.78 }
+     * ```ts
+     * const data = await client.timeSeries('2026-10-01', '2026-10-10', { symbols: ['EUR', 'GBP'] });
+     * console.log(data.rates['2026-10-05']); // { EUR: 0.86, GBP: 0.75 }
      * ```
      */
-    timeSeries(startDate: string | Date, endDate: string | Date, options?: TimeSeriesOptions): Promise<TimeSeriesResponse>;
+    timeSeries(startDate: string | Date, endDate: string | Date, options: TimeSeriesOptions): Promise<TimeSeriesResponse>;
     /**
-     * Get all supported currency symbols.
+     * Get all supported currency codes and names. **No API key needed.**
      *
      * ```ts
      * const { symbols } = await client.symbols();
@@ -231,14 +302,27 @@ declare class AllRatesToday {
      * const table = await client.officialRates('ecb');
      * console.log(table.rate_date, table.rates);
      *
-     * // One pair — cross-computed inside the bank's table when not published directly
+     * // One pair — published as-is or the inverse of a published rate (`derived: true`)
      * const usd = await client.officialRates('ecb', { source: 'EUR', target: 'USD' });
      * console.log(`ECB ${usd.rate_date}: 1 EUR = ${usd.rate} USD`);
      * ```
      *
-     * Dated tables and history need a free key: see `/api/v1/central-bank/{bank}/{date}`.
+     * Cross pairs and past dates need a key: use `officialRatesOn()`.
      */
     officialRates(bank: string, options?: OfficialRateOptions): Promise<OfficialRatesResponse>;
+    /**
+     * Official table (or one pair) as published on a given date. Needs an API
+     * key; 1 call. On weekends and holidays the last earlier publication is
+     * returned (`published_on_requested_date: false`). Unlike the keyless
+     * `officialRates()`, any pair inside the table can be cross-computed
+     * (`method: 'cross'`), e.g. USD/GBP from the ECB's EUR table.
+     *
+     * ```ts
+     * const r = await client.officialRatesOn('rbi', '2026-09-30', { source: 'USD', target: 'INR' });
+     * console.log(r.rate_date, r.rate); // 2026-09-30 95.9832
+     * ```
+     */
+    officialRatesOn(bank: string, date: string | Date, options?: OfficialRateOptions): Promise<DatedOfficialRatesResponse>;
     /**
      * Every covered official source with its code, name, latest publication
      * date and whether it is behind schedule. **No API key needed.**
@@ -272,7 +356,8 @@ declare class AllRatesToday {
      */
     getRates(source: string, target: string, options?: RequestOptions): Promise<AuthRateResponse[]>;
     /**
-     * Get historical rates by period.
+     * Mid-market history for a preset window ending today: `1d` (hourly),
+     * `7d` / `30d` (daily) or `1y` (weekly). `1y` is billed as 12 calls.
      *
      * ```ts
      * const history = await client.getHistoricalRates('USD', 'EUR', '30d');
@@ -281,7 +366,7 @@ declare class AllRatesToday {
      * });
      * ```
      */
-    getHistoricalRates(source: string, target: string, period?: '1d' | '7d' | '30d' | '1y', options?: RequestOptions): Promise<HistoricalRateResponse>;
+    getHistoricalRates(source: string, target: string, period?: HistoryPeriod, options?: RequestOptions): Promise<HistoricalRateResponse>;
     /**
      * Convert an amount between two currencies.
      *
@@ -298,4 +383,4 @@ declare class AllRatesToday {
     convert(from: string, to: string, amount: number, options?: ConvertOptions): Promise<ConvertResponse>;
 }
 
-export { AllRatesToday, AllRatesTodayError, type AllRatesTodayOptions, type AuthRateResponse, type ConvertOptions, type ConvertResponse, type ForDateOptions, type ForDateResponse, type HistoricalRateResponse, type LatestOptions, type LatestResponse, type OfficialRateAttribution, type OfficialRateEntry, type OfficialRateOptions, type OfficialRatesResponse, type OfficialSource, type OfficialSourcesResponse, type RateResponse, type RequestOptions, type SymbolsResponse, type TimeSeriesOptions, type TimeSeriesResponse, AllRatesToday as default };
+export { AllRatesToday, AllRatesTodayError, type AllRatesTodayErrorCode, type AllRatesTodayOptions, type AuthRateResponse, type ConvertOptions, type ConvertResponse, type CurrencyInfo, type DatedOfficialRatesResponse, type ForDateOptions, type ForDateResponse, type HistoricalRateResponse, type HistoryPeriod, type HistoryPoint, type LatestOptions, type LatestResponse, type OfficialRateAttribution, type OfficialRateEntry, type OfficialRateOptions, type OfficialRatesResponse, type OfficialSource, type OfficialSourcesResponse, type RateResponse, type RequestOptions, type SymbolsResponse, type TimeSeriesOptions, type TimeSeriesResponse, AllRatesToday as default };