汇率 API — @allatestoday/ sdk

用于Node.js和浏览器的实时中市货币汇率. 最优雅的方式进入160+货币.

为什么选择这个客户端?

• ⚡ 闪电快 ——零运行时依赖性,纯类型脚本性能
• 📡 实时数据 ——每60秒更新一次
• 💹 中间市场率 ——无零售推广或打分入烤
• 🌍 160+ 货币 主要、次要和异国货币对
• 🏛️ 官方收费率 最新表格来自 122个中央银行和4个税务当局 通过 officialRates(),不需要键
• 🔷 类型安全 ——智能自动完成的全类型脚本支持
• 🌐 通用 ——在Node.js 18+和现代浏览器中无缝工作
• 🧑‍💻 方便开发者 - 简单的API、广泛的文档和伟大的DX

获取您的 API 密钥

准备好了吗? 免费 API 密钥从 allatestoday.com/注册员。 。 。 .

* 安装

npm install @allratestoday/sdk

yarn add @allratestoday/sdk

pnpm add @allratestoday/sdk

QQ 快速启动

起来,数秒后运行:

import AllRatesToday from '@allratestoday/sdk';

// Set your API key
const client = new AllRatesToday({ apiKey: 'YOUR_API_KEY' });

// Get latest exchange rates
const { rates } = await client.latest({ base: 'USD', symbols: ['EUR', 'GBP', 'JPY'] });
console.log(rates);

API 参考

• 最新比率 ——获得现行汇率
• 历史数据 ——获取特定日期的费率
• 货币兑换 - 货币兑换
• 时间序列 ——按日期范围获取费率
• 可用货币 - 列出所有支持的货币
• 单一比率 - 得到一对货币
• 按时期分列的历史 - 预设期间的检查

最近汇率

获得最新汇率并单调:

// Get all rates from USD
const data = await client.latest();
console.log(data);

// Target specific currencies
const data = await client.latest({ base: 'USD', symbols: ['CHF', 'GBP', 'JPY'] });
console.log(data);

回应:

{
  base: 'USD',
  date: '2026-04-09T14:30:00Z',
  rates: {
    CHF: 0.8821,
    GBP: 0.7891,
    JPY: 151.42
  }
}

历史汇率

历史方法forDate, (中文(简体) ), timeSeries, (中文(简体) ), getHistoricalRates 财务报告和审定财务报表 convert 带有 date需要每月4.99欧元的付款计划。 免费和审判钥匙只获得最新费率,并获得403 historical_requires_paid_plan 为了历史.

及时旅行以获得任何日期的费率:

// Using a string date
const data = await client.forDate('2026-01-15', { base: 'USD', symbols: ['EUR'] });
console.log(data);

// Using a Date object
const data = await client.forDate(new Date('2026-01-15'), { base: 'EUR', symbols: ['USD', 'GBP'] });
console.log(data);

回应:

{
  base: 'USD',
  date: '2026-01-15',
  rates: {
    EUR: 0.9187
  }
}

货币兑换

在货币之间转换任何数额——包括历史转换(付款计划):

// Current conversion
const result = await client.convert('USD', 'EUR', 1000);
console.log(result);

回应:

{
  from: 'USD',
  to: 'EUR',
  amount: 1000,
  result: 923.4,
  rate: 0.9234
}

// Historical conversion — what was $1,000 worth on Jan 15?
const result = await client.convert('USD', 'EUR', 1000, { date: '2026-01-15' });
console.log(result);

回应:

{
  from: 'USD',
  to: 'EUR',
  amount: 1000,
  result: 918.7,
  rate: 0.9187,
  date: '2026-01-15'
}

可用货币

发现所有160+支持的货币符号和名称 :

const data = await client.symbols();
console.log(data);

回应:

{
  symbols: {
    AED: 'United Arab Emirates Dirham',
    AFN: 'Afghan Afghani',
    ALL: 'Albanian Lek',
    AMD: 'Armenian Dram',
    AUD: 'Australian Dollar',
    BDT: 'Bangladeshi Taka',
    BRL: 'Brazilian Real',
    CAD: 'Canadian Dollar',
    CHF: 'Swiss Franc',
    CNY: 'Chinese Yuan',
    EUR: 'Euro',
    GBP: 'British Pound Sterling',
    INR: 'Indian Rupee',
    JPY: 'Japanese Yen',
    KRW: 'South Korean Won',
    USD: 'United States Dollar',
    // ...160+ currencies
  }
}

时间序列数据

确定日期范围内的汇率,以便进行趋势分析和绘制图表(付款计划):

const data = await client.timeSeries('2026-01-01', '2026-03-31', {
  base: 'USD',
  symbols: ['EUR', 'GBP'],
});
console.log(data);

回应:

{
  base: 'USD',
  startDate: '2026-01-01',
  endDate: '2026-03-31',
  rates: {
    '2026-01-01': {
      EUR: 0.9187,
      GBP: 0.7834
    },
    '2026-01-02': {
      EUR: 0.9195,
      GBP: 0.7841
    },
    '2026-01-03': {
      EUR: 0.9201,
      GBP: 0.7856
    },
    // ...
  }
}

单一比率

获得两种货币之间的单一汇率:

const rate = await client.getRate('USD', 'EUR');
console.log(rate);

回应:

{
  from: { currency: 'USD', amount: 1 },
  to: { currency: 'EUR', amount: 0.9234 },
  rate: 0.9234,
  source: 'wise'
}

// With amount
const rate = await client.getRate('USD', 'EUR', 500);
console.log(`$500 = €${rate.to.amount}`);

官方的中央银行和税务授权率(不需要钥匙)

以上方法为中上市率。 给 官方汇率a 出版机构 - 发票、增值税申报、报关单和 审计需要——使用 officialRates()覆盖 122个中央银行 + 高棉中央委员会, 美国财政部、瑞士BAZG和印度的CBIC,以及最新的表格需求 无 API 密钥数字 :

const client = new AllRatesToday(); // no key

// Full ECB reference table
const table = await client.officialRates('ecb');
console.log(table.rate_date, table.rates); // [{ base: 'EUR', quote: 'USD', type: 'reference', value: 1.17 }, …]

// One pair (cross-computed inside the bank's own table if not published directly → `derived: true`)
const usd = await client.officialRates('ecb', { source: 'EUR', target: 'USD' });
console.log(`ECB ${usd.rate_date}: 1 EUR = ${usd.rate} USD`);

// Which sources exist, and which are behind their publication schedule
const { sources } = await client.officialSources();
console.log(sources.map((s) => `${s.code} ${s.latest}${s.stale ? ' (stale)' : ''}`));

总是引用返回的 rate_date 这是该机构的出版日期, 不是你打电话的时候 日期表和历史需要付费的计划和使用 /api/v1/central-bank/{bank}/{date};出版日历处理任何密钥。 见 中央银行利率。 。 。 .

按时期分列的历史比率

使用预设期间获取历史速率——不需要日期数学(付费计划) :

const history = await client.getHistoricalRates('USD', 'EUR', '30d');
console.log(history);

回应:

{
  source: 'USD',
  target: 'EUR',
  period: '30d',
  current: { rate: 0.9234, time: '2026-04-09T14:30:00Z' },
  rates: [
    { rate: 0.9198, time: '2026-03-10T00:00:00Z' },
    { rate: 0.9210, time: '2026-03-11T00:00:00Z' },
    // ...
  ]
}

可用时间 : 1d | 7d | 30d | 1y

QQ 配置

const client = new AllRatesToday({
  apiKey: 'YOUR_API_KEY',          // Required — get one free at allratestoday.com/register
  baseUrl: 'https://allratestoday.com', // Optional — API base URL
  timeout: 10000,                       // Optional — request timeout in ms
});

XQ 请求 API 密钥覆盖

每种方法都支持每个请求的 API 密钥覆盖 —— 对多用户应用程序有用 :

const client = new AllRatesToday({ apiKey: 'default_key' });

// Override for a specific request
const data = await client.latest({ apiKey: 'other_users_key' });
const result = await client.convert('USD', 'EUR', 100, { apiKey: 'tenant_key' });
const { symbols } = await client.symbols({ apiKey: 'another_key' });

QQ 错误处理

所有错误都抛出为 AllRatesTodayError 带有可选的 HTTP 状态代码 :

import AllRatesToday, { AllRatesTodayError } from '@allratestoday/sdk';

try {
  const rate = await client.getRate('USD', 'INVALID');
} catch (err) {
  if (err instanceof AllRatesTodayError) {
    console.log(err.message); // "Currency not found"
    console.log(err.status);  // 404
  }
}

QQ 类型脚本

SDK以TypeScript和舰船全型定义来写作. 所有接口均导出 :

import AllRatesToday, {
  AllRatesTodayError,
  AllRatesTodayOptions,
  RequestOptions,
  RateResponse,
  AuthRateResponse,
  LatestOptions,
  LatestResponse,
  ForDateOptions,
  ForDateResponse,
  ConvertOptions,
  ConvertResponse,
  TimeSeriesOptions,
  TimeSeriesResponse,
  HistoricalRateResponse,
  SymbolsResponse,
} from '@allratestoday/sdk';

常规JS

const AllRatesToday = require('@allratestoday/sdk').default;

const client = new AllRatesToday({ apiKey: 'YOUR_API_KEY' });
client.latest().then(data => console.log(data.rates));

实例

货币掉落( 反应)

import { useEffect, useState } from 'react';
import AllRatesToday from '@allratestoday/sdk';

const client = new AllRatesToday({ apiKey: 'YOUR_API_KEY' });

function CurrencySelect({ value, onChange }) {
  const [currencies, setCurrencies] = useState([]);

  useEffect(() => {
    client.symbols().then(({ symbols }) => {
      setCurrencies(
        Object.entries(symbols).map(([code, name]) => ({ code, name }))
      );
    });
  }, []);

  return (
    <select value={value} onChange={e => onChange(e.target.value)}>
      {currencies.map(c => (
        <option key={c.code} value={c.code}>{c.code} — {c.name}</option>
      ))}
    </select>
  );
}

用缓存显示价格

import AllRatesToday from '@allratestoday/sdk';

const client = new AllRatesToday({ apiKey: 'YOUR_API_KEY' });
let cache: { rates: Record<string, number>; time: number } | null = null;
const TTL = 5 * 60 * 1000; // 5 minutes

async function getPrice(amountUSD: number, currency: string): Promise<string> {
  if (!cache || Date.now() - cache.time > TTL) {
    const data = await client.latest({ base: 'USD' });
    cache = { rates: data.rates, time: Date.now() };
  }
  const converted = (amountUSD * cache.rates[currency]).toFixed(2);
  return `${converted} ${currency}`;
}

console.log(await getPrice(99.99, 'EUR')); // "92.32 EUR"
console.log(await getPrice(99.99, 'GBP')); // "78.90 GBP"

历史图表数据

需要付费计划(历史不包含在免费或试用钥匙中).

import AllRatesToday from '@allratestoday/sdk';

const client = new AllRatesToday({ apiKey: 'YOUR_API_KEY' });

const data = await client.timeSeries('2026-01-01', '2026-04-01', {
  base: 'USD',
  symbols: ['EUR'],
});

// Format for charting libraries (Chart.js, Recharts, etc.)
const labels = Object.keys(data.rates).sort();
const values = labels.map(date => data.rates[date].EUR);

console.log({ labels, values });
// { labels: ['2026-01-01', '2026-01-02', ...], values: [0.92, 0.921, ...] }

方法参考

测试

运行孤立的单元测试( 不需要 API 呼叫) :

npm test

进行覆盖报告测试 :

npm run test:coverage

开发的监视模式 :

npm run test:watch

使用来自AI代理

编码代理和LLM工具的编码率相同,没有第二次整合:

• Claude 代码插件 (无密钥): /plugin marketplace add AllRates-Today/claude-code-plugin 接下来 /plugin install allratestoday@allratestoday
• 托管的 MCP 端点数字 : https://allratestoday.com/api/mcp ——可流式HTTP,无密钥,无可安装
• 本地 MCP 服务器数字 : npx -y @allratestoday/mcp-server (中市利率) npx -y @allratestoday/central-bank-mcp (官方中央银行利率)
• 代理员的审判密钥, 不注册数字 : POST https://allratestoday.com/api/agent/keys (发送) Content-Type: application/json)返回一个有效期为7天的100呼叫键,用于最新的利率和最新的中央银行表格(历史和日期表仅支付计划);两个MCP服务器都将其披露为 request_trial_key
• 每日参考率 (第一次公布为2026-10-12):每个工作日固定一个美元表,16:00伦敦分样本中位数,从未修订——无密钥 https://allratestoday.com/api/open/reference-rate, (中文(简体) ), get_reference_rate mCP 服务器中
• 机器可读网站指南 : 页:1

链接

• 网站: allatestoday.com (英语)
• 下载中央银行利率 ——每家银行的表格为Excel,CSV或JSON
• API 文档
• 注册( 免费)
• 盘子
• 状态
• 邮递员收藏
• ChatGPT 应用程序 ——向ChatGPT索取活期和官方央行利率
• GitHub 图像

许可证

麻省理工学院