finance

What This Skill Does

The finance skill is a robust tool designed for OpenClaw users to track and analyze market data across various asset classes including stocks, ETFs, major indices, and foreign exchange (FX) pairs. It acts as a lightweight, terminal-based market intelligence hub that handles fetching, caching, and summarizing financial information. By leveraging multiple provider strategies, it balances accessibility with reliable data retrieval, allowing users to query the latest quotes or view historical performance trends without needing complex, paid financial terminals. It manages data locally through a watchlist system, ensuring that you can monitor your specific portfolio or interests efficiently while respecting rate limits.

Installation

To begin using this skill, you must first ensure you have the OpenClaw environment properly initialized. Navigate to your terminal and execute the installation command provided via the ClawHub registry:

clawhub install openclaw/skills/skills/anton-roos/finance

After installation, ensure that your virtual environment is active by running source .venv/bin/activate and verifying dependencies via pip install -r requirements.txt. This setup ensures all local scripts for market tracking, series data, and watchlist management are ready for execution.

Use Cases

This skill is perfect for users who require quick, on-demand financial data. Common scenarios include checking the current trading price of a specific stock, monitoring the historical trend of an index over the last 30 days, or checking exchange rates for international travel or currency conversion. It is also designed for passive monitoring; by maintaining a local watchlist, users can trigger a summary command to see a comprehensive performance snapshot of their monitored assets in a single, clean output view.

Example Prompts

1. "What is the current price of AAPL and how has it moved today?"
2. "Show me the 30-day historical price series for USD/ZAR."
3. "Add VOO and MSFT to my watchlist, then show me a summary of my current portfolio."

Tips & Limitations

• Real-Time Warning: Be aware that the skill does not guarantee real-time data. FX rates specifically update on a daily basis via the open-access provider. Do not rely on this for high-frequency day trading.
• Rate Limiting: Since the skill uses free providers like Yahoo Finance, heavy querying can result in temporary blocks. If you encounter errors, wait a few minutes before trying again or investigate a paid provider integration.
• Caching: The tool uses local caching to stay performant. If data seems stale, check your local cache settings or the documentation for the market_watchlist.py script to understand how to refresh your current data view.