Skills exchange-rate

Real-time forex and cryptocurrency exchange rate lookup and amount conversion powered by QVeris. Supports multiple providers (Alpha Vantage, Twelve Data) with fallback for reliability.

install
source · Clone the upstream repo
git clone https://github.com/openclaw/skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/ax2/exchange-rate" ~/.claude/skills/clawdbot-skills-exchange-rate && rm -rf "$T"
manifest: skills/ax2/exchange-rate/SKILL.md
source content

Exchange Rate

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

What This Skill Does

Exchange Rate provides:

  1. Rate lookup – Current exchange rate between two currencies (e.g. USD/EUR, CNY/JPY).
  2. 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.

Key Advantages

  • 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.

Core Workflow

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

Command Surface

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.

Safety and Disclosure

  • Uses only
    QVERIS_API_KEY
    ; no other secrets.
  • Calls only QVeris over HTTPS; no package install or arbitrary commands.
  • Output is for reference only; not financial or contractual advice.