open-market-data

# open-market-data (omd)

Unified CLI for free financial data. Queries 8 sources behind a single interface with automatic routing and fallback.

## Quick Reference

```bash
# Stock quotes
omd quote AAPL
omd quote AAPL MSFT GOOGL

# Search
omd search "Apple Inc"

# Financial statements
omd financials AAPL
omd financials AAPL -p quarterly -l 8

# Price history
omd history AAPL --days 90

# Earnings
omd earnings AAPL

# Dividends
omd dividends AAPL

# Options chain
omd options AAPL
omd options AAPL -t call

# SEC filings
omd filing AAPL --type 10-K --latest
omd filing TSLA --type 8-K -l 5

# Insider transactions
omd insiders AAPL

# Crypto
omd crypto BTC
omd crypto top 20
omd crypto history ETH -d 30

# Macroeconomic data
omd macro GDP
omd macro GDP --limit 12
omd macro search "unemployment rate"

# Output formats
omd --json quote AAPL
omd --plain quote AAPL

# Force specific source
omd quote AAPL --source finnhub
omd financials AAPL --source sec-edgar
omd macro NY.GDP.MKTP.CD --source worldbank

# Bypass cache
omd --no-cache quote AAPL

# See all sources and their status
omd sources

# Configure API keys
omd config set fredApiKey <key>
omd config show
```

## Sources

| Source | Key? | Best For |
|--------|------|----------|
| SEC EDGAR | No | Filings, XBRL financials, insider transactions |
| Yahoo Finance | No | Real-time quotes, price history, options, dividends |
| Binance | No | Crypto prices (non-US only) |
| CoinGecko | Free key | Crypto rankings, broader crypto coverage |
| FRED | Free key | GDP, unemployment, interest rates, 800K+ economic series |
| Finnhub | Free key | Real-time stock quotes, earnings data |
| Alpha Vantage | Free key | Stock quotes, financials, price history (25/day limit) |
| World Bank | No | Global economic indicators (GDP, unemployment, inflation) |

## When to Use --json

Use `--json` when you need to parse the output programmatically. Always place `--json` before the command:

```bash
omd --json quote AAPL
omd --json financials AAPL...