yahoo-finance

name yahoo-finance description Financial data from Yahoo Finance: stock/bond prices, credit analysis, macro dashboard, FX rates, ETF flows, fundamentals, and news. Use when the user asks about stock prices, bond yields, credit metrics, leverage ratios, debt/ebitda, interest coverage, macro indicators (VIX, DXY, treasury yields, oil, gold, BTC), LatAm FX (ARS, BRL, CLP, MXN, COP), ETF holdings, income statements, balance sheets, cash flow, financial news, options chains, dividend history, or analyst ratings/upgrades. Commands: yf price, yf quote, yf compare, yf credit, yf macro, yf fx, yf flows, yf history, yf fundamentals, yf news, yf search, yf options, yf dividends, yf ratings. license MIT compatibility Requires Python 3.10+ and uv allowed-tools Read Bash(yf:*) metadata {"author":"0juano","version":"1.0.0","openclaw":{"emoji":"📈","requires":{"bins":"[Truncated]"},"install":["[Truncated]"]}} Yahoo Finance CLI Financial data terminal powered by Yahoo Finance. All commands via the yf script. Setup The script is at {baseDir}/scripts/yf . It uses uv run --script with inline PEP 723 metadata — dependencies install automatically on first run. chmod +x {baseDir}/scripts/yf Commands Command Purpose Example yf price TICKER Quick price + change + volume yf price YPF yf quote TICKER Detailed quote (52w, PE, yield) yf quote AAPL yf compare T1,T2,T3 Side-by-side comparison table yf compare YPF,PAM,GGAL yf credit TICKER Credit analysis: leverage, coverage, debt maturity yf credit YPF yf macro Morning macro dashboard (UST, DXY, VIX, oil, gold, BTC, ARS) yf macro yf fx [BASE] LatAm FX rates (ARS, BRL, CLP, MXN, COP) yf fx USD yf flows ETF ETF top holdings + fund data yf flows EMB yf history TICKER [PERIOD] Price history (1d/5d/1mo/3mo/6mo/1y/ytd/max) yf history YPF 3mo yf fundamentals TICKER Full financials (IS, BS, CF) yf fundamentals YPF yf news TICKER Recent news headlines yf news YPF yf search QUERY Find tickers yf search "argentina bond" All commands support --json for machine-readable output. When to Use Which Command Morning check : yf macro → get UST yields, DXY, VIX, commodities, BTC, ARS in one shot Quick look : yf price TICKER → fast price/change/volume Deep dive equity : yf quote → yf fundamentals → yf history Credit analysis : yf credit TICKER → leverage ratios, interest coverage, debt breakdown EM/LatAm FX : yf fx → all major LatAm pairs vs USD ETF research : yf flows ETF → top holdings, AUM, expense ratio Comparison : yf compare → side-by-side for relative value Error Handling The script handles bad tickers, missing data, and rate limits gracefully with clear error messages. If Yahoo Finance rate-limits, wait a moment and retry. Output By default, output uses Rich tables for clean terminal display. Add --json to any command for structured JSON output suitable for piping or further processing.