Domestic Securities Holdings

Overview

The Domestic Securities Holdings API provides a snapshot of all securities currently held by a user on a specific date. This includes equities, mutual funds, and ETFs. Holdings data is critical for Quicko to understand the user’s portfolio composition, calculate capital gains/losses, and prepare accurate tax reports.

Query Parameters

Your API should accept an as_on_date query parameter to retrieve holdings for a specific date. This allows Quicko to fetch historical holdings snapshots when needed for tax compliance and regulatory reporting.

GET /securities/domestic/holdings?as_on_date=YYYY-MM-DD

Response Format

Your API should return holdings data organized by three categories:

Equity Holdings

Equity holdings data should include the following fields:

Param	Type	Required	Description
isin	string	Yes	ISIN is the international security identification number
symbol	string	Yes	Symbol or description of the instrument
quantity	number	Yes	Quantity of shares held of the instrument
buy_date	number	Yes	buy date epoch
buy_average	number	Yes	Average buy price across all trades
label	string	No	Refer to Annexure for possible values
last_traded_price	number	Yes	Last traded price of the instrument

Mutual Fund Holdings

Mutual fund holdings data should include the following fields:

Param	Type	Required	Description
isin	string	Yes	ISIN is the international security identification number
symbol	string	Yes	Symbol or description of the scheme
scheme_type	enum	Yes	Scheme type of mutual fundPossible values are : Equity, Debt, Other
quantity	number	Yes	Quantity of units held of the scheme
buy_date	number	Yes	buy date epoch
buy_average	number	Yes	Average buy price across all trades
label	string	No	Refer to Annexure for possible values
last_traded_price	number	Yes	Pervious closing NAV for the scheme

ETF Holdings

ETF holdings data should include the following fields:

Param	Type	Required	Description
isin	string	Yes	ISIN is the international security identification number
symbol	string	Yes	Symbol or description of the ETF
asset_class	enum	Yes	Scheme type of ETFPossible values are : Equity, Debt, Other
quantity	number	Yes	Quantity of units held of the scheme
buy_date	number	Yes	buy date epoch
buy_average	number	Yes	Average buy price across all trades
label	string	No	Refer to Annexure for possible values
last_traded_price	number	Yes	Last traded price of the instrument

Annexure

Corporate Action	ENUM
Amalgamation	amalgamation
Bonus Issue	bonus_issue
Buy Back of Shares	buy_back
Consolidation of Shares	consolidation
Dividend	dividend
Dividend on Preference Shares	dividend
Income Distribution (InvIT)	income_distribution_invit
Income Distribution RITES	income_distribution_rites
InvIT - Return of CapitaL	return_of_capital_invit
Preferential Issue of shares	preferential_issue
Reduction of Capital	reduction_of_capital
Right Issue of Equity Shares	right_issue
Scheme of Arrangement	scheme_of_arrangement
Spin Off	spin_off
Stock Split	stock_split
Voluntary Delisting of Shares	voluntary_delisting_of_share
Donation of security	donation
Transfer of securities in form of gift	transfer
Loss of security	lost
Transfer of securities	transfer
Other	other

Quantity of HoldingsThe holding quantity in the response should be unpledged.

Getting started

OAuth

Profile

Broker Integration

Crypto Integration

HRMS Integration

Bank Integration

Overview

Query Parameters

Response Format

Equity Holdings

Mutual Fund Holdings

ETF Holdings

Annexure

​Overview

​Query Parameters

​Response Format

​Equity Holdings

​Mutual Fund Holdings

​ETF Holdings

​Annexure

Overview

Query Parameters

Response Format

Equity Holdings

Mutual Fund Holdings

ETF Holdings

Annexure