Stockmarket

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 | Real-time stock quote | | search | Search for ticker symbols | | intraday | Intraday time series (opts: --interval 1/5/15/30/60min) | | daily | Daily time series (opts: --output-size compact/full) | | weekly | Weekly time series | | monthly | Monthly time series | | overview | Company fundamentals | | movers | Top gainers, losers, most active | | news [--topic ] [--symbol ] | News & sentiment | | forex | Currency exchange rate | | crypto | Cryptocurrency price | | commodity | Commodity prices (oil, gold, silver, wheat, etc.) | | gdp | Real GDP | | cpi | Consumer Price Index | | inflation | Inflation rate | | treasury | Treasury yield | | interest | Federal funds rate | | | 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.

# 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

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