finance-data
Fetch professional stock market data from Yahoo Finance (yfinance) and SEC EDGAR. Use when: user asks about stock prices, market data, company financials, earnings, analyst recommendations, SEC filings (10-K, 10-Q, 8-K), insider transactions, options chains, dividend history, company profiles, XBRL financial concepts, or any equity research task. Supports US stocks, Chinese A-shares (e.g. 600519.SS), and international markets.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/1shadow1/finance-dataFinance Data Skill
Fetch professional stock and financial data from Yahoo Finance (via yfinance) and SEC EDGAR (free public API).
Setup
Install the Python dependency (one-time):
pip install -r skills/finance-data/scripts/requirements.txt
SEC EDGAR requires a User-Agent header identifying the requester. Set the env var (optional — a default is provided):
export SEC_EDGAR_USER_AGENT="YourName [email protected]"
Ticker Formats
| Market | Format | Example |
|---|---|---|
| US stocks | Symbol | AAPL, MSFT, GOOGL |
| Shanghai A-shares | Code.SS | 600519.SS (Moutai) |
| Shenzhen A-shares | Code.SZ | 000858.SZ (Wuliangye) |
| Hong Kong | Code.HK | 0700.HK (Tencent) |
| Tokyo | Code.T | 7203.T (Toyota) |
| London | Code.L | HSBA.L (HSBC) |
| ETFs / Indices | Symbol | SPY, QQQ, ^GSPC, ^HSI |
Yahoo Finance Commands
All commands output JSON to stdout.
Current Quote
python3 scripts/yfinance_query.py quote AAPL
Returns: price, volume, market cap, P/E, EPS, 52-week range, moving averages, dividend yield, beta, profit margins, etc.
Historical Prices (OHLCV)
# Last month, daily
python3 scripts/yfinance_query.py history AAPL
# Last year, weekly
python3 scripts/yfinance_query.py history AAPL --period 1y --interval 1wk
# Last 5 days, 5-minute bars
python3 scripts/yfinance_query.py history AAPL --period 5d --interval 5m
Period options: 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max
Interval options: 1m, 2m, 5m, 15m, 30m, 60m, 90m, 1h, 1d, 5d, 1wk, 1mo, 3mo
Financial Statements
# All statements (income, balance sheet, cash flow) — annual
python3 scripts/yfinance_query.py financials AAPL
# Quarterly income statement only
python3 scripts/yfinance_query.py financials AAPL --statement income --quarterly
# Balance sheet only
python3 scripts/yfinance_query.py financials AAPL --statement balance
# Cash flow only
python3 scripts/yfinance_query.py financials AAPL --statement cashflow
Full Company Profile
python3 scripts/yfinance_query.py info AAPL
Returns all available metadata: sector, industry, description, officers, full-year financials, etc.
Shareholders
python3 scripts/yfinance_query.py holders AAPL
Returns institutional holders, major holders breakdown, and insider transactions.
Analyst Recommendations & Price Targets
python3 scripts/yfinance_query.py analysts AAPL
Returns recent analyst recommendations (buy/hold/sell) and consensus price targets.
Dividend History
python3 scripts/yfinance_query.py dividends AAPL
Options Chain
# Nearest expiry (default)
python3 scripts/yfinance_query.py options AAPL
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-1shadow1-finance-data": {
"enabled": true,
"auto_update": true
}
}
}