PSBT Info

This API retrieves the Product Scrip Basket Template (PSBT) details for a given PSBT template, which defines scrip-level margin, trading permissions, and position square-off rules.

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

🔑 Header Parameters

Header	Type	Description	Example
Content-Type	string	Specifies the media type of the request	application/json
Authorization	string	Bearer token for authenticated requests	{{access_token}}
x-api-key	string	API key used to authorize the request	{{x-api-key}}

🔗 Path Parameters

Parameter	Type	Required	Description	Example
tenantId	integer	Yes	Tenant identifier	797

🔍 Query Parameters

Parameter	Type	Required	Description	Example
psbt_template	string	Yes	PSBT template name to fetch scrip-level configuration for	"CASH"
exchange	string	No	Exchange segment to filter results	"NSE_EQ"

🟢 Success Response - 200 OK

Content-Type: application/json

Field	Type	Description	Example
status	string	Status of API call	"success"
code	string	Response code to user request	"s-101"
message	string	Success message	"Success"
data	array	Array of PSBT scrip configuration items	Refer below

📦 Data Object Fields

Each object in the data array represents PSBT configuration for a single scrip.

Field	Type	Description	Example
PSBT Template ID	string	Name/ID of the PSBT template this entry belongs to	"CASH"
Scrip Token Number	integer	Exchange token identifying the instrument	541157
Margin %	number	Required margin percentage for this scrip	100
Short Sell Margin %	number	Margin percentage applicable for short selling	0
Fresh Buy Allowed	integer	Whether fresh buy orders are permitted (1 = Yes, 0 = No)	1
Fresh Sell Allowed	integer	Whether fresh sell orders are permitted (1 = Yes, 0 = No)	0
Intraday Buy Position Square Off Allowed	integer	Whether intraday buy position square-off is permitted	1
Intraday Sell Position Square Off Allowed	integer	Whether intraday sell position square-off is permitted	1
Expiry Buy Position Square Off Allowed	integer	Whether buy position square-off at expiry is permitted	1
Expiry Sell Position Square Off Allowed	integer	Whether sell position square-off at expiry is permitted	1
Type	integer	Instrument type indicator	0
Future or Option	string	Indicates if the scrip is a Future or Option; blank for equity	" "
Future Price Range %	number	Allowed price range percentage for futures	0
Away from Spot % ITM	number	Allowed distance from spot price for In-The-Money options	0
Away from Spot % OTM	number	Allowed distance from spot price for Out-of-The-Money options	0
In the money % (Buy Max)	number	Maximum ITM percentage allowed for buy orders	0
In the money % (Sell Min)	number	Minimum ITM percentage allowed for sell orders	0
Out the money % (Buy Max)	number	Maximum OTM percentage allowed for buy orders	0
Out the money % (Sell Min)	number	Minimum OTM percentage allowed for sell orders	0

Note: The Fresh Buy Allowed, Fresh Sell Allowed, and square-off flags use integer boolean values where 1 = allowed and 0 = not allowed. Some scrips may have all trading disabled (all flags set to 0), indicating they are blocked or under surveillance.