jyapystock 0.3.0

Fetch live and historical stock prices for Indian and American exchanges.

jyapystock

A Python library to fetch live and historical prices for Indian and American stocks.

Status Badges

Features

• Live price and historical price support with timestamp and % change data
• Indian (NSE) and American (NYSE/NASDAQ) stocks
• Multiple data sources: yfinance, NASDAQ, NSE (for India), Alpha Vantage (optional API key)
• Auto-fallback: tries available sources in order based on country and API key availability
• Country support: India and USA with automatic symbol variant detection (e.g., .NS, .BO for Indian stocks)

Installation

pip install jyapystock

Installation for Development

To install locally for development:

# Install editable for development
pip install -e .

# Or install for local use
pip install .

For development and CI reproducibility, install pinned dev dependencies:

pip install -r requirements-dev.txt

Usage

Basic Usage - USA Stocks

from jyapystock import StockPriceProvider

# Using yfinance (default)
provider = StockPriceProvider(country="USA")
result = provider.get_live_price("AAPL")
# Returns: {'timestamp': '2025-12-24T00:00:00-05:00', 'price': 273.81, 'change_percent': 0.53}

Indian Stocks with NSE

from jyapystock import StockPriceProvider

# Using NSE (National Stock Exchange)
provider = StockPriceProvider(country="India", source="nse")
result = provider.get_live_price("SBIN")
# Returns: {'timestamp': '24-Dec-2025 16:00:00', 'price': 968.85, 'change_percent': -0.31}

# Using yfinance for India (auto-tries .NS and .BO variants)
provider = StockPriceProvider(country="India")
result = provider.get_live_price("RELIANCE")

Historical Data

# Get historical prices
hist = provider.get_historical_price("AAPL", "2023-01-01", "2023-01-31")
# Returns list of records with date/open/high/low/close/volume

Using NASDAQ Provider

provider = StockPriceProvider(country="USA", source="nasdaq")
result = provider.get_live_price("AAPL")

Using Alpha Vantage (requires API key)

provider = StockPriceProvider(
    country="USA", 
    source="alphavantage", 
    alpha_vantage_api_key="YOUR_API_KEY"
)
result = provider.get_live_price("AAPL")

Supported Sources

• yfinance: Free, supports most global stocks (USA & India)
• NASDAQ: Free, USA stocks only
• NSE: Free, Indian stocks only (via National Stock Exchange)
• Alpha Vantage: Free tier with limits, requires API key, supports global stocks
• NYSE: Free, USA stocks only

Testing

python -m unittest discover tests

# Run provider-specific tests
PROVIDER=yfinance python -m unittest discover tests
PROVIDER=nse python -m unittest discover tests
PROVIDER=nasdaq python -m unittest discover tests
PROVIDER=alphavantage python -m unittest discover tests

License

MIT