Skip to main content

Security Info

This API returns detailed security information for a specific scrip (stock or contract), including symbol, series, ISIN code, instrument type, and more.

🛣️Path Parameter

ParameterTypeDescriptionExample
tenantidstringTenant identifier for which data is requestedtenant123

🔑Header Parameters

HeaderTypeDescriptionExa
AuthorizationstringBearer Access tokenaccess-token
x-api-keystringAPI key for authrorizationx-api-key

📦Request Body Schema

FieldTypeDescriptionExample/ENUM
mktSegmentIdstringMarket segment ID of the scrip/contract"NSE_EQ"
tokenstringScrip token from the exchange scrip master file12345

🟢Success Response - 200 Ok

FieldTypeDescriptionExample/ENUM
statusbooleanStatus of API call"success"
result.secInfoarray of objectsArray containing security info detailsSee below for details
result.pivotarrary of objectsArray containing summary market dataSee below for details

📑 SecInfo Object Structrure

FieldTypeDescriptionExample/ENUM
nTokenintegerUnique token for the scrip12345
sSymbolstringTrading symbol of the security"INFY"
sSeriesstringSeries code (e.g., EQ for equity)"EQ"
sSecurityDescstringFull description of the security"INFOSYS LIMITED"
sISINCodestringISIN code of the security"INE987667"
nInstrumentTypestringType of instrument (e.g., equity, future)"EQUITY"
nRegularLotintegerRegular lot size1
nPriceTickintegerMinimum price increment5
nIssuedCapitalintegerTotal issued capital10000000
nFreezePercentintegerFreeze percentage on the security0
nFaceValueintegerFace value of the security10
nAVMBuyMarginintegerAdditional margin for buy orders15
nAVMSellMarginintegerAdditional margin for sell orders15
nBookClosureStartDateintegerStart date for book closure (Epoch timestamp)1673126400
nBookClosureEndDateintegerEnd date for book closure (Epoch timestamp)1672444800
nNoDeliveryStartDateintegerNo delivery start date (Epoch timestamp)1672444800
nNoDeliveryEndDateintegerNo delivery end date (Epoch timestamp)1673126400
sRemarksstringRemarks or special notes about the security"Dividend Pending"
nRecordDateintegerRecord date (Epoch timestamp)1672531200
nExDateintegerEx-date (Epoch timestamp)1672617600
nIntrinsicValueintegerIntrinsic value of the security100
nMarginMultiplierintegerMargin multiplier1
nPriceQuotFactorintegerPrice quotation factor1
nNormal_SecurityStatusstringCurrent security status"yes"
SPOSintegerSpecial position indicator0
SPOSTYPEintegerType of SPOS0
CouponRateintegerCoupon rate (for bonds)7
DaysInYearintegerNumber of days in a year365
DaysInMonthintegerNumber of days in a month30
CouponFrequencystringFrequency of coupon payments"Quarterly"
MathcingTypeintegerMatching type identifier0
ValueMethodstringMethod used for value calculationMarket
LastInterestPaymentDatestringDate of last interest payment"2024-03-31"
NextInterestPaymentDatestringDate of next interest payment"2025-09-01"
MaturityDatestringMaturity date of the instrument"2025-11-05"
InstrumentCodeintegerNumeric code for instrument type101
StatusstringCurrent status (e.g., Active, Suspended)Active
SettlementTypeintegerSettlement type code1
CreditRatingstringCredit rating of the instrumentAAA

📑 Pivot Object Structure

FieldTypeDescriptionExample/ENUM
sSymbolstringTrading symbol"RELIANCE"
nMarketSegmentIdstringMarket segment ID"NSE_EQ"
nTokenstringScrip token12345
PrevOpenstringPrevious day open price2500.00
PrevHighstringPrevious day High price2550.00
PrevLowstringPrevious day low price2450.00
PrevClosestringPrevious day closing price2525.00
post/nontransactional/{tenantid}/v1/getSecurityInfo