Upstox

Upstox Fundamentals API

The Fundamentals API from Upstox — 8 operation(s) for fundamentals.

GitHub OpenAPI

Operations 8

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /v2/fundamentals/{isin}/share-holdings Get a company's shareholding pattern · Get Share Holdings #
Ask an LLM
“How much of a company do promoters, FIIs and the public own?”
“What is the shareholding pattern for a listed Indian company?”
Tell an agent
Show the shareholding pattern for ISIN {isin}.
Break down who owns the shares of company {isin}.
GET /v2/fundamentals/{isin}/profile Get a company's profile · Get Company Profile #
Ask an LLM
“What does a company do, and what are its basic profile details, given its ISIN?”
“Where can I read a short overview of a listed company on Upstox?”
Tell an agent
Get the company profile for ISIN {isin}.
Tell me about the business behind {isin}.
GET /v2/fundamentals/{isin}/key-ratios Get a company's key financial ratios · Get Key Ratios #
Ask an LLM
“What are the P/E, ROE and other key ratios for a stock?”
“Can I pull valuation and profitability ratios for a company by ISIN?”
Tell an agent
Fetch the key financial ratios for {isin}.
Show valuation and return ratios for company {isin}.
GET /v2/fundamentals/{isin}/income-statement Get a company's income statement · Get Income Statement #
Ask an LLM
“What were a company's revenue and profit over recent quarters?”
“Can I get consolidated or standalone profit and loss figures, yearly or quarterly?”
Tell an agent
Get the income statement for {isin}.
Show the {type} income statement for {isin} on a {time_period} basis.
GET /v2/fundamentals/{isin}/corporate-actions List a company's corporate actions · Get Corporate Actions #
Ask an LLM
“Has a company announced dividends, splits or bonus issues?”
“Which corporate actions are on record for a stock?”
Tell an agent
List the corporate actions for {isin}.
Show dividends, splits and bonuses announced by {isin}.
GET /v2/fundamentals/{isin}/cash-flow Get a company's cash flow statement · Get Cash Flow #
Ask an LLM
“How much cash does a company generate from operations?”
“Can I see standalone versus consolidated cash flow for a stock?”
Tell an agent
Get the cash flow statement for {isin}.
Show the {type} cash flows for {isin}.
GET /v2/fundamentals/{isin}/balance-sheet Get a company's balance sheet · Get Balance Sheet #
Ask an LLM
“What are a company's assets, liabilities and debt levels?”
“Where do I get the consolidated balance sheet for a listed company?”
Tell an agent
Get the balance sheet for {isin}.
Show the {type} assets and liabilities of {isin}.
GET /v2/fundamentals/{instrument_key}/competitors List a company's competitors · Get Competitors #
Ask an LLM
“Which companies compete with a given stock?”
“How do I find peer companies to compare against a listed stock?”
Tell an agent
List the competitors of {instrument_key}.
Find peer companies for instrument {instrument_key}.

Documentation

📖
Documentation
https://upstox.com/developer/api-documentation/open-api
📖
APIReference
https://upstox.com/developer/api-documentation/api-overview
📖
GettingStarted
https://upstox.com/developer/api-documentation/installing-sdk
📖
Authentication
https://upstox.com/developer/api-documentation/authentication

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/upstox/refs/heads/main/openapi/upstox-fundamentals-api-openapi.yml

Other Resources

🔗
Postman
https://gist.github.com/Rahulzz/a0da2ad28a7dcc81e887f24cfdbc80a8
🔗
Webhooks
https://upstox.com/developer/api-documentation/webhook

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/upstox:upstox-fundamentals-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

upstox-fundamentals-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: OpenAPI definition Fundamentals API
  version: v0
servers:
- url: https://api-v2.upstox.com
tags:


# --- truncated at 32 KB (32 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/upstox/refs/heads/main/openapi/upstox-fundamentals-api-openapi.yml