stocks

Fetch stock quotes, price history, and crypto prices from Yahoo Finance via CLI.

Updated Aug 22, 2026
One-click install
npx skills add https://github.com/vivekgoquest/hermes-agent-stable --skill stocks-vivekgoquest
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: stocks
Source: https://github.com/vivekgoquest/hermes-agent-stable/tree/main/optional-skills/finance/stocks
Command: npx skills add https://github.com/vivekgoquest/hermes-agent-stable --skill stocks-vivekgoquest

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Getting quick market data usually requires signing up for API keys, installing SDKs, or paying for data feeds. This Skill retrieves stock quotes, historical prices, ticker search, comparisons, and crypto prices using only Python's standard library and Yahoo Finance's public endpoints. ## Core Features & Use Cases - Real-Time Quotes: Get current price, change, volume, and 52-week high/low for one or more tickers like AAPL, TSLA, or MSFT. - History & Comparison: Pull daily OHLCV history over ranges from 1 month to 5 years with summary stats, or compare multiple tickers side by side. - Crypto Prices: Query crypto prices such as BTC, ETH, and SOL with automatic -USD suffix handling. - Use Case: Ask for a comparison of AAPL, MSFT, and GOOGL and receive a JSON table with price, change percentage, market cap, and 52-week performance for each. ## Quick Start Ask the agent to get the current stock quote for AAPL using the stocks skill.

Frequently Asked Questions about stocks

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get a stock quote from the command line in Python?▼

Run the stocks_client.py script with the quote command followed by one or more ticker symbols, such as python stocks_client.py quote AAPL MSFT. It returns JSON with price, change, volume, and 52-week high/low from Yahoo Finance.

How to fetch historical stock prices without an API key?▼

Use the history command with a symbol and a range flag like --range 6mo. The script queries Yahoo Finance's unofficial chart endpoint and returns daily OHLCV data plus min, max, average, and total return statistics.

Does this stock tool require installing Python packages?▼

No external packages are required. The script uses only the Python 3.8+ standard library, including urllib, json, and argparse, so it runs without pip installs or virtual environments.

Why do market cap and PE ratio return null for some quotes?▼

Yahoo Finance protects those fields behind a crumb session that sometimes fails to establish. Set the ALPHA_VANTAGE_KEY environment variable with a free Alpha Vantage key to backfill market cap, PE ratio, and 52-week levels.

Can I use this for crypto prices like Bitcoin?▼

Yes, the crypto command accepts symbols like BTC, ETH, or SOL and automatically appends -USD before querying Yahoo Finance. You can change the quote currency with the --vs flag, for example --vs EUR.

What are the limitations of the Yahoo Finance API approach?▼

Yahoo's endpoints are unofficial and can rate-limit or change without notice, causing requests to fail. The tool is read-only with no order placement or account integration, and bulk requests should include small delays.