Stock Market Data

Access real-time and historical stock market data via the Alpha Vantage API. Covers stocks, forex, crypto, commodities, economic indicators, and technical analysis.

API: https://www.alphavantage.co Free tier: 25 requests/day (no key needed for demo)

Setup

# Set your API key (get free at alphavantage.co/support/#api-key)
export ALPHA_VANTAGE_KEY="your-api-key-here"

# Or pass with --key
python3 scripts/stock_data.py quote AAPL --key "your-key"

Quick Start

# Get current stock quote
python3 scripts/stock_data.py quote AAPL

# Search for a ticker
python3 scripts/stock_data.py search "Apple"

# Historical daily data
python3 scripts/stock_data.py daily AAPL --output-size compact

# Intraday data (5-min intervals)
python3 scripts/stock_data.py intraday AAPL --interval 5min

# Company overview
python3 scripts/stock_data.py overview AAPL

# Top gainers and losers
python3 scripts/stock_data.py movers

# Forex exchange rate
python3 scripts/stock_data.py forex USD CAD

# Crypto price
python3 scripts/stock_data.py crypto BTC USD

# Technical indicator
python3 scripts/stock_data.py sma AAPL --interval daily --time-period 50

# Economic indicator
python3 scripts/stock_data.py gdp

# Commodity price
python3 scripts/stock_data.py commodity oil

Commands Reference

| Command | Description | |---------|-------------| | quote <symbol> | Real-time stock quote | | search <query> | Search for ticker symbols | | intraday <symbol> | Intraday time series (opts: --interval 1/5/15/30/60min) | | daily <symbol> | Daily time series (opts: --output-size compact/full) | | weekly <symbol> | Weekly time series | | monthly <symbol> | Monthly time series | | overview <symbol> | Company fundamentals | | movers | Top gainers, losers, most active | | news [--topic <t>] [--symbol <s>] | News & sentiment | | forex <from> <to> | Currency exchange rate | | crypto <symbol> <market> | Cryptocurrency price | | commodity <name> | Commodity prices (oil, gold, silver, wheat, etc.) | | gdp | Real GDP | | cpi | Consumer Price Index | | inflation | Inflation rate | | treasury | Treasury yield | | interest | Federal funds rate | | <indicator> <symbol> | Technical indicators (sma, ema, rsi, macd, bbands, adx) |

Technical Indicators

| Indicator | Command | Key Params | |-----------|---------|------------| | SMA | sma | --time-period, --interval | | EMA | ema | --time-period, --interval | | RSI | rsi | --time-period, --interval | | MACD | macd | --interval | | Bollinger Bands | bbands | --time-period, --interval | | ADX | adx | --time-period, --interval | | ATR | atr | --time-period, --interval | | Stochastic | stoch | --interval | | OBV | obv | --interval |

Output

All commands output JSON by default. Add --csv for CSV format.

Data Sources

All data from Alpha Vantage (alphavantage.co). Free API key required — get one at alphavantage.co/support/#api-key. Free tier allows 25 requests/day.