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
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.
