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#

bash

# 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#

bash

# 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#

CommandDescriptionquote <symbol>Real-time stock quotesearch <query>Search for ticker symbolsintraday <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 seriesmonthly <symbol>Monthly time seriesoverview <symbol>Company fundamentalsmoversTop gainers, losers, most activenews [--topic <t>] [--symbol <s>]News & sentimentforex <from> <to>Currency exchange ratecrypto <symbol> <market>Cryptocurrency pricecommodity <name>Commodity prices (oil, gold, silver, wheat, etc.)gdpReal GDPcpiConsumer Price IndexinflationInflation ratetreasuryTreasury yieldinterestFederal funds rate<indicator> <symbol>Technical indicators (sma, ema, rsi, macd, bbands, adx)

Technical Indicators#

IndicatorCommandKey ParamsSMAsma``--time-period, --intervalEMAema``--time-period, --intervalRSIrsi``--time-period, --intervalMACDmacd``--intervalBollinger Bandsbbands``--time-period, --intervalADXadx``--time-period, --intervalATRatr``--time-period, --intervalStochasticstoch``--intervalOBVobv``--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.