stocks

Run the stocks_client.py script with the quote command followed by one or more ticker symbols, such as python3 stocks_client.py quote AAPL MSFT. It prints JSON with price, change, volume, and 52-week levels using only the Python standard library.

Use the history command with a ticker and a range like 1mo, 6mo, or 5y, for example python3 stocks_client.py history NVDA --range 6mo. It queries Yahoo Finance's public chart endpoint and returns daily OHLCV data plus min, max, average, and total return stats.

No external packages are required. The script uses only Python 3.8+ standard library modules like urllib, json, and argparse, so there is nothing to pip install and no mandatory API key.

Yahoo Finance protects some quote fields behind a crumb session, so market_cap and pe_ratio can come back null. Setting the ALPHA_VANTAGE_KEY environment variable backfills those fields from Alpha Vantage's free API.

Yes, the crypto command accepts symbols like BTC, ETH, or SOL and automatically appends -USD before querying Yahoo Finance. You can also pass --vs EUR to quote against a different currency.

Yahoo's endpoints are unofficial and can rate-limit, change, or break without notice, so requests may intermittently fail. The tool is also strictly read-only with no order placement or brokerage account integration.