Metadata-Version: 2.4
Name: magiqa-finance
Version: 0.3.0
Summary: Python library for accessing Magiqa Finance API - comprehensive stock data, fundamentals, technical indicators, historical data, and options chains
Home-page: https://github.com/magiqa/magiqa-finance-python
Author: Magiqa
Author-email: support@magiqa.com
Project-URL: Documentation, https://docs.magiqa.com
Project-URL: Source, https://github.com/magiqa/magiqa-finance-python
Project-URL: Tracker, https://github.com/magiqa/magiqa-finance-python/issues
Keywords: finance,stocks,trading,api,financial data,technical indicators,fundamentals
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: Topic :: Office/Business :: Financial :: Investment
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.28.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: black>=22.0.0; extra == "dev"
Requires-Dist: flake8>=5.0.0; extra == "dev"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license-file
Dynamic: project-url
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# Magiqa Finance Python Library

[![Python Version](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://www.python.org/downloads/)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)

Python library for accessing the Magiqa Finance API - comprehensive stock data, fundamentals, technical indicators, historical data, and options chains.

## Installation

```bash
pip install magiqa-finance
```

## Quick Start

### 1. Get Your API Key

Register at [https://options.magiqa.us/register](https://options.magiqa.us/register) and generate an API key.

### 2. Basic Usage

```python
import magiqa

# Initialize client with your API key
client = magiqa.Client(api_key="your-api-key-here")

# Get fundamental data
data = client.fundamentals("AAPL")
print(f"Price: ${data['price']}")
print(f"Market Cap: ${data.get('market_cap', 'N/A')}")

# Get technical indicators
technical = client.technical("AAPL")
print(f"RSI: {technical.get('rsi', 'N/A')}")

# Get financial statements
financials = client.financials("AAPL")

# Get historical data
hist = client.historical_data("AAPL", start_date="2024-01-01", end_date="2024-01-31")

# Get options chain
options = client.options("AAPL", "2024-02-16")
```

### 3. Using Environment Variables

```bash
export MAGIQA_API_KEY="your-api-key-here"
```

```python
import magiqa

client = magiqa.Client()  # Uses MAGIQA_API_KEY from environment
data = client.fundamentals("AAPL")
```

## Features

- **Fundamental Data**: Get comprehensive stock fundamentals including price, market cap, P/E ratio, and more
- **Technical Indicators**: Access RSI, MACD, moving averages, and trend analysis
- **Financial Statements**: Retrieve income statements, balance sheets, and cash flow statements
- **Historical Data**: Fetch historical price data with customizable date ranges
- **Options Chains**: Get complete options chains with Greeks (delta, gamma, theta, vega)

## Documentation

For detailed documentation, see [magiqa/README.md](magiqa/README.md) or visit [https://options.magiqa.us](https://options.magiqa.us).

## Requirements

- Python 3.8+
- requests >= 2.28.0

## License

MIT License - see [LICENSE](LICENSE) file for details.

## Support

- Documentation: [https://options.magiqa.us](https://options.magiqa.us)
- Issues: [https://github.com/magiqa/magiqa-finance-python/issues](https://github.com/magiqa/magiqa-finance-python/issues)
- Email: support@magiqa.com
