A professional Python CLI tool providing instant access to real-time US stock market data, company fundamentals, and insider trading activity.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install finnhub-pro
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-pro 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 Pro?
Finnhub Pro is a comprehensive command-line interface designed to bridge the gap between professional financial data and your development environment. As a key part of the Openclaw Skills ecosystem, it provides a high-performance wrapper around the Finnhub API, specifically optimized to maximize the utility of the free-tier access. It allows users to retrieve real-time quotes, deep company profiles, and analyst recommendation trends with simple commands.
This skill is particularly valuable for developers building financial monitoring tools or AI researchers that require grounded, real-time market data. By utilizing this within your Openclaw Skills setup, you gain the ability to automate the retrieval of earnings calendars, peer comparisons, and market status updates across major US exchanges without manual searching.
Finnhub Pro Use Cases
- Tracking real-time price movements and market quotes for US-listed tickers.
- Automating fundamental analysis by fetching key financial metrics and ratios.
- Monitoring insider trading patterns to identify significant executive buy or sell signals.
- Generating earnings calendars to stay ahead of quarterly corporate reports.
- Conducting competitive research by identifying and comparing industry peers.
How Finnhub Pro Works
- The user executes a specific command via the Python CLI, such as quote, financials, or news, targeting a specific ticker symbol.
- The script retrieves the necessary API credentials from the FINNHUB_API_KEY environment variable to ensure secure authentication.
- The tool sends a request to the Finnhub API servers, adhering to the 60 calls per minute rate limit of the free tier.
- The returned data is parsed and presented as either formatted text for humans or structured JSON for integration with other Openclaw Skills workflows.
Finnhub Pro Setup
To get started with this skill, first install the necessary Python client library:
pip install finnhub-python
Next, obtain your free API key from finnhub.io and export it to your environment variables. You can also save this in your local configuration file:
export FINNHUB_API_KEY="your-key-here"
Verify the setup by running a basic quote command:
python3 scripts/finnhub_cli.py quote NVDA
Finnhub Pro Data Schema & Taxonomy
The skill processes and returns data structured for financial clarity. The following table outlines the primary data domains:
| Data Category | Key Information Fields | Primary Commands |
|---|---|---|
| Market Quotes | Current Price, High/Low, Opening Price | quote |
| Fundamentals | PE Ratio, Market Cap, Margins, 52-Week Range | financials |
| Corporate News | Headlines, Summaries, Source URLs, Timestamps | news |
| Insider Activity | Transaction Date, Share Change, Insider Name | insiders |
| Market Status | Exchange Opening Hours, Current Trading Status | market |
Finnhub Pro Advanced Features
- Native JSON output support via the
--jsonflag for easy piping into data pipelines within the Openclaw Skills framework. - Advanced date filtering using
--fromand--toparameters for historical news and insider transaction lookups. - Query optimization using the
--limitargument to control the volume of data returned for LLM context windows. - Global ticker search functionality to resolve company names to their respective exchange symbols.
SKILL.md
Loading
Related Openclaw Skills
Parallel Responder
An intelligent execution layer for AI agents that eliminates waiting times through task classification and parallel sub-agent processing.
tg-history
A high-efficiency browser tool for extracting Telegram group chat history as formatted text without using screenshots or OCR.
tg-checkin Telegram Automation
A specialized Telegram Web automation skill that performs verified, serial check-ins across multiple groups based on your configuration.
IMAP/SMTP Email Management Skill
A comprehensive email automation tool that enables AI agents to read, search, and send messages via standard IMAP and SMTP protocols.
SerpAPI Search
A powerful search integration for AI agents to fetch real-time web results across multiple engines via SerpAPI.
Social Media Multi-Platform Publisher
A browser automation skill for multi-platform social media content publishing and draft management.
METADATA
Featured*
