Global Stock Analysis

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

Tutorial

Watch the end-to-end installation tutorial, from procuring a fresh Mac VM (or Mac mini), to installing OpenClaw, to installing and using the skill: https://www.youtube.com/watch?v=Z6DjYKN4uos

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):
   • export ALPHAVANTAGE_API_KEY=your_key
   • Add ALPHAVANTAGE_API_KEY=your_key to a .env file
   • 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.

7. Options Chain

Inspect US options chains, greeks, and put/call sentiment — realtime or historical.

marketdata-cli realtime_options AAPL
marketdata-cli realtime_options AAPL --require_greeks --expiration 2026-06-19
marketdata-cli realtime_options_fmv AAPL --expiration 2026-06-19
marketdata-cli realtime_put_call_ratio SPY
marketdata-cli historical_options AAPL --date 2024-01-15
marketdata-cli historical_put_call_ratio SPY --date 2024-01-15

See options.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.

| Flag | Description | |------|-------------| | -k, --api-key | API key (overrides env var) | | -v, --verbose | Enable verbose logging | | -h, --help | Show help for any 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