exchange-rate

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Chinese

Real-time currency exchange rate and conversion using QVeris tools.

基于QVeris工具实现的实时货币汇率查询与金额转换功能。

Exchange Rate provides:

Rate lookup – Current exchange rate between two currencies (e.g. USD/EUR, CNY/JPY).
Amount conversion – Convert an amount from one currency to another at current rates.

Supported via QVeris: forex and common fiat pairs; optional historical date for rate/conversion when the tool supports it.

Exchange Rate提供以下功能：

通过QVeris支持外汇及常见法定货币对；当工具支持时，可选择历史日期进行汇率查询或金额转换。

Uses only QVeris API: search for tools by capability, then execute; no hardcoded provider list.
Fallback across providers (e.g. Alpha Vantage, Twelve Data) when one fails or is unavailable.
Same credential as other skills:
```
QVERIS_API_KEY
```
only.
Read-only, no side effects; suitable for travel, trade, and reporting.

Parse user intent: rate (from_currency, to_currency) or convert (from_currency, to_currency, amount).
Search QVeris for tools: e.g. "currency exchange rate real-time", "currency conversion".
Rank results by success_rate, latency, and parameter fit (rate vs conversion).
Build request parameters: for rate use
```
from_currency
```
/
```
to_currency
```
or
```
symbol
```
(e.g.
```
EUR/USD
```
); for conversion add
```
amount
```
.
Execute chosen tool with 5s timeout; on failure try next candidate.
Return formatted rate and/or converted amount (markdown or JSON).

Primary script:

scripts/exchange_rate.mjs

Get rate only:

node scripts/exchange_rate.mjs rate --from USD --to EUR

node scripts/exchange_rate.mjs rate --from CNY --to USD

Convert amount:

node scripts/exchange_rate.mjs convert --from USD --to JPY --amount 1000

node scripts/exchange_rate.mjs convert --from EUR --to GBP --amount 500

Optional:

--date YYYY-MM-DD

for historical rate/conversion when the tool supports it;

--format json

for machine-readable output.

主脚本：

scripts/exchange_rate.mjs

仅查询汇率：

node scripts/exchange_rate.mjs rate --from USD --to EUR

node scripts/exchange_rate.mjs rate --from CNY --to USD

金额转换：

node scripts/exchange_rate.mjs convert --from USD --to JPY --amount 1000

node scripts/exchange_rate.mjs convert --from EUR --to GBP --amount 500

可选参数：当工具支持时，使用

--date YYYY-MM-DD

查询历史汇率或进行历史金额转换；使用

--format json

获取机器可读格式的输出。