Magiqa Finance Python Library

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

Installation

pip install magiqa-finance

Quick Start

1. Get Your API Key

Register at https://options.magiqa.us/register and generate an API key.

2. Basic Usage

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

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

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)
• Free-tier strategies: covered_call / naked_put helpers for flagship symbols (see options.magiqa.us/pricing)

Documentation

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

Internal project docs (marketing, publishing, architecture) live in docs/ locally; see docs/DOCS_INDEX.md.

Requirements

• Python 3.8+
• requests >= 2.28.0

License

MIT License - see LICENSE file for details.

Support

• Documentation: https://options.magiqa.us
• Issues: https://github.com/magiqa/magiqa-finance-python/issues
• Email: info@magiqa.us