# Welcome to PyAlpacaAPI Documentation

**PyAlpacaAPI** is a modern Python wrapper for the Alpaca Trading API that provides complete trading operations, market data access, and stock analysis tools with full type safety.

## Features

- 🔒 **Full Type Safety**: Complete type annotations with mypy strict mode
- 📊 **Trading Operations**: Orders, positions, and account management
- 📈 **Market Data**: Historical data, real-time quotes, and news
- 🤖 **Analysis Tools**: Stock screeners, ML predictions, sentiment analysis
- 🚀 **High Performance**: Built-in caching with LRU and Redis support
- 📦 **Batch Operations**: Automatic batching for multi-symbol data fetching
- 🔄 **Feed Management**: Automatic subscription detection and fallback

```{toctree}
:caption: Getting Started
:maxdepth: 2

installation
quickstart
configuration
```

```{toctree}
:caption: User Guide
:maxdepth: 2

trading/index
stock/index
caching
feed_management
error_handling
```


```{toctree}
:caption: API Reference
:maxdepth: 2

api/index
```

```{toctree}
:caption: Examples
:maxdepth: 2

notebooks/usage
examples/index
```

```{toctree}
:caption: Development
:maxdepth: 2

contributing
changelog
```

## Indices and Tables

- {ref}`genindex`
- {ref}`modindex`
- {ref}`search`