Competitors
Fetches peer / competitor companies for a stock, including each competitor's instrument key, business profile, sector, and sector market capitalisation (INR and USD).
Rate Limits
| Plan | Rate Limit |
|---|---|
| Hobby | 5 requests / day |
| Plus | 10 requests / minute |
Request
GET /api/competitors/{company_symbol}
| Parameter | Description | Priority | Type |
|---|---|---|---|
| api_key | User Generated API Key. Generate Here | required | string |
| force_update | Bypass cache and refresh from the data provider Default false | optional | boolean |
Response
| Field | Description | Type |
|---|---|---|
| success | Indicates if the API call was successful or not | string |
| company | Name of the company | string |
| trading_symbol | NSE / BSE trading symbol | string |
| isin | ISIN used to resolve competitors | string |
| data | List of competitor company profiles | array |
| data.instrument_key | Instrument key, e.g. NSE_EQ|INE242A01010 | string |
| data.company_profile | Brief description of the competitor's business | string |
| data.sector | Sector the competitor belongs to | string |
| data.sector_market_cap_inr | Sector market capitalisation in INR | object |
| data.sector_market_cap_inr.value | Numeric market cap value in crore | decimal |
| data.sector_market_cap_inr.unit | Unit of the value (crore) | string |
| data.sector_market_cap_inr.formatted | Human-readable value, e.g. 131,391.64 Cr | string |
| data.sector_market_cap_usd | Sector market capitalisation in USD | object |
| data.sector_market_cap_usd.value | Numeric market cap value | decimal |
| data.sector_market_cap_usd.unit | Unit of the value (billion / million) | string |
| data.sector_market_cap_usd.formatted | Human-readable value, e.g. $14.60B | string |
Example
curl -X GET \ -H "Content-Type: application/json" \ --url 'https://api.fincrux.org/api/competitors/RELIANCE?api_key={api_key}'
{ "success": "true", "company": "Reliance Industries Limited", "trading_symbol": "RELIANCE", "isin": "INE002A01018", "data": [ { "instrument_key": "NSE_EQ|INE242A01010", "company_profile": "Indian Oil Corporation Limited is an India-based oil company...", "sector": "Refineries", "sector_market_cap_inr": { "value": 204334.32, "unit": "crore", "formatted": "204,334.32 Cr" }, "sector_market_cap_usd": { "value": 22.7, "unit": "billion", "formatted": "$22.70B" } } ] }