Market Quotes¶

This section covers endpoints for retrieving real-time market data for one or more instruments, including full quotes, Last Traded Price (LTP), and market depth.

Request Type	Path	Description
GET	`/market/quotes/full`	Retrieve full market quotes for one or more instruments.
GET	`/market/quotes/ltp`	Retrieve only the LTP for one or more instruments.
GET	`/market/quotes/mkt`	Retrieve market depth for one or more instruments.

Query Parameters¶

All quote endpoints accept a scrip-codes query parameter to specify the instrument(s).

Parameter	Description
`scrip-codes`	A comma-separated list of instrument identifiers. Each identifier is a combination of the exchange segment and the instrument token from the Instruments file. Format: `SEGMENT_INSTRUMENTTOKEN` Example: `NSE_3045,NFO_51011`

Get Full Market Quotes¶

This endpoint retrieves a comprehensive market data snapshot for up to 1000 instruments at once. The response includes OHLC, day's change, volume, circuit limits, and market depth.

Endpoint

Text Only

GET /market/quotes/full

Example Request¶

Bash

curl --location 'https://api.indstocks.com/market/quotes/full?scrip-codes=NSE_3045' \
--header 'Authorization: YOUR_ACCESS_TOKEN'

Response Payload (Success)¶

JSON

{
  "status": "success",
  "data": {
    "NSE_3045": {
      "live_price": 788.8,
      "day_change": -3.5,
      "day_change_percentage": -0.44,
      "day_low": 788.35,
      "day_high": 795.5,
      "day_open": 792.5,
      "prev_close": 792.3,
      "52week_high": 899,
      "52week_low": 680,
      "upper_circuit": 871.5,
      "lower_circuit": 713.1,
      "market_depth": { /* ... market depth object ... */ },
      "volume": 3546732
    }
  }
}

Get LTP Quote¶

This endpoint retrieves only the Last Traded Price (LTP) for up to 1000 instruments. It is a lightweight alternative to the full quote endpoint.

Endpoint

Text Only

GET /market/quotes/ltp

Example Request¶

Bash

curl --location 'https://api.indstocks.com/market/quotes/ltp?scrip-codes=NSE_3045' \
--header 'Authorization: YOUR_ACCESS_TOKEN'

Response Payload (Success)¶

JSON

{
  "status": "success",
  "data": {
    "NSE_3045": {
      "live_price": 792.5
    }
  }
}

Get Market Depth¶

This endpoint retrieves the 5-level market depth for one or more instruments.

Endpoint

Text Only

GET /market/quotes/mkt

Example Request¶

Bash

curl --location 'https://api.indstocks.com/market/quotes/mkt?scrip-codes=NSE_3045' \
--header 'Authorization: YOUR_ACCESS_TOKEN'

Response Payload (Success)¶

JSON

{
  "status": "success",
  "data": {
    "NSE_3045": {
      "market_depth": {
        "aggregate": {
          "total_buy": "5,82,909",
          "total_sell": "11,01,938",
          "buy_percentage": 34.6,
          "sell_percentage": 65.4
        },
        "depth": [
          { "buy": { "quantity": "6.00", "price": "788.95" }, "sell": { "quantity": "21.00", "price": "789.00" } },
          { "buy": { "quantity": "756.00", "price": "788.70" }, "sell": { "quantity": "255.00", "price": "789.05" } },
          { "buy": { "quantity": "456.00", "price": "788.65" }, "sell": { "quantity": "264.00", "price": "789.10" } },
          { "buy": { "quantity": "2,318", "price": "788.60" }, "sell": { "quantity": "1,792", "price": "789.15" } },
          { "buy": { "quantity": "1,644", "price": "788.55" }, "sell": { "quantity": "1,328", "price": "789.20" } }
        ]
      }
    }
  }
}