A fast and flexible currency exchange package for handling multiple currencies.

Installation

Using npm:

1$ npm install exchain

Other Installations:

1$ yarn add exchain

1$ pnpm add exchain

Usage

1import exchain from 'exchain';
2
3(async () => {
4
5// Get Rates
6var getRates = await exchain.getRates({
7    amount: 2,
8    base: 'USD',
9    to: ['AUD', 'EUR', 'GBP', 'TRY'],
10    toFixed: 2
11});
12
13console.log(getRates);
14/*
15{
16  amount: 2,
17  base: 'USD',
18  date: '2024-10-22',
19  rates: { AUD: 2.99, EUR: 1.85, GBP: 1.54, TRY: 68.5 }
20}
21*/
22
23
24
25// Get Rates with date
26var getRatesWithDate = await exchain.getRates({
27    amount: 2,
28    base: 'USD',
29    to: ['AUD', 'EUR', 'GBP', 'TRY'],
30    startDate: '2024-10-15',
31    endDate: '2024-10-22',
32});
33
34console.log(getRatesWithDate);
35/*
36{
37  amount: 2,
38  base: 'USD',
39  start_date: '2024-10-15',
40  end_date: '2024-10-22',
41  rates: {
42    '2024-10-15': { AUD: 2.9783, EUR: 1.8344, GBP: 1.529, TRY: 68.516 },
43    '2024-10-16': { AUD: 2.99, EUR: 1.8354, GBP: 1.5345, TRY: 68.421 },
44    '2024-10-17': { AUD: 2.9869, EUR: 1.8406, GBP: 1.5361, TRY: 68.318 },
45    '2024-10-18': { AUD: 2.9805, EUR: 1.8438, GBP: 1.5334, TRY: 68.585 },
46    '2024-10-21': { AUD: 2.9909, EUR: 1.8428, GBP: 1.5353, TRY: 68.509 },
47    '2024-10-22': { AUD: 2.9899, EUR: 1.8483, GBP: 1.5403, TRY: 68.496 }
48  }
49}
50*/
51
52
53
54// Get Currencies
55var getCurrencies = await exchain.getCurrencies();
56
57console.log(getCurrencies);
58/*
59{
60  AUD: 'Australian Dollar',
61  BGN: 'Bulgarian Lev',
62  BRL: 'Brazilian Real',
63  CAD: 'Canadian Dollar',
64  CHF: 'Swiss Franc',
65  CNY: 'Chinese Renminbi Yuan',
66  CZK: 'Czech Koruna',
67  DKK: 'Danish Krone',
68  EUR: 'Euro',
69  GBP: 'British Pound',
70  HKD: 'Hong Kong Dollar',
71  HUF: 'Hungarian Forint',
72  IDR: 'Indonesian Rupiah',
73  ILS: 'Israeli New Sheqel',
74  INR: 'Indian Rupee',
75  ISK: 'Icelandic Króna',
76  JPY: 'Japanese Yen',
77  KRW: 'South Korean Won',
78  MXN: 'Mexican Peso',
79  MYR: 'Malaysian Ringgit',
80  NOK: 'Norwegian Krone',
81  NZD: 'New Zealand Dollar',
82  PHP: 'Philippine Peso',
83  PLN: 'Polish Złoty',
84  RON: 'Romanian Leu',
85  SEK: 'Swedish Krona',
86  SGD: 'Singapore Dollar',
87  THB: 'Thai Baht',
88  TRY: 'Turkish Lira',
89  USD: 'United States Dollar',
90  ZAR: 'South African Rand'
91}
92*/
93
94})();

License

exchain is licensed under the MIT License. See the LICENSE file for details.

Support