@kabeep/forex v1.0.1

💱 一个 JavaScript 外汇库，通过 fawazahmed0 的 API。

English | 简体中文

📖 简介

forex 全称是 Foreign Exchange，它的目的不是用于 FX 外汇交易，请慎重用于投资相关决策。

在浏览器或终端中获取每日汇率，免费且无速率限制。

查看 文档 或 在线示例。

⚙️ 安装

npm install @kabeep/forex --save

yarn add @kabeep/forex

pnpm add @kabeep/forex

🚀 使用

CommonJS

const { ForexClient } = require('@kabeep/forex');

ESModule

import { ForexClient } from '@kabeep/forex';

函数: getCurrencies(date, options)

获取可用的货币列表。

const client = new ForexClient();
// => {
//    code: 200,
//    message: 'OK',
//    data: [
//        { code: 'eur', name: 'Euro' },
//        { code: 'usd', name: 'US Dollar' },
//        { code: 'cny', name: 'Chinese Yuan Renminbi' },
//        { code: 'btc', name: 'Bitcoin', }
//        ... More items
//    ]
// }
client.getCurrencies('latest');

// or
client.getCurrencies(new Date(2024, 11, 1));

返回: Promise<HttpResponse<AvailableCurrency[]>>

结果对象:

接口 AvailableCurrency:

函数: getRates(code, date, options)

获取指定货币的汇率。

const client = new ForexClient();
// => {
//    code: 200,
//    message: 'OK',
//    data: [
//        { code: 'eur', rate: 100_000 },
//        { code: 'usd', rate: 100_000 },
//        { code: 'cny', rate: 100_000 },
//        ... More items
//    ]
// }
client.getRates('USD');

// or
client.getRates('US');

返回: Promise<HttpResponse<ExchangeRate[]>>

结果对象:

接口 ExchangeRate:

函数: getRate(baseCode, destCode, date, options)

获取两种货币之间的汇率。

const client = new ForexClient();
// => {
//    code: 200,
//    message: 'OK',
//    data: 0.94759027
// }
client.getRate('USD', 'EUR');

// => {
//    code: 200,
//    message: 'OK',
//    data: 7.78004385
// }
client.getRate('US', 'HK');

返回: Promise<HttpResponse<number>>

结果对象:

函数: getCode(localeCode)

根据 ISO 3166-1 代码获取有效的货币代码。

const client = new ForexClient();
// => 'USD'
client.getCode('US');

// => 'CNH'
client.getCode('HK');

// => 'CNY'
client.getCode('RMB');

返回: string

对应的货币代码。

函数: convert(baseCode, destCode, amount, date, options)

将金额从一种货币转换为另一种货币。

const client = new ForexClient();
// => {
//    code: 200,
//    message: 'OK',
//    data: 9.48
// }
client.convert('USD', 'EUR', 10);

// => {
//    code: 200,
//    message: 'OK',
//    data: 72.67
// }
client.convert('US', 'HK', 10);

返回: Promise<HttpResponse<number>>

结果对象:

🏅 致谢

exchange-api - 如果没有这个，这个包就不会存在。

🤝 贡献

欢迎通过 Pull Requests 或 Issues 来贡献你的想法和代码。

📄 许可

本项目采用 MIT 许可证。详情请见 LICENSE 文件。