--- name: openbb description: "Stock market data via OpenBB SDK. Get quotes, financials, ratios, dividends, earnings, estimates, ownership, technicals, and valuations. Use when user asks about stocks, tickers (AAPL, MSFT, etc.), stock prices, financial ratios, P\/E, dividends, analyst targets, or equity research." metadata: {"openclaw":{"emoji":"📈","requires":{"bins":["jq"],"env":[]}}} --- # 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 \/scripts\/openbb-quote AAPL # Get key ratios \/scripts\/openbb-ratios AAPL ``` ### Multiple Tickers ```bash # openbb-quote supports multiple tickers \/scripts\/openbb-quote AAPL MSFT GOOGL ``` ### Specify Provider ```bash # Default is yfinance (free), can specify fmp\/intrinio \/scripts\/openbb-quote AAPL fmp ``` ### Financial Statements ```bash # Income statement, 5 years \/scripts\/openbb-financials AAPL income 5 # Cash flow statement, 3 years \/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):** 1. Sign up at [financialmodelingprep.com](https:\/\/site.financialmodelingprep.com\/register) 2. Set environment variable: `export FMP_API_KEY="your_key"` See [FMP pricing](https:\/\/site.financialmodelingprep.com\/developer\/docs\/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 \/scripts\/openbb-quote AAPL \/scripts\/openbb-ratios AAPL ``` ### Dividend Analysis User: "Is JNJ a good dividend stock?" ```bash \/scripts\/openbb-dividend JNJ \/scripts\/openbb-financials JNJ cash 3 # Check FCF coverage ``` ### Earnings Preview User: "When does GOOGL report earnings?" ```bash \/scripts\/openbb-earnings GOOGL \/scripts\/openbb-estimates GOOGL ``` ### Valuation Check User: "Is NVDA overvalued?" ```bash \/scripts\/openbb-valuation NVDA \/scripts\/openbb-ratios NVDA \/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.