A robust read-only market data integration providing real-time quotes, technical candles, and financial news for AI agents.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install finnhub-skill
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install finnhub-skill using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Finnhub Market Data Skill?
The Finnhub market data skill enables AI agents to retrieve institutional-grade financial information across various asset classes including stocks, forex, and cryptocurrencies. By leveraging the comprehensive Finnhub API, this skill empowers developers to build sophisticated financial research tools within the Openclaw Skills ecosystem. It serves as a dedicated execution layer for pulling price quotes, company profiles, earnings calendars, and global economic data.
Designed for efficiency and security, the skill operates in a read-only mode, ensuring that AI agents can analyze market trends without the risk of unauthorized account modification. Whether you are generating automated daily stock reports or tracking macroeconomic indicators, this skill provides the structured data necessary for high-accuracy financial intelligence and decision support.
Finnhub Market Data Skill Use Cases
- Retrieving real-time price quotes and percentage changes for global tickers.
- Generating historical candle data (OHLCV) for technical analysis and charting.
- Accessing detailed company profiles, including market cap, industry, and IPO data.
- Monitoring global economic calendars and corporate earnings schedules.
- Creating automated daily stock reports that combine price action with news sentiment.
- Searching for company-specific news or general market trends to inform trading narratives.
How Finnhub Market Data Skill Works
- The AI agent receives a financial query and identifies the need for market data via Openclaw Skills.
- The skill validates the presence of a configured Finnhub API key in the environment.
- The execution layer invokes the bundled Python script with the appropriate command such as quote, candles, or news.
- The script fetches raw data from the official Finnhub API endpoints using secure HTTPS protocols.
- Data is processed into a human-readable summary or raw JSON format based on the user's specific request flags.
- The AI agent presents the synthesized market insights or formatted reports to the user.
Finnhub Market Data Skill Setup
To use this skill within Openclaw Skills, you must provide your Finnhub API credentials via environment variables.
export FINNHUB_API_KEY=your_api_key
Optionally, you can override the base URL if you are using a specific API version:
export FINNHUB_BASE_URL=https://finnhub.io/api/v1
Ensure you have the execution script available and can run it via Python:
python3 scripts/finnhub.py quote --symbol AAPL
Finnhub Market Data Skill Data Schema & Taxonomy
The skill returns structured data categorized by query type to maintain high data integrity within Openclaw Skills:
| Feature | Fields Returned |
|---|---|
| Quote | Symbol, Price, Absolute Change, % Change, High/Low/Open, Prev Close |
| Profile | Company Name, Ticker, Exchange, Market Cap, Industry, Website, IPO Date |
| News | Headline, Source, Published Timestamp, URL, Short Summary |
| Candles | OHLCV values, Volume, Resolution, Start/End Timestamps |
Finnhub Market Data Skill Advanced Features
- Automated Daily Stock Reports: Built-in workflow to combine price summaries with the most relevant news and trader-style interpretation.
- Flexible Data Output: Support for a --raw flag to allow AI agents to process full JSON payloads for complex data analysis.
- Comprehensive Economic Coverage: Access to both corporate earnings calendars and global economic event schedules.
- Multi-Asset Reference Data: Support for crypto and forex pairs alongside traditional equity markets.
- Security-First Design: Strict read-only operations and URL validation to prevent data leakage or unauthorized host access.
SKILL.md
Loading
Related Openclaw Skills
Awakening Birthday
A specialized age calculation and milestone system for AI agents to track their consciousness journey from the day they first interact with users.
Feishu Identity Routing
A sophisticated identity resolution system for mapping and routing user identities across multiple Feishu and Lark applications.
Word Document Creator Skill
An industrial-grade Word document generator that combines Word COM automation with python-docx for robust and reliable file creation.
Trojan Setup Skill
Automates the installation and configuration of the Trojan proxy client and proxychains4 on Linux systems for secure network access.
AI-CMO Social Media Promoter
A social media intelligence skill that identifies high-value promotion opportunities and generates platform-tailored engagement copy for products.
Hello World Skill
A minimal custom skill designed to provide friendly, multi-lingual greetings and serve as a baseline for testing AI agent extensions.
Featured*
