Agent skill · business finance · nousresearch
stocks
Stock quotes, history, search, compare, crypto via Yahoo.
Why this skill is useful
Provides domain-specific commands for retrieving stock and crypto market data that the AI wouldn't generate on its own.
What it needs
About 2k tokens when loaded. Last updated 2026-08-07. 226,679 stars on the source repository.
What this skill does
Stocks Skill Read-only market data via Yahoo Finance. Five commands: quote, search, history, compare, crypto. Python stdlib only — no API key, no pip installs. Yahoo's endpoint is unofficial and may rate-limit or change. When to Use User asks for a current stock price (AAPL, TSLA, MSFT, ...) User wants to look up a ticker by company name User wants OHLCV history or performance over a date range User wants to compare several tickers side by side User asks for a crypto price (BTC, ETH, SOL, ...) Prerequisites Python 3.8+ stdlib only. Optional: set ALPHAVANTAGEKEY to enrich marketcap, peratio, and 52-week levels when Yahoo's crumb-protected fields come back null. Free key: https://www.alphavantage.co/support/#api-key How to Run Invoke through the terminal tool. Once installed: All output is JSON on stdout — pipe through jq if you want to slice it. Quick Reference Commands quote SYMBOL [SYMBOL2 ...] Current price, change, change%, volume, 52-week high/low. search QUERY Find tickers by company name. Returns top 5: symbol, name, exchange, type. history SYMBOL [--range RANGE] Daily OHLCV plus stats (min, max, avg, total return %). Ranges: 1mo, 3mo, 6mo, 1y, 5y. Default: 1mo. compare SYMBOL1 SYMBOL2 [...] Side-by-side: price, change%, 52-week performance. crypto SYMBOL [SYMBOL2 ...] Crypto prices. Pass BTC (the script appends -USD automatically). Pitfalls Yahoo Finance's API is unofficial. Endpoints can change or rate-limit without notice — if requests start failing, that's why. marketcap and peratio may return null on quote when Yahoo's crumb session isn't established. Set ALPHAVANTAGEKEY to backfill. Add a small delay between bulk requests to avoid rate-limiting. This is read-only — no order placement, no account integration. Verification Returns a JSON object with symbol: "AAPL" and a numeric price field.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills nousresearch/stocks