Portfolio¶
This API lets you retrieve holdings and positions in your portfolio.
| Method | API | Detail |
|---|---|---|
| Get | /holdings | Retrieve the list of long term equity holdings |
| Get | /positions | Retrieve the list of short term positions |
| POST | /positions/convert | Convert intraday to long term or long term to intraday |
Holdings¶
Holdings contain the long term equity Holdings of the customer. All the financial instruments in the holdings reside in the customer’s DEMAT account indefinitely until its sold or is delisted or changed by the exchanges. Changes to DEMAT account is settled in T+1 days.
Response Structure
{
"status": "Ok",
"message": "Success",
"result": [
{
"poa": false,
"product": "CNC",
"holdings": [
{
"isin": "INF209KB15K4",
"realizedPnl": "0.0",
"unrealizedPnl": "-14.21",
"netPnl": "-14.21",
"netQty": "1",
"buyPrice": "14.21",
"holdQty": "0",
"dpQty": "0",
"benQty": "0",
"unpledgedQty": "0",
"collateralQty": "0",
"brkCollQty": "1",
"btstQty": "0",
"usedQty": "0",
"tradedQty": "0",
"sellableQty": "0",
"authQty": "0",
"authFlag": false,
"sellAmount": "0.0",
"symbol": [
{
"exchange": "NSE",
"token": "10690",
"tradingSymbol": "NIFTYQLITY-EQ",
"pdc": "16.54",
"ltp": "16.54"
},
{
"exchange": "BSE",
"token": "543574",
"tradingSymbol": "NIFTYQLITY",
"pdc": "16.54",
"ltp": "16.54"
}
]
},
{
"isin": "INE669E01016",
"realizedPnl": "0.0",
"unrealizedPnl": "-16.16",
"netPnl": "-16.16",
"netQty": "2",
"buyPrice": "8.08",
"holdQty": "0",
"dpQty": "0",
"benQty": "0",
"unpledgedQty": "0",
"collateralQty": "0",
"brkCollQty": "2",
"btstQty": "0",
"usedQty": "0",
"tradedQty": "0",
"sellableQty": "0",
"authQty": "0",
"authFlag": false,
"sellAmount": "0.0",
"symbol": [
{
"exchange": "NSE",
"token": "14366",
"tradingSymbol": "IDEA-EQ",
"pdc": "13.55",
"ltp": "13.55"
},
{
"exchange": "BSE",
"token": "532822",
"tradingSymbol": "IDEA",
"pdc": "13.54",
"ltp": "13.54"
}
]
},
{
"isin": "INE512B01022",
"realizedPnl": "0.0",
"unrealizedPnl": "-4.86",
"netPnl": "-4.86",
"netQty": "2",
"buyPrice": "2.43",
"holdQty": "0",
"dpQty": "0",
"benQty": "0",
"unpledgedQty": "0",
"collateralQty": "0",
"brkCollQty": "2",
"btstQty": "0",
"usedQty": "0",
"tradedQty": "0",
"sellableQty": "0",
"authQty": "0",
"authFlag": false,
"sellAmount": "0.0",
"symbol": [
{
"exchange": "NSE",
"token": "11999",
"tradingSymbol": "FCSSOFT-EQ",
"pdc": "2.9",
"ltp": "2.9"
},
{
"exchange": "BSE",
"token": "532666",
"tradingSymbol": "FCSSOFT",
"pdc": "2.88",
"ltp": "2.88"
}
]
},
{
"isin": "INF457M01133",
"realizedPnl": "0.0",
"unrealizedPnl": "-40.83",
"netPnl": "-40.83",
"netQty": "1",
"buyPrice": "40.83",
"holdQty": "0",
"dpQty": "0",
"benQty": "0",
"unpledgedQty": "0",
"collateralQty": "0",
"brkCollQty": "1",
"btstQty": "0",
"usedQty": "0",
"tradedQty": "0",
"sellableQty": "0",
"authQty": "0",
"authFlag": false,
"sellAmount": "0.0",
"symbol": [
{
"exchange": "NSE",
"token": "2328",
"tradingSymbol": "CPSEETF-EQ",
"pdc": "54.35",
"ltp": "54.35"
},
{
"exchange": "BSE",
"token": "538057",
"tradingSymbol": "CPSEETF",
"pdc": "54.33",
"ltp": "54.33"
}
]
},
{
"isin": "INE482J01021",
"realizedPnl": "0.0",
"unrealizedPnl": "-5.86",
"netPnl": "-5.86",
"netQty": "2",
"buyPrice": "2.93",
"holdQty": "0",
"dpQty": "0",
"benQty": "0",
"unpledgedQty": "0",
"collateralQty": "0",
"brkCollQty": "2",
"btstQty": "0",
"usedQty": "0",
"tradedQty": "0",
"sellableQty": "0",
"authQty": "0",
"authFlag": false,
"sellAmount": "0.0",
"symbol": [
{
"exchange": "NSE",
"token": "20296",
"tradingSymbol": "SHAH-EQ",
"pdc": "2.7",
"ltp": "2.7"
},
{
"exchange": "BSE",
"token": "533275",
"tradingSymbol": "SHAH",
"pdc": "2.67",
"ltp": "2.67"
}
]
},
{
"isin": "INE937C01029",
"realizedPnl": "0.0",
"unrealizedPnl": "-5.25",
"netPnl": "-5.25",
"netQty": "1",
"buyPrice": "5.25",
"holdQty": "0",
"dpQty": "0",
"benQty": "0",
"unpledgedQty": "0",
"collateralQty": "0",
"brkCollQty": "1",
"btstQty": "0",
"usedQty": "0",
"tradedQty": "0",
"sellableQty": "0",
"authQty": "0",
"authFlag": false,
"sellAmount": "0.0",
"symbol": [
{
"exchange": "NSE",
"token": "9257",
"tradingSymbol": "NILAINFRA-BE",
"pdc": "6.65",
"ltp": "6.65"
},
{
"exchange": "BSE",
"token": "530377",
"tradingSymbol": "NILA",
"pdc": "6.61",
"ltp": "6.61"
}
]
}
]
}
]
}
Parameters
| Field | Type | Description |
|---|---|---|
| isin | String | Exchange |
| realizedPnl | String | |
| unrealizedPnl | String | |
| netPnl | String | |
| netQty | String | |
| buyPrice | String | Refer Trading Symbol at Page No |
| holdQty | String | |
| dpQty | String | Refer Trading Symbol at Page No |
| benQty | String | Refer Trading Symbol at Page No |
| unpledgedQty | String | Refer Trading Symbol at Page No |
| collateralQty | String | |
| brkCollQty | String | |
| btstQty | String | Quantities not delivered in demat account |
| usedQty | String | Universal standard id for each scrip |
| tradedQty | String | |
| sellableQty | String | |
| authQty | String | |
| authFlag | String | |
| sellAmount | String | |
| symbol | String | |
| exchange | String | |
| token | String | |
| tradingSymbol | ||
| NILAINFRA-BE | ||
| pdc | String | |
| ltp | String |
Positions¶
Response Structure
{
"status": "Ok",
"message": "Success",
"result": [
{
"displayName": "GOLDPETAL NOV FUT",
"tradingsymbol": "GOLDPETAL30NOV23",
"token": "259245",
"exchange": "MCX",
"product": "MIS",
"netQty": "1",
"netAvgPrice": "5996.0",
"buyQty": "1",
"buyPrice": "5996.0",
"sellQty": "0",
"sellPrice": "0.0",
"mtm": null,
"mtmBuyPrice": "5996.0",
"mtmSellprice": "0.0",
"pnl": null,
"realizedPnl": "-0.0",
"unrealizedPnl": "0.00",
"multiplier": "1",
"lotsize": "1",
"pnlLotsize": "1",
"ticksize": "1.00",
"pdc": "6027.0",
"ltp": "5996.00",
"breakevenPrice": "5996.0",
"overnightQty": "0",
"overnightPrice": "0.0",
"orderType": "Regular"
}
]
}
| Field | Type | Description |
|---|---|---|
| displayName | String | |
| tradingSymbol | String | Refer Trading Symbol in Tables |
| token | String | Exchange & Segment |
| exchange | String | Exchange standard id for each scrip. Refer here |
| product | String | Product type |
| netQty | float | Average buy price |
| netBuyQty | Int | Total quantity bought |
| netAvgPrice | String | //// |
| buyQty | String | //// |
| buyPrice | String | //// |
| sellQty | String | //// |
| sellPrice | String | //// |
| mtm | String | //// |
| mtmBuyPrice | String | //// |
| mtmsellPrice | String | //// |
| pnl | String | //// |
| realizedpnl | String | //// |
| unrealizedpnl | String | //// |
| multiplier | String | //// |
| lotSize | String | //// |
| tickSize | String | //// |
| pnlLotsize | String | |
| ticksize | String | |
| pdc | String | |
| ltp | String | |
| breakevenPrice | String | |
| overnightQty | String | |
| overnightPrice | String | |
| orderType | String |
Convert Position¶
Request Structure
{
"exchange": "MCX",
"token": "259245",
"tradingSymbol": "GOLDPETAL30NOV23",
"qty": 1,
"product": "NRML",
"prevProduct": "MIS",
"transType": "B",
"orderSource": "WEB",
"posType": "Day"
}
| Field | Type | Description |
|---|---|---|
| exchange | String | Exchange standard id for each scrip |
| token | String | Position Type |
| tradingSymbol | String | Position Type |
| qty | String | Exchange standard id for each scrip. Refer here |
| product | String | Refer Trading Symbol in Tables |
| prevProduct | Int | No of shares modification is desired |
| tranType | String | |
| orderSource | String | |
| posType | String |