← Back to Skills Marketplace
ax2

Exchange Rate

by Alex Xiang · GitHub ↗ · v1.0.0
cross-platform ✓ Security Clean
704
Downloads
0
Stars
2
Active Installs
1
Versions
Install in OpenClaw
/install exchange-rate
Description
Real-time forex and cryptocurrency exchange rate lookup and amount conversion powered by QVeris. Supports multiple providers (Alpha Vantage, Twelve Data) wit...
README (SKILL.md)

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.
Usage Guidance
This skill is coherent with its purpose: it needs a QVERIS_API_KEY and calls only qveris.ai to discover/execute currency tools. Before installing: 1) confirm and provide a QVERIS_API_KEY with the minimal scope you trust (read-only if possible); 2) verify you trust qveris.ai and its privacy/usage policy, because queries and amounts will be sent to that service (QVeris may in turn contact third-party providers); 3) note the repository/registry metadata inconsistency — the SKILL.md and script require QVERIS_API_KEY even though the registry listing shows none; ask the publisher to fix the metadata if this matters to your audit process; 4) if you need stricter control, run the script locally and inspect network traffic or restrict outbound access to qveris.ai only.
Capability Analysis
Type: OpenClaw Skill Name: exchange-rate Version: 1.0.0 The skill bundle is benign. It transparently declares its sole dependency on the `QVERIS_API_KEY` and its exclusive network communication with `qveris.ai` over HTTPS. The `exchange_rate.mjs` script correctly retrieves the API key from environment variables and uses user inputs to construct JSON payloads for the QVeris API, preventing injection vulnerabilities. There is no evidence of data exfiltration, arbitrary command execution, persistence mechanisms, or prompt injection attempts in any of the files.
Capability Assessment
✓ Purpose & Capability
Name/description match the code and SKILL.md: the script searches qveris.ai for currency tools and executes them to return rates/conversions. The requested credential (QVERIS_API_KEY) is appropriate for that purpose. Note: registry metadata provided separately lists no required env vars, which conflicts with the SKILL.md and scripts that require QVERIS_API_KEY.
✓ Instruction Scope
Runtime instructions and the included script limit network activity to qveris.ai and perform only search/execute flows, parameter building, parsing, and formatting. The skill does not read other files, system credentials, or arbitrary endpoints in the repository. It relies on QVeris to call underlying providers (Alpha Vantage, Twelve Data) on the server side.
✓ Install Mechanism
No install spec is present (instruction-only style). The repository includes a runnable Node.js script (no installers or external downloads). This is a low-risk installation model — files are bundled in the skill and nothing is fetched from arbitrary URLs at install time.
ℹ Credentials
The code and SKILL.md require a single credential (QVERIS_API_KEY), which is proportional to the stated functionality. However, registry metadata elsewhere indicated 'no required env vars' — that mismatch should be resolved. The script does not request additional tokens or secrets.
✓ Persistence & Privilege
The skill is not always-enabled (always: false) and uses normal autonomous invocation behavior. It does not attempt to modify other skills or system-wide settings. Autonomous invocation is the platform default.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install exchange-rate
  3. After installation, invoke the skill by name or use /exchange-rate
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
initial version
Metadata
Slug exchange-rate
Version 1.0.0
License —
All-time Installs 4
Active Installs 2
Total Versions 1
Frequently Asked Questions

What is Exchange Rate?

Real-time forex and cryptocurrency exchange rate lookup and amount conversion powered by QVeris. Supports multiple providers (Alpha Vantage, Twelve Data) wit... It is an AI Agent Skill for Claude Code / OpenClaw, with 704 downloads so far.

How do I install Exchange Rate?

Run "/install exchange-rate" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Exchange Rate free?

Yes, Exchange Rate is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Exchange Rate support?

Exchange Rate is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Exchange Rate?

It is built and maintained by Alex Xiang (@ax2); the current version is v1.0.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments