Search scrips

The Search scrips APIs provide you with the ability to efficiently search for instruments by utilizing relevant keywords.

Method: post

https://connect.thefirstock.com/api/V3/searchScrips

Request details

Parameter	Description	Data type	Example
userId	User Id of the login user	String	"AA1999"
stext	Search Text	String	"ITC"
jKey	key obtained during login	String	"d4180daa72ea70885ab0 d0fb38f0fa5796352b57d 0641d4442294b87f2b7315"

cURL

curl -X POST 'https://connect.thefirstock.com/api/V3/searchScrips'
  -H 'Content-Type: application/json'
  -d '{
  "userId": "AA123",
  "jKey": "e6a211bea63adff386578988e1cf4a9521c4744e6a39ad63174c8797e2af8c38",
  "stext": "ITC"
   }'

from thefirstock import thefirstock

searchScrips = thefirstock.firstock_SearchScrips(
    stext="ITC"
)

const Firstock = require("thefirstock");

const firstock = new Firstock();

firstock.searchScripts({ stext: "ITC" }, (err, result) => {
  console.log("Error, ", err);
  console.log("Result: ", result);
});

using thefirstock;

class Program
{
    public static void Main()
    {
        Firstock firstock = new Firstock();
        var result = firstock.searchScripts(stext: "ITC");
    }
}

Success response details

Parameter	Description	Data types	Examples
status	Success	String	"Success"
data.status	Ok	String	"Success"
values	list of symbol informations	String	"NSE","ITC-EQ"

Response Details: Json Fields of object in values Array

Parameter	Description	Data Type	Example
exchange	NSE, BSE, NFO, BFO... Exchange	String	"NSE"
tradingSymbol	Trading symbol of the scrip (contract)	String	"MUTHOOTFIN-EQ"
token	Token of the scrip (contract)	String	"23650"
pricePrecision	Price precision	String	"2"
tickSize	Tick size	String	"0.05"
lotSize	Lot size	String	"1"
companyName	Company Name	String	"MUTHOOT FINANCE LIMITED"
instrumentName	Instrument Name	String	"EQ"

Failure response details

Parameter	Description	Data Type	Example
status	Failed	String	"Failed"
code	HTTP Code	String	"400"
name	Type of error	String	"BAD_REQUEST"
error.field	Error field	String	"stext"
error.message	Error message	String	"stext cannot be undefined or NULL"

Sample response

Success response

{
  "status": "Success",
  "values": [
      {
          "exchange": "NSE",
          "tradingSymbol": "MUTHOOTFIN-EQ",
          "token": "23650",
          "companyName": "MUTHOOT FINANCE LIMITED",
          "instrumentName": "EQ",
          "pricePrecision": "2",
          "lotSize": "1",
          "tickSize": "0.05"
      },
      {
          "exchange": "NSE",
          "tradingSymbol": "MUTHOOTCAP-EQ",
          "token": "10415",
          "companyName": "MUTHOOT CAP SERV LTD",
          "instrumentName": "EQ",
          "pricePrecision": "2",
          "lotSize": "1",
          "tickSize": "0.05"
      },
      {
          "exchange": "NSE",
          "tradingSymbol": "MURUDCERA-EQ",
          "token": "2313",
          "companyName": "MURUDESHWAR CERAMICS LTD",
          "instrumentName": "EQ",
          "pricePrecision": "2",
          "lotSize": "1",
          "tickSize": "0.05"
      },
      {
          "exchange": "NSE",
          "tradingSymbol": "MUNJALSHOW-EQ",
          "token": "2307",
          "companyName": "MUNJAL SHOWA LTD",
          "instrumentName": "EQ",
          "pricePrecision": "2",
          "lotSize": "1",
          "tickSize": "0.05"
      },
      {
          "exchange": "NSE",
          "tradingSymbol": "MUNJALAU-EQ",
          "token": "13511",
          "companyName": "MUNJAL AUTO IND. LTD.",
          "instrumentName": "EQ",
          "pricePrecision": "2",
          "lotSize": "1",
          "tickSize": "0.05"
      },
      {
          "exchange": "NSE",
          "tradingSymbol": "MUKTAARTS-EQ",
          "token": "8687",
          "companyName": "MUKTA ARTS LIMITED",
          "instrumentName": "EQ",
          "pricePrecision": "2",
          "lotSize": "1",
          "tickSize": "0.05"
      },
      {
          "exchange": "NSE",
          "tradingSymbol": "MUKANDLTD-EQ",
          "token": "11325",
          "companyName": "MUKAND LTD.",
          "instrumentName": "EQ",
          "pricePrecision": "2",
          "lotSize": "1",
          "tickSize": "0.05"
      },
      {
          "exchange": "NSE",
          "tradingSymbol": "MTNL-EQ",
          "token": "2294",
          "companyName": "MAHANAGAR TELEPHONE NIGAM",
          "instrumentName": "EQ",
          "pricePrecision": "2",
          "lotSize": "1",
          "tickSize": "0.05"
      },
      {
          "exchange": "NSE",
          "tradingSymbol": "MTEDUCARE-BE",
          "token": "31413",
          "companyName": "MT EDUCARE LTD",
          "instrumentName": "BE",
          "pricePrecision": "2",
          "lotSize": "1",
          "tickSize": "0.05"
      },
      {
          "exchange": "NSE",
          "tradingSymbol": "MTARTECH-EQ",
          "token": "2709",
          "companyName": "MTAR TECHNOLOGIES LIMITED",
          "instrumentName": "EQ",
          "pricePrecision": "2",
          "lotSize": "1",
          "tickSize": "0.05"
      },
      {
          "exchange": "NSE",
          "tradingSymbol": "MSUMI-EQ",
          "token": "8596",
          "companyName": "MOTHERSON SUMI WRNG IND L",
          "instrumentName": "EQ",
          "pricePrecision": "2",
          "lotSize": "1",
          "tickSize": "0.05"
      },
      {
          "exchange": "NSE",
          "tradingSymbol": "MSTCLTD-EQ",
          "token": "9356",
          "companyName": "MSTC LIMITED",
          "instrumentName": "EQ",
          "pricePrecision": "2",
          "lotSize": "1",
          "tickSize": "0.05"
      },
      {
          "exchange": "NSE",
          "tradingSymbol": "MSPL-EQ",
          "token": "11919",
          "companyName": "MSP STEEL & POWER LTD.",
          "instrumentName": "EQ",
          "pricePrecision": "2",
          "lotSize": "1",
          "tickSize": "0.05"
      },
      {
          "exchange": "NSE",
          "tradingSymbol": "MRPL-EQ",
          "token": "2283",
          "companyName": "MRPL",
          "instrumentName": "EQ",
          "pricePrecision": "2",
          "lotSize": "1",
          "tickSize": "0.05"
      },
      {
          "exchange": "NSE",
          "tradingSymbol": "MRO-TEK-EQ",
          "token": "8998",
          "companyName": "MRO-TEK REALTY LIMITED",
          "instrumentName": "EQ",
          "pricePrecision": "2",
          "lotSize": "1",
          "tickSize": "0.05"
      },
      {
          "exchange": "NSE",
          "tradingSymbol": "MRF-EQ",
          "token": "2277",
          "companyName": "MRF LTD",
          "instrumentName": "EQ",
          "pricePrecision": "2",
          "lotSize": "1",
          "tickSize": "0.05"
      },
      {
          "exchange": "NSE",
          "tradingSymbol": "MPSLTD-EQ",
          "token": "10578",
          "companyName": "MPS LIMITED",
          "instrumentName": "EQ",
          "pricePrecision": "2",
          "lotSize": "1",
          "tickSize": "0.05"
      },
      {
          "exchange": "NSE",
          "tradingSymbol": "MPHASIS-EQ",
          "token": "4503",
          "companyName": "MPHASIS LIMITED",
          "instrumentName": "EQ",
          "pricePrecision": "2",
          "lotSize": "1",
          "tickSize": "0.05"
      },
      {
          "exchange": "NSE",
          "tradingSymbol": "MOVALUE-EQ",
          "token": "10825",
          "companyName": "MOTILALAMC - MOVALUE",
          "instrumentName": "EQ",
          "pricePrecision": "2",
          "lotSize": "1",
          "tickSize": "0.01"
      },
      {
          "exchange": "NSE",
          "tradingSymbol": "MOTOGENFIN-EQ",
          "token": "2268",
          "companyName": "MOTOR & GENERAL FINANCE L",
          "instrumentName": "EQ",
          "pricePrecision": "2",
          "lotSize": "1",
          "tickSize": "0.05"
      },
      {
          "exchange": "NSE",
          "tradingSymbol": "MOTILALOFS-EQ",
          "token": "14947",
          "companyName": "MOTILAL OSWAL FIN LTD",
          "instrumentName": "EQ",
          "pricePrecision": "2",
          "lotSize": "1",
          "tickSize": "0.05"
      },
      {
          "exchange": "NSE",
          "tradingSymbol": "MOTHERSON-EQ",
          "token": "4204",
          "companyName": "SAMVRDHNA MTHRSN INTL LTD",
          "instrumentName": "EQ",
          "pricePrecision": "2",
          "lotSize": "1",
          "tickSize": "0.05"
      },
      {
          "exchange": "NSE",
          "tradingSymbol": "MOREPENLAB-EQ",
          "token": "2259",
          "companyName": "MOREPEN LAB. LTD",
          "instrumentName": "EQ",
          "pricePrecision": "2",
          "lotSize": "1",
          "tickSize": "0.05"
      },
      {
          "exchange": "NSE",
          "tradingSymbol": "MORARJEE-EQ",
          "token": "28877",
          "companyName": "MORARJEE TEXTILES LIMITED",
          "instrumentName": "EQ",
          "pricePrecision": "2",
          "lotSize": "1",
          "tickSize": "0.05"
      },
      {
          "exchange": "NSE",
          "tradingSymbol": "MOQUALITY-EQ",
          "token": "10822",
          "companyName": "MOTILALAMC - MOQUALITY",
          "instrumentName": "EQ",
          "pricePrecision": "2",
          "lotSize": "1",
          "tickSize": "0.01"
      }
  ]
}

Failure response

{
  "status": "Failed",
  "code": "400",
  "name": "BAD_REQUEST",
  "error": {
      "field": "stext",
      "message": "stext cannot be undefined or NULL"
  }
}