money-rates

money.js with the rates built in. Same API as money.js (fx(100).from('USD').to('GBP'), fx.convert, fx.rates, fx.base, fx.settings), plus fx.load(), which fetches a rate table for you.

• No key needed: the European Central Bank reference table (about 30 currencies, any base, updated each business day).
• With a free key: real-time mid-market rates for 160+ currencies from AllRatesToday.
• Zero dependencies, about 150 lines, CommonJS + ESM + TypeScript types.

money.js was last released in 2014 and never shipped rates. You load them yourself, usually from a paid feed. This package does that step for you.

Install

npm install money-rates

Use

const fx = require('money-rates');   // or: import fx from 'money-rates'

await fx.load();                      // keyless ECB table, base USD

fx(100).from('USD').to('GBP');        // 74.92
fx.convert(1, { from: 'EUR', to: 'JPY' });
fx.convert([10, 20], { from: 'USD', to: 'EUR' });

fx.settings = { from: 'USD', to: 'EUR' };
fx.convert(50);

console.log(fx.base, fx.date, fx.source);   // "USD" "2026-10-26" "ecb"

Real-time mid-market rates for 160+ currencies with a key (get a free one):

await fx.load({ apiKey: process.env.ALLRATESTODAY_API_KEY });  // or just set the env var
fx(100).from('USD').to('NGN');

Already using money.js?

Keep it. Fill its rates with one call:

const money = require('money');
const { loadInto } = require('money-rates');

await loadInto(money);                // keyless ECB rates
money(100).from('USD').to('EUR');

Or swap the import: require('money') to require('money-rates'), then add await fx.load() where you used to set fx.rates by hand. Step-by-step guide: allratestoday.com/migrate/money-js/.

API

fx(value).from(a).to(b)	Convert, money.js style
fx.convert(value, { from, to })	Convert a number or an array of numbers
fx.rates, fx.base, fx.settings	Same as money.js; set them by hand if you like
fx.load({ base, apiKey, fetch })	Fetch a table into fx. Resolves to fx
fx.loadInto(money, opts)	Fetch a table into an existing money.js object
fx.fetchRates(opts)	Return { base, date, rates, source } without changing state
fx.date, fx.source	Table date and "ecb" or "mid-market"
fx.attribution, fx.attributionHtml	Link text for keyless use

Cross rates (EUR to JPY on a USD table) are computed exactly as money.js does. A missing currency throws fx error.

Attribution (keyless use)

Without a key, the rates are free for any use, commercial included. Where you show them, add a visible link:

<a href="https://allratestoday.com">Exchange rates by AllRatesToday</a>

fx.attributionHtml holds that snippet. See the terms.

Links

• Migrating from money.js
• Keyless open API
• Exchange rate API
• JavaScript SDK @allratestoday/sdk
• ChatGPT app — ask ChatGPT for live and official central bank rates
• OpenAPI reference on Bump.sh — also on SwaggerHub

money.js is © Open Exchange Rates, MIT. This package is an independent reimplementation of its API and is not affiliated with it.

License

MIT