Ticker APIticker.finology ↗
Access Indian stock data via the Ticker Finology API: financials, balance sheets, shareholding patterns, price history, and corporate actions for NSE-listed companies.
What is the Ticker API?
The Ticker Finology API covers 6 endpoints that expose Indian equity market data for NSE and BSE listed companies. Starting with search_company, you can resolve any company name, NSE symbol, or BSE scrip code into a canonical identifier, then pull valuation ratios, five years of financial statements, shareholding breakdowns by category, daily price history up to five years back, and a full corporate actions history including dividends, bonus issues, and rights offerings.
curl -X GET 'https://api.parse.bot/scraper/cb3e5a32-a71d-48bc-9ec2-3f9b526a171f/search_company?query=Reliance' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for Indian listed companies by name, ticker symbol, or brand. Returns matching companies with their NSE symbol, BSE scrip code, and fincode identifiers. Results typically include 1-15 matches.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search term: company name, NSE symbol, BSE code, or brand name (e.g. 'Reliance', 'TCS', 'Jio'). |
{
"type": "object",
"fields": {
"total": "integer count of results",
"results": "array of company objects with company_name, symbol, scrip_code, fincode, brands"
},
"sample": {
"data": {
"total": 1,
"results": [
{
"brands": "CHROMA, IGNIO, JILE, QUARTZ, TAP",
"symbol": "TCS",
"fincode": 132540,
"scrip_code": 532540,
"company_name": "Tata Consultancy Services Ltd."
}
]
},
"status": "success"
}
}About the Ticker API
Company Search and Overview
The search_company endpoint accepts a free-text query — company name, NSE symbol, BSE code, or brand — and returns up to 15 matches, each carrying company_name, symbol, scrip_code, fincode, and brands. The fincode identifier is used internally by Finology and appears across other response objects. get_company_overview accepts an NSE symbol and returns a snapshot of valuation and profitability metrics: pe_ratio, pb_ratio, eps_ttm, roe, roce, debt, face_value, sector, and more — all in one response.
Financials and Balance Sheet
get_financials returns four statement types in a single call: quarterly_results (last 5 quarters, fields like Net Sales, Operating Profit, Profit After Tax), yearly_pnl (last 5 fiscal years), balance_sheet (Share Capital, Reserves, Borrowings, and asset line items), and cash_flows (Operating, Investing, and Financing cash flow by fiscal year). All figures are in Crores (Cr.). The PARTICULARS field in each array row names the line item, and column keys correspond to the period.
Shareholding and Price History
get_shareholding returns two objects: current_holding (an array of category/percentage pairs for Promoters, DII, FII, Public, and Others) and quarterly_details (individual entity-level holdings across the last 5 quarters). get_price_history accepts a symbol and an optional period parameter (1–5 years, defaulting to 1) and returns an array of date/price objects representing daily BSE closing prices in INR, plus a total count and the period_years used.
Corporate Actions
get_corporate_actions returns three arrays for a given NSE symbol: dividends (with Ex_Date, Record_Date, Type, Dividend percentage, and Amount in INR per share), bonus (with ex_date, Ratio, and recrd_date), and rights (with ex_date, Ratio, recrd_date, and Offerprice). The history depth varies by company but covers the full available record on Ticker by Finology.
The Ticker API is a managed, monitored endpoint for ticker.finology — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when ticker.finology changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official ticker.finology API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Screen NSE-listed companies by P/E, P/B, ROE, and ROCE using get_company_overview fields
- Build a five-year earnings trend chart using yearly_pnl data from get_financials
- Track promoter holding changes quarter-over-quarter using quarterly_details from get_shareholding
- Calculate dividend yield history and ex-date schedules from the dividends array in get_corporate_actions
- Backtest a price-based strategy using up to five years of daily BSE closing prices from get_price_history
- Resolve a brand name like 'Jio' to its NSE symbol and fincode using search_company before feeding other endpoints
- Monitor bonus and rights issue history to adjust cost-basis calculations using get_corporate_actions
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Ticker by Finology have an official developer API?+
What identifiers does search_company return, and which one should I use with other endpoints?+
symbol (NSE ticker), scrip_code (BSE numeric code), and fincode (Finology's internal identifier). All five other endpoints accept the NSE symbol as their primary input parameter, so that is the identifier to carry forward after a search.