Holdings

Holdings refer to your collection of long-term investment stocks. Once you buy a stock and add it to your holdings, it remains there until you decide to sell it, the company gets delisted, or changes occur according to stock exchange rules.

Behind the scenes, these stocks are stored safely in your Demat account, which functions like a digital safe deposit box. Exchanges and clearing institutions ensure that everything is settled properly, so you can trust that your investments are secure.

Sample code

CurlPythonNode.js

curl --location 'https://easeapi.venturasecurities.com/portfolio/v1/holdings' \
--header 'x-client-id: AA0605' \
--header 'x-app-key: 8ab5rt7yp2lm9qw4s1ex' \
--header 'Authorization: Bearer eyJraWQiOiJRMUd0YmNyZVwvZWo5U0JZUHBiVGxOc1U1...' 

import requests

url = "https://easeapi.venturasecurities.com/portfolio/v1/holdings"

payload = {}
headers = {
    'x-client-id': 'AA0605',
    'x-app-key': '8ab5rt7yp2lm9qw4s1ex',
    'Authorization': 'Bearer eyJraWQiOiJRMUd0YmNyZVwvZWo5U0JZUHBiVGxOc1U1...'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

const axios = require('axios');

let config = {
  method: 'get',
  maxBodyLength: Infinity,
  url: 'https://easeapi.venturasecurities.com/portfolio/v1/holdings',
  headers: { 
      'x-client-id': 'AA0605', 
      'x-app-key': '8ab5rt7yp2lm9qw4s1ex', 
      'Authorization': 'Bearer eyJraWQiOiJRMUd0YmNyZVwvZWo5U0JZUHBiVGxOc1U1...'
  }
};

axios.request(config)
.then((response) => {
    console.log(JSON.stringify(response.data));
})
.catch((error) => {
    console.log(error);
});

Response

{
  "result": [
    {
      "symbol": "TATASTEEL",
      "isin": "INE081A01020",
      "quantity": 1,
      "average_traded_price": 174.84,
      "investment_value": 174.84,
      "last_traded_price": 135.76,
      "current_value": 135.76,
      "exchange": "NSE",
      "profit_loss": -39.08,
      "profit_loss_percentage": -22.35,
      "mtf_quantity": 0,
      "todays_profit_loss": 1.22,
      "todays_profit_loss_percentage": 0.91
    }
  ],
  "error_message": ""
}

Response parameters

Parameter	Description
symbol	It is the name of the instrument you are holding
isin	It is International Securities Identification Number of the held instrument
quantity	The total quantity of number of shares for equity or lots (F&O contracts) you want to buy/sell are being held
average_traded_price	It is the average price at which the instrument was bought if purchased at different prices
investment_value	It shows us the total invested value in the instrument you are holding
last_traded_price	It is the last traded price of the instrument you are holding
current_value	It shows the current invested value based on last traded price or the current market price in the holding instrument
exchange	The stock exchange where the trade will occur, like the National Stock Exchange (NSE) or the Bombay Stock Exchange (BSE)
profit_loss	It is the profit (or)loss of the instrument you are holding
profit_loss_percentage	It shows us the profit (or) loss percentage of the instrument you are holding
mtf_quantity	It is the number of stocks purchased using MTF (Margin Trading Facility)
todays_profit_loss	It is today's profit and loss amount for the held instrument
todays_profit_loss_percentage	It is today's profit and loss percentage for the held instrument