Chittorgarh APIchittorgarh.com ↗

"""Walkthrough: Chittorgarh Financial API — IPO research workflow."""
from parse_apis.chittorgarh_financial_api import (
    Chittorgarh, IpoCategory, DashboardType, DashboardCategory, Exchange, IpoNotFound
)

client = Chittorgarh()

# Search for IPOs by company name, take the first match.
result = client.iposummaries.search(query="tata", limit=3)
ipo_summary = result.first()
if ipo_summary:
    print(ipo_summary.company_name, ipo_summary.urlrewrite_folder_name)

# Drill into full IPO details from the summary.
if ipo_summary:
    ipo = ipo_summary.details()
    print(ipo.title, ipo.url)
    for key, value in ipo.details.items():
        print(f"  {key}: {value}")

# Browse news for that IPO.
if ipo_summary:
    for article in ipo_summary.details().news(limit=3):
        print(article.title, article.date, article.source)

# List SME IPOs for a specific category and year.
for listing in client.ipolistings.list(category=IpoCategory.SME, limit=5):
    print(listing.company, listing.issue_price, listing.listing_at)

# Get live IPO subscription dashboard.
dashboard = client.dashboarddatas.get(type=DashboardType.SUBSCRIPTION, category=DashboardCategory.MAINLINE)
print(dashboard.panel_title)
for sub in dashboard.subscriptions[:3]:
    print(sub.company_name, sub.bid_value)

# Fetch SME stock prices from NSE.
for stock in client.stocks.list(exchange=Exchange.NSE, limit=5):
    print(stock.company_name, stock.ltp, stock.shares_traded)

# Handle a not-found IPO gracefully.
try:
    bad = client.iposummaries.search(query="nonexistent_xyz_12345", limit=1).first()
    if bad:
        bad.details()
except IpoNotFound as exc:
    print(f"IPO not found: slug={exc.slug}, ipo_id={exc.ipo_id}")

print("exercised: search / details / news / ipolistings.list / dashboarddatas.get / stocks.list")