Global Stock Analysis

Use these workflows to research stocks, evaluate companies, read technical signals, and monitor macro conditions — all from the terminal.

Setup

1. Install: pip install marketdata-cli or uv tool install marketdata-cli --force or run directly with uvx marketdata-cli
2. Set API key (one of):
3. export ALPHAVANTAGE_API_KEY=your_key
4. Add ALPHAVANTAGE_API_KEY=your_key to a .env file
5. Pass -k your_key on each command

Get a free key at https://www.alphavantage.co/support/#api-key

Workflows

1. Quick Stock Lookup

Get a snapshot of where a stock is right now — price, recent history, and news.

marketdata-cli global_quote AAPL
marketdata-cli time_series_daily AAPL
marketdata-cli news_sentiment --tickers AAPL
# Optional: intraday detail
marketdata-cli time_series_intraday AAPL --interval 5min

2. Fundamental Analysis

Evaluate a company's financial health: overview, financials, earnings, dividends, and insider activity. See fundamentals.md for the full step-by-step guide.

3. Technical Analysis

Assess trend, momentum, volatility, and volume signals. See technicals.md for the full step-by-step guide.

4. Macro & Market Overview

Check economic conditions, commodities, market movers, and upcoming events. See macro.md for the full step-by-step guide.

5. Sector / Multi-Stock Comparison

Compare fundamentals or technicals across multiple tickers by running the same commands for each symbol:

marketdata-cli company_overview AAPL
marketdata-cli company_overview MSFT
marketdata-cli company_overview GOOGL

See comparison.md for more examples.

6. Forex & Crypto

Exchange rates and price history for currencies and cryptocurrencies. See forex-crypto.md for the full step-by-step guide.

Quick Reference

Run marketdata-cli --help for the full list of 100+ commands, or marketdata-cli <command> --help for any specific command.

• Most stock commands accept a positional SYMBOL argument (e.g., marketdata-cli global_quote AAPL)
• Forex commands use --from_symbol / --to_symbol or --from_currency / --to_currency
• Technical indicators default to daily interval if not specified