yahooquery

# yahooquery Skill

Comprehensive access to Yahoo Finance data via the `yahooquery` Python library. This library provides programmatic access to nearly all Yahoo Finance endpoints, including real-time pricing, fundamentals, analyst estimates, options, news, and premium research.

## Core Classes

### 1. **Ticker** (Company-Specific Data)
The primary interface for retrieving data about one or more securities.

```python
from yahooquery import Ticker

# Single or multiple symbols
aapl = Ticker('AAPL')
tickers = Ticker('AAPL MSFT NVDA', asynchronous=True)
```

### 2. **Screener** (Predefined Stock Lists)
Access to pre-built screeners for discovering stocks by criteria.

```python
from yahooquery import Screener

s = Screener()
screeners = s.available_screeners  # List all available screeners
data = s.get_screeners(['day_gainers', 'most_actives'], count=10)
```

### 3. **Research** (Premium Subscription Required)
Access proprietary research reports and trade ideas.

```python
from yahooquery import Research

r = Research(username='you@email.com', password='password')
reports = r.reports(report_type='Analyst Report', report_date='Last Week')
trades = r.trades(trend='Bullish', term='Short term')
```

---

## Ticker Class: Data Modules

The `Ticker` class exposes dozens of data endpoints via properties and methods.

### 📊 **Financial Statements**
- `.income_statement(frequency='a', trailing=True)` - Income statement (annual/quarterly)
- `.balance_sheet(frequency='a', trailing=True)` - Balance sheet
- `.cash_flow(frequency='a', trailing=True)` - Cash flow statement
- `.all_financial_data(frequency='a')` - Combined financials + valuation measures
- `.valuation_measures` - EV/EBITDA, P/E, P/B, P/S across periods

### 📈 **Pricing & Market Data**
- `.price` - Current pricing, market cap, 52-week range
- `.history(period='1y', interval='1d', start=None, end=None)` - Historical OHLC
  - **period**: `1d`, `5d`, `1mo`, `3mo`, `6mo`, `1y`, `2y`, `5y`, `10y`, `ytd`, `max`
  - **int...