Skip to main content

CRP Info

This API retrieves the Client Risk Profile (CRP) information for the authenticated user, detailing margin configuration, trading permissions, MTM calculation settings, and auto square-off modes per product type and exchange.

Endpoint: GET /transactional/{tenantId}/v1/crp-info

🔑 Header Parameters

HeaderTypeDescriptionExample
Content-TypestringSpecifies the media type of the requestapplication/json
AuthorizationstringBearer token for authenticated requests{{access_token}}
x-api-keystringAPI key used to authorize the request{{x-api-key}}

🔗 Path Parameters

ParameterTypeRequiredDescriptionExample
tenantIdintegerYesTenant identifier797

🔍 Query Parameters

ParameterTypeRequiredDescriptionExample
product_typestringYesProduct type filter; use ALL to fetch all products"ALL"
exchangestringYesExchange segment to filter the CRP data"NSE_EQ"

🟢 Success Response - 200 OK

Content-Type: application/json

FieldTypeDescriptionExample
statusstringStatus of API call"success"
codestringResponse code to user request"s-101"
messagestringSuccess message"Success"
dataarrayArray of CRP configuration objectsRefer below

📦 Data Object Fields

Each object in the data array represents the CRP configuration for a specific product type on a given exchange.

🔹 Identity Fields

FieldTypeDescriptionExample
User IDstringUser identifier for the profile"AB8727"
Group IDstringGroup to which the user belongs"DELHI1"
ExchangestringExchange segment this configuration applies to"NSE_EQ"
Product TypestringProduct type this configuration applies to"INTRADAY", "DELIVERY", "COVER", "MTF"
InstrumentTypestringInstrument type; empty for all instruments""
ReservedstringReserved field; typically empty""
PSBT Template NamestringAssociated PSBT template name"INTRADAY", "DELIVERY", "MTF", ""

🔹 Margin Configuration Fields

FieldTypeDescriptionExample
Margin IndicatorintegerIndicates the margin calculation method (0 = percent-based)0, 1
Prime Margin IndicatorintegerIndicates if prime margin rules apply0
Buy Margin %numberMargin percentage required for buy orders100
Sell Margin %numberMargin percentage required for sell orders100
Top Up Margin %numberAdditional top-up margin percentage0
Prefer PSBTintegerWhether PSBT is preferred for margin calculation (1 = Yes)1, 0
Allowed ListintegerWhether the scrip allowed-list check is enforced1, 0
Limit InclusionstringEncoded bitmask specifying which limit types are included"4222124650659843"

🔹 Margin Calculation Inclusion Flags

These flags (1 = Include, 0 = Exclude) control which P&L components are factored into margin calculations.

FieldTypeDescriptionExample
Include MTM Loss for Margin CalculationintegerInclude MTM loss when computing required margin1
Include MTM Profit for Margin CalculationintegerInclude MTM profit when computing required margin0
Include Booked Loss or Margin CalculationintegerInclude booked loss when computing required margin1
Include Booked Profit for Margin CalculationintegerInclude booked profit when computing required margin0
Include Exposure Margin for Margin CalculationintegerInclude exposure margin in margin calculation0
Include Net Premium for Margin CalculationintegerInclude net option premium in margin calculation0
Include Premium Benefit for Margin CalculationintegerInclude premium benefit in margin calculation0
Include Brokerage for Margin CalculationintegerInclude brokerage charges in margin calculation0

🔹 MTM Calculation Inclusion Flags

These flags control which P&L components are factored into MTM (Mark-to-Market) calculations.

FieldTypeDescriptionExample
Include MTM Loss for MTM CalculationintegerInclude MTM loss when computing net MTM1
Include MTM Profit for MTM CalculationintegerInclude MTM profit when computing net MTM1
Include Booked Loss or MTM CalculationintegerInclude booked loss when computing net MTM1
Include Booked Profit for MTM CalculationintegerInclude booked profit when computing net MTM1
Include Brokerage for MTM CalculationintegerInclude brokerage charges when computing net MTM0

🔹 Manual Collateral Inclusion Flags

FieldTypeDescriptionExample
Include Booked Loss for Include Manual CollateralintegerInclude booked loss when applying manual collateral0
Include Booked Profit for Include Manual CollateralintegerInclude booked profit when applying manual collateral0

🔹 Trading Permission Flags

FieldTypeDescriptionExample
Fresh Buy AllowedintegerWhether fresh buy orders are allowed (1 = Yes, 0 = No)1
Fresh Sell AllowedintegerWhether fresh sell orders are allowed (1 = Yes, 0 = No)1, 0
Square off Intraday Buy Position AllowedintegerWhether intraday buy position square-off is allowed1
Square off Intraday Sell Position AllowedintegerWhether intraday sell position square-off is allowed1
Square off Expiry Buy Position AllowedintegerWhether buy position square-off at expiry is allowed1
Square off Expiry Sell Position AllowedintegerWhether sell position square-off at expiry is allowed0

🔹 Auto Square-Off & Surveillance Flags

FieldTypeDescriptionExample
Pre Auto Sq Off ModeintegerPre-auto square-off mode activation flag (1 = Active)1, 0
Auto SQ Off ModeintegerAuto square-off mode activation flag (1 = Active)1, 0
Force SQ OFF ModeintegerForce square-off mode activation flag (1 = Active)0
Check Surveillance for AMOintegerWhether surveillance check applies to After-Market Orders0
Trade Modification Surv ModeintegerWhether surveillance mode is applied on trade modification1, 0
Max Track IT OrderintegerMaximum number of IT (Intraday) orders allowed to be tracked9999, 0