Skip to main content

This API returns a list of scrips (financial securities) matching the provided search text. It helps users fetch details like symbol codes, expiry dates, instrument types, and more for securities listed on various exchanges.

🛣️Path Parameters

ParameterTypeRequiredDescriptionExample/ENUM
tenantidstringYesIdentifier for the tenant/customertenant123
searchTextstringYesText to search for scripsACC,NIFTY APR, GOLD, MCX
mktAllowedstringYesMarket filter-1

🔑Header Paramters

HeaderTypeDescriptionExample
AuthorizationstringBearer token for accessaccess-token
x-api-keystringAPI provided for authorizationx-api-key

🟢Success Response - 200 Ok

FieldTypeDescriptionExample
sourceobjectContains the scrip detailsSee details below

📘Scrip details Object Fields

FieldTypeDescriptionExample
expstringExpiry date of the contract"1980-01-01T00:00:00.000Z"
sSymbolstringSymbol code as per exchange scrip master fileACC
sOptionTypestringOption type (if applicable)CE, PE
nStrikePricestringStrike price in paise150000
nExpiyDateintegerExpiry date as a timestamp or date integer20250630
nExpiryDate1stringAlternate expiry date string"27JUN2025"
nExpiryDate2stringAnother expiry date string"2025/06/27"
nAssetTokenintegerAsset Token ID123345
nInstrumentTypeintegerInstrument type code as per exchange1 (e.g., 1 = Equity, 2 = Futures)
nMarketSegmentIdintegerMarket Segment ID15
nNormal_MarketAllowedintegerFlag indicating if normal market trading is allowed1
nPriceBdAttributeintegerPrice board attribute0
nRegularLotintegerRegular lot size75
nTokenintegerToken number received from Exchange scripmaster5874
sDerivitiveDescstringDerivative descriptionNifty 50 Futures
sInstrumentNamestringInstrument nameNifty FUT
sSecurityDescstringSecurity descriptionNifty Futures
sSeriesstringSeries the scrip belongs to (e.g. A, Eq, B, T, Z)"EQ"
nSPOSintegerSpecial position code0
nPOSintegerPosition code1
DecimalLocatorintegerDecimal locator (how many decimal places to consider)2
nNRILimitintegerNRI investment limit1000
nFIILimitintegerFII investment limit5000
nPriceTickintegerMinimum price tick size5
nSpreadintegerAllowed spread10
sISINCodestringISIN CodeINE547899621
sGlobalNormalFlagstringGlobal normal flag (indicates if normal trading allowed globally)0
nStrikePrice1stringAnother strike price field170000
nFIIFlagintegerFII flag0
nMarginTypeIndicatorintegerMargin type indicator2
nAVMBuyMarginintegerAVM buy margin1500
nAVMSellMarginintegerAVM sell margin1500
nPriceNumintegerPrice numerator (for fractional price representation)1
nPriceDenintegerPrice denominator (for fractional price representation)100
nIsAssetintegerIndicates if this is an asset0
nIntrinsicValueintegerIntrinsic value1000
nIsIndexintegerIndicates if the instrument is an index0
nFOExistsintegerIndicates if Futures & Options exist0
nCoCodeintegerCompany code123
nSectorCodeintegerSector code10
nOtherExchTokenintegerToken number from other exchanges7986
sSectorstringSector nameFinance
nExpiryMonthintegerExpiry month6 (June)
nIssueMaturityDateintegerIssue maturity date (yyyymmdd)20300627
nIsSIPintegerSIP indicator (Systematic Investment Plan)0
idstringUnique identifier for the scrip1-7089
sExchangestringExchange Code"NSE"
sSearchTextstringSearch text used"ACCELYA ACCELYA SOLN INDIA LTD NSE EQ"
sSymbolnewstringNew symbol code as per exchange scripmaster"ACCELYA"
get/nontransactional/{tenantid}/v1/getScripLookUp/{searchText}/{mktAllowed}