financeindia 0.1.0a1

A high-performance, lightweight Python library written in Rust for fetching Indian financial market data (NSE).

financeindia

financeindia is a high-performance, lightweight Python library written in Rust for fetching Indian financial market data (NSE) with ease.

Why financeindia?

• Blazing Fast: Powered by Rust, providing efficient data parsing and networking.
• Lightweight: Minimal dependencies, focus on performance and reliability.
• Session Caching: Intelligent session management to avoid redundant requests and minimize rate-limiting risk.
• Comprehensive: Access to equity lists, historical data, bhavcopies, indices, and real-time quotes.

Installation

pip install financeindia

Quickstart

import financeindia
import json

# Initialize the client
client = financeindia.FinanceClient()

# Recommended: initialize the session once
client._initialize_session()

# Get market status
status = client.get_market_status()
print(json.loads(status))

# Fetch historical data for a stock
data = client.price_volume_data("RELIANCE", "01-03-2025", "05-03-2025")
print(data)

# Fetch current quote
quote = client.get_equity_quote("RELIANCE")
print(json.loads(quote))

# Fetch Corporate Financial Results (Quarterly/Annual)
# 1. Get metadata representing filings
results_meta = client.get_financial_results("RELIANCE", "01-01-2024", "07-03-2026", "Annual")
results = json.loads(results_meta)

# 2. Parse the XBRL detail for a specific filing
if results:
    xbrl_url = results[0]['xbrl']
    financial_details = client.get_financial_details(xbrl_url)
    print(json.loads(financial_details)) # Exhaustive financial data points

Features

• Capital Markets: Equity lists (All & Nifty 50), historical price/volume, deliverable positions.
• Financial Results (Advanced): Exhaustive XBRL parsing for Quarterly and Annual results, providing 500+ data points including Balance Sheets and P&L.
• Bulk & Block Deals: Track large institutional trades.
• Bhavcopy: Full daily trading data in UDiFF format.
• Indices: Comprehensive list of all NSE indices and their constituents.
• Live Analysis: Top gainers, top losers, and most active securities.
• Derivatives: Real-time option chain data for symbols and indices.
• Market Info: Holidays, corporate actions, and overall market status.

Performance Highlights

financeindia implements a thread-safe session caching mechanism. The connection to NSE is refreshed only once every 15 minutes or when the session expires, ensuring that multiple API calls are as fast as possible.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for details.