Get Started
The Fincrux API allows you to access a wide range of financial data, including company financials, stock market data, and personalized financial insights. This guide will help you get started with authentication, making your first API request, and understanding how to use the API effectively.
Authentication Methods

Fincrux API provides two methods for authentication:
- Access Token Authentication - Requires login via email and password to obtain a token.
- API Key Authentication - Uses a unique API key for authorization.
You can choose either method based on your application's requirements.
Official clients
Install an official SDK for Python or Node.js, or call the REST API directly with cURL / any HTTP client.
Python
pip install fincrux
import fincrux fc = fincrux.Fincrux(api_key="YOUR_API_KEY") print(fc.get_company_financials("RELIANCE"))
Node.js / TypeScript
npm install fincrux
import { Fincrux } from "fincrux"; const fc = new Fincrux({ api_key: "YOUR_API_KEY" }); console.log(await fc.getCompanyFinancials("RELIANCE"));
Packages: PyPI fincrux · npm fincrux
Source: Python on GitHub · Node.js on GitHub
Authentication Types
To authenticate, you can either use an Access Token or an API Key.
- Using an Access Token - Refer to the Access Token Concept Guide to learn how to obtain and use an access token for API authentication.
- Using an API Key - Refer to the API Key Concept Guide to learn how to obtain and use API Keys.
Explore API Endpoints
Now that you're authenticated, explore the available endpoints to fetch various financial data:
| Endpoint | Description | Documentation |
|---|---|---|
/api/all_companies | Get a list of all companies | All Companies |
/api/search/{trading_symbol} | Get company details by stock symbol | Search Company |
/api/financials/{trading_symbol} | Get detailed financial reports | Company Financials |
/api/historicals/{trading_symbol} | Get historical stock data | Company Historicals |
/api/corporate-actions/{trading_symbol} | Get dividends, bonus, splits & rights | Corporate Actions |
/api/competitors/{trading_symbol} | Get peer competitor companies | Competitors |
/api/market/fii | Get FII activity by market segment | FII Activity Data |
/api/market/dii | Get DII cash-market activity | DII Activity Data |