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

- Skill: `johnalbertini14-glitch/exchange-rate` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add johnalbertini14-glitch/exchange-rate`
- Raw SKILL.md: https://api.skillmd.com/api/skills/johnalbertini14-glitch/exchange-rate/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: johnalbertini14-glitch (https://skillmd.com/u/johnalbertini14-glitch)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/johnalbertini14-glitch/exchange-rate

---


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