Groww LogoGroww API

Portfolio

Get detailed information about your holdings and positions.

Get Holdings

GET https://api.groww.in/v1/holdings/user

This api can be used to retrieve the current stock holdings of the user stored in the user's DEMAT account

Request

# You can also use wget
curl -X GET https://api.groww.in/v1/holdings/user \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'X-API-VERSION: 1.0'

Response

{
  "status": "SUCCESS",
  "payload": {
    "holdings": [
      {
        "isin": "INE545U01014",
        "trading_symbol": "RELIANCE",
        "quantity": 10,
        "average_price": 100,
        "pledge_quantity": 2,
        "demat_locked_quantity": 1,
        "groww_locked_quantity": 1.5,
        "repledge_quantity": 0.5,
        "t1_quantity": 3,
        "demat_free_quantity": 5,
        "corporate_action_additional_quantity": 1,
        "active_demat_transfer_quantity": 1
      }
    ]
  }
}

Response Schema

NameTypeDescription
statusstringSUCCESS if request is processed successfully, FAILURE if the request failed
isinstringThe ISIN (International Securities Identification number) of the symbol
trading_symbolstringThe trading symbol of the holding
quantityintegerThe net quantity of the holding
average_pricedecimalThe average price of the holding in Rupees
pledge_quantitydecimalThe pledged quantity of the holding
demat_locked_quantitydecimalThe demat locked quantity of the holding
groww_locked_quantitydecimalThe Groww locked quantity of the holding
repledge_quantitydecimalThe repledged quantity of the holding
t1_quantitydecimalThe T1 quantity of the holding
demat_free_quantitydecimalThe demat free quantity of the holding
corporate_action_additional_quantityintegerThe corporate action additional quantity of the holding
active_demat_transfer_quantityintegerThe active demat transfer quantity of the holding

Get Position for User

GET https://api.groww.in/v1/positions/user

This api can be used to get the positions of the user. Positions are the assets that the user holds in his/her account.

Request

# You can also use wget
curl -X GET https://api.groww.in/v1/positions/user \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'X-API-VERSION: 1.0'

Request schema

NameTypeDescription
segmentstringSegment of the instrument such as CASH, FNO etc.
CASH,FNO

*required parameters

Response

{
  "status": "SUCCESS",
  "payload": {
    "positions": [
      {
        "trading_symbol": "RELIANCE",
        "credit_quantity": 10,
        "credit_price": 12500,
        "debit_quantity": 5,
        "debit_price": 12000,
        "carry_forward_credit_quantity": 8,
        "carry_forward_credit_price": 12300,
        "carry_forward_debit_quantity": 3,
        "carry_forward_debit_price": 11800,
        "exchange": "NSE",
        "symbol_isin": "INE123A01016",
        "quantity": 15,
        "product": "CNC",
        "net_carry_forward_quantity": 10,
        "net_price": 12400,
        "net_carry_forward_price": 12200
      }
    ]
  }
}

Response Schema

NameTypeDescription
statusstringSUCCESS if request is processed successfully, FAILURE if the request failed
trading_symbolstringTrading symbol of the instrument
segmentstringSegment of the instrument such as CASH, FNO etc.
credit_quantityintQuantity of credited instruments
credit_priceintAverage price in rupees of credited instruments
debit_quantityintQuantity of debited instruments
debit_priceintAverage price in rupees of debited instruments
carry_forward_credit_quantityintQuantity of carry forward credited instruments
carry_forward_credit_priceintAverage price in rupees of carry forward credited instruments
carry_forward_debit_quantityintQuantity of carry forward debited instruments
carry_forward_debit_priceintAverage price in rupees of carry forward debited instruments
exchangestringStock exchange
symbol_isinstringISIN (International Securities Identification number) of the symbol
quantityintNet quantity of instruments
productstringProduct type
net_carry_forward_quantityintNet carry forward quantity of instruments
net_priceintNet average price in rupees of instruments
net_carry_forward_priceintNet average price in rupees of carry forward instruments

Get Position for trading Symbol

GET https://api.groww.in/v1/positions/trading-symbol

This api can be used to get the positions of the user for a particular instrument.

Request

# You can also use wget
curl -X GET https://api.groww.in/v1/positions/trading-symbol?trading_symbol=string&segment=CASH \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'X-API-VERSION: 1.0'

Request schema

NameTypeDescription
statusstringSUCCESS if request is processed successfully, FAILURE if the request failed
trading_symbol *stringTrading Symbol of the instrument as defined by the exchange
segmentstringSegment of the instrument such as CASH, FNO etc.
CASH,FNO

*required parameters

Response

{
  "status": "SUCCESS",
  "payload": {
    "positions": [
      {
        "trading_symbol": "RELIANCE",
        "credit_quantity": 10,
        "credit_price": 12500,
        "debit_quantity": 5,
        "debit_price": 12000,
        "carry_forward_credit_quantity": 8,
        "carry_forward_credit_price": 12300,
        "carry_forward_debit_quantity": 3,
        "carry_forward_debit_price": 11800,
        "exchange": "NSE",
        "symbol_isin": "INE123A01016",
        "quantity": 15,
        "product": "CNC",
        "net_carry_forward_quantity": 10,
        "net_price": 12400,
        "net_carry_forward_price": 12200
      }
    ]
  }
}

Response Schema

NameTypeDescription
trading_symbolstringTrading symbol of the instrument.
segmentstringSegment of the instrument such as CASH, FNO etc.
credit_quantityintQuantity of credited instruments
credit_priceintAverage price in rupees of credited instruments
debit_quantityintQuantity of debited instruments
debit_priceintAverage price in rupees of debited instruments
carry_forward_credit_quantityintQuantity of carry forward credited instruments
carry_forward_credit_priceintAverage price in rupees of carry forward credited instruments
carry_forward_debit_quantityintQuantity of carry forward debited instruments
carry_forward_debit_priceintAverage price in rupees of carry forward debited instruments
exchangestringStock exchange
symbol_isinstringISIN (International Securities Identification number) of the symbol
quantityintNet quantity of instruments
productstringProduct type
net_carry_forward_quantityintNet carry forward quantity of instruments
net_priceintNet average price in rupees of instruments
net_carry_forward_priceintNet average price in rupees of carry forward instruments

On this page