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. Equity, derivative and MCX commodity instruments are all supported, and may be mixed in a single request.

Query Parameters¶

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

Segments may be mixed freely in one request. Every identifier must resolve — a single unknown code fails the whole request with 400 and Invalid scrip codes or mode, rather than returning the rest.

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

GET /market/quotes/full

Example Request¶

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

For an MCX commodity contract

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

A commodity contract returns the same fields as any other instrument, with open_interest and open_interest_change as on a derivative. upper_circuit and lower_circuit come back as resolved prices, not the percentages the instruments master carries for MCX:

{
  "status": "success",
  "data": {
    "MCX_495214": {
      "live_price": 225820,
      "prev_close": 221233,
      "upper_circuit": 230082,
      "lower_circuit": 212384
    }
  }
}

Response Payload (Success)¶

{
  "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

GET /market/quotes/ltp

Example Request¶

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

Response Payload (Success)¶

{
  "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

GET /market/quotes/mkt

Example Request¶

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

Response Payload (Success)¶

{
  "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" } }
        ]
      }
    }
  }
}

See Also¶

• Instruments — look up the SECURITY_ID used to build scrip-codes
• Historical Data — OHLCV candles instead of a live snapshot
• WebSockets — subscribe to continuous live updates instead of polling
• Glossary & Constants — SEGMENT_TOKEN vs SEGMENT:TOKEN formats
• Error Bucket — DataException for invalid scrip codes