Skip to main content

Market Connect

Get Multi Quotes

Our market quotes APIs provide you with access to up-to-date market data for various instruments. These data snapshots are collected directly from the exchanges in real-time, ensuring the accuracy of the information at the time of your request. For real-time streaming market quotes, we recommend utilizing our WebSocket API.

Method: POST​

https://connect.thefirstock.com/api/V4/getMultiQuotes

Request details

API Parameters
Parameter Description Example
userId
string		 Identifier for the user upon login, unique to each user in the system. AA0013
exchange
string		 Exchange on which the order is placed (e.g., NSE, BSE, NFO, BFO) BSE
tradingSymbol
string		 Encoded trading symbol of the security ITC-EQ
jKey
string		 Authentication token obtained from the login API d4180daa72ea70885ab0d

Libraries and SDKs

Tabbed Interface 
from thefirstock import thefirstock

mQ = thefirstock.firstock_getMultiQuote(
    userId="{{userId"}},
    dataToken=[
        {
            "exchange": "NSE",
            "tradingSymbol": "Nifty 50"
        },
        {
            "exchange": "NSE",
            "tradingSymbol": "Nifty Bank"
        }
    ]
curl --location --request POST 'https://connect.thefirstock.com/api/V4/getMultiQuotes' \
--header 'Content-Type: application/json' \
--data-raw '{
    "userId": "{{userID}}",
    "jKey": "{{jKey}}",
    "data": [
        {
            "exchange": "NSE",
            "tradingSymbol": "Nifty 50"
        },
        {
            "exchange": "NSE",
            "tradingSymbol": "Nifty Bank"
        }
    ]
}'
const Firstock = require("thefirstock");

const firstock = new Firstock(userId: {{userId}});

firstock.getMultiQuotes(
  {
    data: [
      { exchange: "NSE", token: "26000" },

      { exchange: "NFO", token: "55101" },
    ],
  },
  (err, result) => {
    console.log("getMultiQuotes Error, ", err);
    console.log("getMultiQuotes Result: ", result);
  }
);

using thefirstock;

class Program
{
    public static void Main()
    {
        Firstock firstock = new Firstock();
          var result = firstock.getMultiQuotes(userId: {{userId}},data: new List() {
                new multiQuotesObject{
                   exchange="NSE",
                    token="26000"
                }
                }
            );
    }
}

Success response details

API Parameters
Parameter Description Example
Status
String		 Success success
data.token
String		 Token 26000
data.requestTime
String		 Request Time
(Successful response only)		 12:26:55 18-03-2023
data.companyName
String		 Company Name NIFTY INDEX
data.exchange
String		 Exchange
(NSE, BSE, NFO, BFO)		 NSE
data.tradingSymbol
String		 Trading Symbol Nifty 50
data.symbolName
String		 Symbol Name NIFTY
data.segment
String		 Segment EQT
data.instrumentName
String		 Instrument Name UNDIND
data.pricePrecision
String		 Price Precision 2
data.lotSize
String		 Lot Size 1
data.tickSize
String		 Tick Size 0.05
data.multipler
String		 Multiplier 1
data.priceFactor
String		 Price Factor
((GN / GD) * (PN/PD))		 (1 / 1 ) * (1 / 1)
data.lastTradedPrice
String		 Last Traded Price 17314.75
data.company
String		 Company 17100.05
data.upperCircuit
String		 Upper Circuit Limit 0.00
data.lowerCircuit
String		 Lower Circuit Limit 0.00
data.dayHighPrice
String		 Day High Price 17745.60
data.dayLowPrice
String		 Day Low Price 16921.35
data.volume
String		 Volume 0.00
data.lastTradedQuantity
String		 Last Trade Quantity 0.00
data.lastTradeTime
String		 Last Trade Time 0.00
data.bestBuyPrice1
String		 Best Buy Price 1 0.00
data.bestBuyPrice2
String		 Best Buy Price 2 0.00 
{
    "status": "success",
    "data": [
        {
            "token": "26000",
            "result": {
                "requestTime": "12:26:55 18-03-2023",
                "companyName": "NIFTY INDEX",
                "exchange": "NSE",
                "tradingSymbol": "Nifty 50",
                "symbolName": "NIFTY",
                "segment": "EQT",
                "instrumentName": "UNDIND",
                "pricePrecision": "2",
                "lotSize": "1",
                "tickSize": "0.05",
                "multipler": "1",
                "priceFactor": "(1 / 1 ) * (1 / 1)",
                "token": "26000",
                "lastTradedPrice": "17314.75",
                "company": "17100.05",
                "upperCircuit": "0.00",
                "lowerCircuit": "0.00",
                "dayHighPrice": "17745.60",
                "dayLowPrice": "16921.35",
                "volume": "0.00",
                "lastTradedQuantity": "0.00",
                "lastTradeTime": "0.00",
                "bestBuyPrice1": "0.00",
                "bestBuyPrice2": "0.00",
                "bestBuyPrice3": "0.00",
                "bestBuyPrice4": "0.00",
                "bestBuyPrice5": "0.00",
                "bestSellPrice1": "0.00",
                "bestSellPrice2": "0.00",
                "bestSellPrice3": "0.00",
                "bestSellPrice4": "0.00",
                "bestSellPrice5": "0.00",
                "bestBuyQuantity1": "0.00",
                "bestBuyQuantity2": "0.00",
                "bestBuyQuantity3": "0.00",
                "bestBuyQuantity4": "0.00",
                "bestBuyQuantity5": "0.00",
                "bestSellQuantity1": "0.00",
                "bestSellQuantity2": "0.00",
                "bestSellQuantity3": "0.00",
                "bestSellQuantity4": "0.00",
                "bestSellQuantity5": "0.00",
                "bestSellOrder1": "0.00",
                "bestSellOrder2": "0.00",
                "bestSellOrder3": "0.00",
                "bestSellOrder4": "0.00",
                "bestSellOrder5": "0.00",
                "bestBuyOrder1": "0.00",
                "bestBuyOrder2": "0.00",
                "bestBuyOrder3": "0.00",
                "bestBuyOrder4": "0.00",
                "bestBuyOrder5": "0.00"
            }
        }
    ]
}

Failure response details

API Error Parameters
Parameter Description Example
status
String		 Indicates the result status of the API operation failed
code
String		 HTTP status code associated with the error 400
name
String		 Type of error EXCHANGE/TOKEN
error.field
String		 Error field exchange/token
error.message
String		 Error message Invalid Exchange/Token 
{
    "status": "failed",
    "data": [
        {
            "status": "Failed",
            "code": "400",
            "name": "EXCHANGE/TOKEN",
            "error": {
                "field": "exchange/token",
                "message": "Invalid Exchange/Token"
            }
        }
    ]
}