ticker.finology.in APIticker.finology.in ↗
Access Indian stock financials, price history, peer comparisons, IPO listings, and sector data from ticker.finology.in via a single REST API.
curl -X GET 'https://api.parse.bot/scraper/2d091d5f-c3e8-474c-8700-16c0ecc613a7/search_company?query=TATASTEEL' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for a company by name or ticker symbol to get identifiers like fincode, scripcode, and symbol. Returns all matching companies.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Company name or ticker symbol (e.g., 'TATASTEEL', 'Reliance') |
{
"type": "array",
"fields": {
"SYMBOL": "string — BSE/NSE ticker symbol",
"FINCODE": "integer — Finology internal company code",
"compname": "string — full company name",
"SCRIPCODE": "integer — BSE scrip code"
},
"sample": {
"data": [
{
"SYMBOL": "TATASTEEL",
"brands": "Tata Agrico, TATA Tiscon",
"FINCODE": 100470,
"compname": "Tata Steel Ltd.",
"SCRIPCODE": 500470,
"productlist": null,
"searchterms": ""
}
],
"status": "success"
}
}About the ticker.finology.in API
The Ticker Finology API covers 10 endpoints that expose Indian equity market data including company financials, historical BSE price charts, peer comparisons, IPO listings, and real-time market dashboard snapshots. Starting with search_company, you can resolve any company name or ticker symbol into a FINCODE, SCRIPCODE, and SYMBOL — identifiers required by most other endpoints. Data spans standalone and consolidated financial statements, quarterly P&L, cash flow, and sector-level company lists.
Company Lookup and Overview
Use search_company with a company name or NSE/BSE ticker (e.g., TATASTEEL, Reliance) to retrieve the FINCODE, SCRIPCODE, and SYMBOL fields that nearly every other endpoint requires. Once you have those, get_company_overview returns valuation multiples (pe, pb), profitability metrics (roe, roce), balance sheet snapshots (cash, debt), and intraday reference data like today_low — all keyed by ticker symbol.
Price History and Financial Statements
get_price_chart_data accepts symbol, fincode, and scripcode and returns an array of { Date, price } pairs representing BSE closing prices in INR. The count parameter controls how many years of history to fetch; only yearly granularity is supported. For fundamental data, get_financial_tables takes a ticker and an optional mode parameter (S for Standalone, C for Consolidated) and returns four arrays: quarterly P&L periods, cash_flow annual statements, annual_pl, and balance_sheet. Some arrays may be empty depending on what the company has filed.
Peer, Sector, and Market Data
get_peer_comparison accepts a fincode and returns competing companies in the same sector with fields including PE, PB, ROE, ROCE, mcap, and CLOSE_PRICE. To browse sectors, call get_sector_list (no parameters) to get a list of { name, slug } pairs, then pass a sector_slug to get_sector_details to retrieve every company in that sector along with MCAP, PE, PB, PerChange, and closing price. get_market_dashboard (no parameters) returns today's top_gainers, top_losers, and a featured indices array with intraday high data.
IPO and News
get_ipo_list returns IPO entries segmented into upcoming, current, and listed categories when data is available. get_company_news accepts a fincode and returns recent articles with Heading, Newsdate, NewsTime, and full HTML Details content — useful for event-driven analysis or news feed construction.
- Screen Indian equities by PE, PB, ROE, and ROCE across an entire sector using
get_sector_details - Build a BSE price history chart for any stock by fetching multi-year date-price pairs from
get_price_chart_data - Compare a company against its sector peers on market cap, return ratios, and valuation multiples via
get_peer_comparison - Monitor daily market movers by polling
get_market_dashboardfor top gainers and losers with intraday price data - Track upcoming and recently listed Indian IPOs for deal flow monitoring using
get_ipo_list - Aggregate standalone vs. consolidated quarterly P&L and annual cash flow for financial modeling via
get_financial_tables - Drive a company news feed with headline, publication date, and full article HTML from
get_company_news
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Ticker Finology offer an official developer API?+
What does `get_financial_tables` return, and how do I get consolidated vs. standalone data?+
quarterly (quarterly P&L periods), cash_flow (annual cash flow statements), annual_pl, and balance_sheet. Pass mode=S for standalone financials or mode=C for consolidated. Note that annual_pl and balance_sheet may be empty arrays for some companies depending on available filings.Does `get_price_chart_data` support intraday or weekly price granularity?+
count parameter. Intraday and weekly intervals are not currently available. You can fork this API on Parse and revise it to add an endpoint targeting a different time resolution if the source exposes one.Is dividend history or shareholding pattern data available through this API?+
Does `get_company_overview` return NSE prices as well as BSE prices?+
pe, pb, eps, roe, cash, debt, roce, today_low) are returned as strings without explicit exchange attribution. Price chart data via get_price_chart_data is documented as BSE-sourced. NSE-specific price feeds are not separately exposed. You can fork the API on Parse and revise it to surface exchange-labeled price fields if they become distinguishable in the source data.