OpenBB Stock Data Skill 📈

Fetch stock market data using OpenBB SDK CLI wrappers. All output is JSON.

Quick Reference

Command	Description	Example
`openbb-quote`	Current price, OHLCV (multi-ticker)	`openbb-quote AAPL`
`openbb-get-quote`	Current price (single ticker)	`openbb-get-quote AAPL`
`openbb-ratios`	P/E, margins, ROE, debt	`openbb-ratios MSFT`
`openbb-financials`	Income/cash flow statements	`openbb-financials GOOGL income 5`
`openbb-growth-profile`	Revenue/earnings growth	`openbb-growth-profile NVDA`
`openbb-dividend`	Yield, history, safety	`openbb-dividend JNJ`
`openbb-estimates`	Analyst targets, recommendations	`openbb-estimates TSLA`
`openbb-earnings`	Next earnings + EPS history	`openbb-earnings AMZN`
`openbb-quality`	Quality score (0-10)	`openbb-quality META`
`openbb-valuation`	Fair value estimates	`openbb-valuation NFLX`
`openbb-volatility`	Beta, Sharpe, drawdown	`openbb-volatility AMD`
`openbb-technicals`	SMA 50/200, cross signals	`openbb-technicals SPY`
`openbb-historical`	Price returns (1y/3y/5y)	`openbb-historical AAPL 1y`
`openbb-metrics`	Key valuation multiples	`openbb-metrics COST`
`openbb-ev-ntm`	EV/NTM revenue	`openbb-ev-ntm CRM`
`openbb-profile`	Company info	`openbb-profile DIS`
`openbb-ownership`	Institutional ownership	`openbb-ownership AAPL`

Usage Patterns

Single Stock Query

bash

# Get current quote
<skill>/scripts/openbb-quote AAPL

# Get key ratios
<skill>/scripts/openbb-ratios AAPL

Multiple Tickers

bash

# openbb-quote supports multiple tickers
<skill>/scripts/openbb-quote AAPL MSFT GOOGL

Specify Provider

bash

# Default is yfinance (free), can specify fmp/intrinio
<skill>/scripts/openbb-quote AAPL fmp

Financial Statements

bash

# Income statement, 5 years
<skill>/scripts/openbb-financials AAPL income 5

# Cash flow statement, 3 years  
<skill>/scripts/openbb-financials AAPL cash 3

Data Providers

yfinance (Default - Free, No API Key)

All tools use yfinance by default. Works for quotes, financials, ratios, dividends, estimates, technicals.

FMP (Optional - Enhanced Data)

Some tools benefit from FMP for additional data:

Tool	Without FMP	With FMP
`openbb-earnings`	Next earnings date only	+ Historical EPS with beat/miss
`openbb-ownership`	Falls back to intrinio/sec	Full institutional data
`openbb-estimates`	yfinance consensus	Enhanced estimates

Setup FMP (optional):

•Sign up at financialmodelingprep.com
•Set environment variable: export FMP_API_KEY="your_key"

See FMP pricing for tier details.

Output Formatting

All scripts output JSON. When presenting to users:

For chat channels: Summarize key metrics in natural language, e.g.:

AAPL is trading at $259.48 (+0.46%). P/E: 32.9, Dividend yield: 0.4%. Analysts rate it a BUY with average target $291 (+12% upside).

For detailed analysis: Format as markdown table or structured list.

Common Workflows

Quick Stock Check

User: "How's Apple doing?"

bash

<skill>/scripts/openbb-quote AAPL
<skill>/scripts/openbb-ratios AAPL

Dividend Analysis

User: "Is JNJ a good dividend stock?"

bash

<skill>/scripts/openbb-dividend JNJ
<skill>/scripts/openbb-financials JNJ cash 3  # Check FCF coverage

Earnings Preview

User: "When does GOOGL report earnings?"

bash

<skill>/scripts/openbb-earnings GOOGL
<skill>/scripts/openbb-estimates GOOGL

Valuation Check

User: "Is NVDA overvalued?"

bash

<skill>/scripts/openbb-valuation NVDA
<skill>/scripts/openbb-ratios NVDA
<skill>/scripts/openbb-growth-profile NVDA

Requirements

•Python 3.11+ with OpenBB SDK (pip install openbb)
•jq (used by openbb-quote for multi-ticker support)
•NixOS: Scripts handle LD_LIBRARY_PATH automatically

Troubleshooting

"No such file" errors: Ensure OpenBB venv exists at /home/art/.local/venvs/openbb/

Empty results: Some endpoints need paid FMP subscription. Check the "Data Providers" section.

Timeout: Some queries are slow on first run (SDK initialization). Retry usually works.