Forex
Current and historical foreign exchange rates
Installation
npm
npm install forex-promise
yarn
Usage
Import module
const forex = require("forex-promise");
Latest
params
base: string | optional
symbols: string, array | optional
forex.latest();
forex.latest(base: "BRL")
forex.latest(base: "BRL", symbols: "JPY,BRL,NOK" || ["JPY","BRL","NOK"] )
Response
{
"base": "BRL",
"date": "2019-03-20",
"rates": [
{ "currency": "JPY", "price": 29.440621222 },
{ "currency": "BRL", "price": 1 },
{ "currency": "NOK", "price": 2.253208407 },
{ "currency": "DKK", "price": 1.7349576862 },
{ "currency": "CNY", "price": 1.767274249 } ],
...
}
Date
forex.date("2019-01-01");
Response
{
"base": "BRL",
"date": "2019-01-01",
"rates": [
{ "currency": "JPY", "price": 29.440621222 },
{ "currency": "BRL", "price": 1 },
{ "currency": "NOK", "price": 2.253208407 },
{ "currency": "DKK", "price": 1.7349576862 },
{ "currency": "CNY", "price": 1.767274249 } ],
...
}
History
params
dates: object | mandatory
base: string | optional
symbols: string, array | optional
forex.history({ start: "2018-01-01", end: "2018-09-01" });
forex.history({ start: "2018-01-01", end: "2018-09-01" }, base: "BRL");
forex.history({ start: "2018-01-01", end: "2018-09-01" }, base: "BRL", symbols: "JPY,BRL,NOK" || ["JPY","BRL","NOK"] );
Response
{
"end_at": "2018-01-03",
"base": "USD",
"start_at": "2018-01-01",
"rates": [
{
"date": "2018-01-02",
"data": [
{ "currency": "JPY", "price": 29.440621222 },
{ "currency": "BRL", "price": 1 }
...
],
}
{ "date": "2018-01-03",
"data": [
{ "currency": "JPY", "price": 29.440621222 },
{ "currency": "BRL", "price": 1 }
...
]
}
]
}
License
MIT