money.js / fx()

July 16, 2014 ยท View on GitHub

Simple and tiny JavaScript library for realtime currency conversion and exchange rate calculation, from any currency, to any currency.

money.js is lightweight, has no dependencies, and works great client-side or server-side. Use standalone or as a nodeJS/npm and AMD/requireJS module.

Designed for seamless integration with the Open Exchange Rates API, but can be integrated with any source of currency data or with static/cached/approximate exchange rates.

Visit the plugin homepage for demos and documentation: http://openexchangerates.github.io/money.js/

Quick Examples:

// Simple syntax:
fx.convert(1000, {from: "GBP", to: "HKD"});

// Method chaining:
fx(1.99).from("USD").to("AED");

// Basic parsing:
fx("\$1.99 HKD").to("EUR");

// Default parameters:
fx(5318008).convert();

// Supports nodeJS / AMD:
var fx = require('money');
require(["money"], function(fx) { /* ... */ });

Changelog

0.2

  • Now maintained by Open Exchange Rates
  • Improved documentation

0.1.3 - Fixed typo in nodeJS module definition

0.1.2 - Strengthened up module definition similar to accounting.js

0.1.1 - Added fallback when base rate is not in rates object (e.g. "USD": 1) to avoid errors

0.1.0 - Added license; bumped version

0.0.2

  • Adds basic parsing to fx(), so that you can pass a formatted string, like so: fx("\$1.99 HKD").to("GBP")
  • Some cleanup and improved comments and docs

0.0.1 - First release