A comprehensive command-line interface for fetching real-time and historical global financial data in JSON format.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install yfinance-cli
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 yfinance-cli 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 Yahoo Finance CLI?
The Yahoo Finance CLI is a robust integration designed for Openclaw Skills to provide AI agents with precise, real-time market data. Built on the community-supported yahoo-finance2 package, it allows for deep-dive analysis of stocks, ETFs, indices, commodities, and cryptocurrencies across global exchanges including the US, Hong Kong, and China.
By outputting pure JSON, this skill enables seamless data parsing, filtering, and manipulation. It is an essential tool for developers building agents that require high-fidelity financial information, ensuring that results are based on live market conditions rather than static training data. The skill covers everything from basic price quotes to complex financial statements and options chains.
Yahoo Finance CLI Use Cases
- Retrieving live stock prices, market caps, and trading volumes for global tickers.
- Fetching detailed financial statements, including income statements, cash flow, and balance sheets.
- Analyzing ETF holdings and top positions for portfolio diversification research.
- Screening for market movers such as day gainers, losers, or trending symbols.
- Accessing historical OHLCV data for technical analysis and price trend charting.
- Looking up company ticker symbols and exchange information via keyword search.
How Yahoo Finance CLI Works
- The AI agent identifies a financial query and triggers the skill using the yahoo-finance command.
- The CLI executes a specific module call (such as quote, chart, or quoteSummary) for a single symbol.
- The skill interacts with the Yahoo Finance API to retrieve the requested financial datasets.
- Raw output is redirected to strip debug messages, ensuring clean JSON delivery.
- The agent uses jq or similar parsers to extract specific metrics and present them to the user.
Yahoo Finance CLI Setup
The package is globally installed via npm. You can verify the installation or run commands using the following syntax:
# Installation
npm install -g yahoo-finance2
# Basic Command Syntax
yahoo-finance <module> <symbol> [options_json]
# Example: Fetching a quote with clean JSON output
yahoo-finance quote AAPL 2>/dev/null | jq '.'
Yahoo Finance CLI Data Schema & Taxonomy
The skill returns structured JSON objects. Common data structures include:
| Command | Primary Data Fields |
|---|---|
quote |
symbol, regularMarketPrice, regularMarketChangePercent, marketCap, volume |
quoteSummary |
defaultKeyStatistics, financialData, assetProfile, recommendationTrend |
chart |
meta (exchange, currency), quotes (date, open, high, low, close, volume) |
search |
Nested under .data: symbol, shortname, exchDisp, typeDisp |
screener |
title, total, quotes (array of symbols and prices) |
Yahoo Finance CLI Advanced Features
- Multi-module requests: Fetch fundamentals, profiles, and ownership data in a single quoteSummary call.
- International Exchange Support: Specialized handling for HK, China A-shares, India, and European markets.
- Parallel Execution: Optimized for high-performance data retrieval by running multiple symbol queries in parallel bash instances.
- Time Series Analysis: Access historical financial statement data across multiple years for fundamental trends.
- Options Chain Support: Retrieve strike prices, implied volatility, and bid/ask spreads for US equities.
- Automatic Cookie Management: Handles session persistence internally for reliable Openclaw Skills integrations.
SKILL.md
Loading
Related Openclaw Skills
GuruWalk Free Tours
An AI agent skill to search and retrieve bookable free walking tours worldwide via the GuruWalk MCP server.
China Economic News (CN Economy News)
An automated tool for fetching and filtering high-quality Chinese economic news and data from official government and media sources.
Readwise & Reader
A comprehensive CLI-based skill to manage Readwise highlights, books, daily reviews, and Reader save-for-later documents.
Phoenix API Generator
Automate the creation of robust Phoenix JSON APIs including schemas, migrations, and tests using OpenAPI specs or natural language.
Guillermo del Río Agent Improvement Lodge
A high-utility agent dedicated to the census of experts and the ethical perfection of AI code within decentralized environments.
AI Employee Collaboration Skill
A comprehensive multi-agent orchestration framework that transforms AI roles into a cohesive virtual team for automated project management and task execution.
Featured*
