Position Conversion

This API converts an existing open position from one product type to another (e.g., INTRADAY → DELIVERY or DELIVERY → INTRADAY).

Prerequisite: The position you want to convert must exist as an open position. Use the Positions API to fetch current open positions and obtain the correct exchange and scrip_token values before calling this API.

Next Step: This API submits the conversion request to the OMS and returns an orderId. To confirm whether the conversion was accepted or rejected by the OMS, use the returned orderId with the Position Conversion Inquiry API.

🔑Header Parameters

Header	Type	Required	Description	Example
Content-Type	string	Yes	Format of request payload	application/json
Authorization	string	Yes	Bearer access token	Bearer access token
x-api-key	string	Yes	Unique API key provided	x-api-key

📦Request Body Schema

Field	Type	Required	Description	Example/ENUM
exchange	string	Yes	Exchange segments	"NSE_EQ", "BSE_EQ", "NSE_FO"
scrip_token	integer	Yes	Token ID of the instrument	10123
transaction_type	string	Yes	Direction of trade	"BUY"
quantity	integer	Yes	Quantity to convert	100
old_product_type	string	Yes	Existing Product type	"DELIVERY"
new_product_type	string	Yes	Product type to convert into	"INTRADAY"
bo_order_id	string	No	Bracket Order ID (Required only for Bracket Orders)	"B0123456"

🟢Success Response - 200 Ok

Field	Type	Description	Example
status	string	Indicates the status of the API call	"success"
code	string	Response status code of the API Request	"s-101"`
message	string	Indicates the request was dispatched to the OMS	Position Conversion Request Sent to OMS
data	object	Contains the order identifier for tracking the conversion	"orderID" : "PCV123456"

📘Data Object Info Field

Field	Type	Description	Example
order_ID	string	System-generated order ID for this conversion request. Pass this to the Position Conversion Inquiry API to check the actual conversion result	"PCV1234556"