> ## Documentation Index
> Fetch the complete documentation index at: https://developer.quicko.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Domestic Securities Tradebook
> A comprehensive trade book for domestic securities including equity, mutual funds, F&O, and foreign securities
## Overview
The Domestic Securities Tradebook API provides a comprehensive record of all trades executed by a user for domestic securities. A trade book includes details of every buy and sell transaction, along with associated taxes and expenses. This data is critical for Quicko to:
* Calculate capital gains and losses
* Track cost basis and holding periods for tax compliance
* Identify tax harvesting opportunities
* Prepare accurate tax reports and maintain audit trails
* Ensure compliance with tax regulations
## Query Parameters
Your API should accept `from` and `to` query parameters to retrieve trades within a specific date range. Quicko typically requests all trades since account inception for accurate tax calculations.
```
GET /domestic-securities-trade-book?from=YYYY-MM-DD&to=YYYY-MM-DD
```
**Important**
All the transactions should be passed in the request since inception of the account to ensure accurate tax calculations and compliance.
## Trade Types
Domestic equity share transactions with tax expense breakdowns
Mutual fund purchase and redemption transactions
Derivative contracts including futures and options trading
International equity, mutual funds, and derivative trades
## Equity Trades
Domestic equity share transactions with comprehensive tax expense breakdowns.
| Param | Type | Description |
| ----------------- | ------ | -------------------------------------------------------- |
| transaction\_id | string | Transaction Id to uniquely identify the transaction |
| symbol | string | Symbol or description of equity share |
| quantity | number | Trading quantity |
| date | number | Transaction epoch timestamp |
| price | number | Transaction price |
| transaction\_type | string | Transaction type from possible values of 'BUY' or 'SELL' |
| Param | Type | Description |
| ------------------------------ | ------ | -------------------------------------------------------- |
| isin | string | ISIN is the international security identification number |
| fmv | number | High stock price on 31/01/2018 |
| brokerage | number | Brokerage expense |
| clearing\_charges | number | Charges charged by clearing house |
| exchange\_transaction\_charges | number | Transaction charges by exchange |
| sebi\_turnover\_fees | number | Turnover fees by SEBI |
| stt | number | Security Transaction Tax |
| stamp\_duty | number | Stamp duty paid on transfer of shares |
| sgst | number | State GST |
| cgst | number | Central GST |
| igst | number | Integrated GST |
| interest | number | Interest paid on margins eg Margin Trading Facility |
| depository\_charges | number | Depository charges paid on delivery of shares |
| other\_transfer\_expenses | number | Any other expense relating to the transfer of shares |
| corporate\_action | string | Corporate Action. Possible values: BUY\_BACK, DIVIDEND |
## Mutual Fund Trades
Mutual fund purchase and redemption transactions with scheme classification.
| Param | Type | Description |
| ----------------- | ------ | ----------------------------------------------------------- |
| transaction\_id | string | Transaction Identifier to uniquely identify the transaction |
| type | string | Scheme type, possible values: Equity, Debt, Other |
| symbol | string | Symbol or description of mutual fund scheme |
| quantity | number | Trading quantity (units) |
| date | number | Transaction epoch timestamp |
| price | number | NAV (Net Asset Value) at transaction |
| transaction\_type | string | Transaction type possible values: 'BUY', 'SELL' |
| Param | Type | Description |
| ------------------------------ | ------ | -------------------------------------------------------- |
| isin | string | ISIN is the international security identification number |
| fmv | number | High stock price on 31/01/2018 |
| brokerage | number | Brokerage expense |
| clearing\_charges | number | Charges charged by clearing house |
| exchange\_transaction\_charges | number | Transaction charges by exchange |
| sebi\_turnover\_fees | number | Turnover fees by SEBI |
| stt | number | Security Transaction Tax |
| stamp\_duty | number | Stamp duty paid on transfer of shares |
| sgst | number | State GST |
| cgst | number | Central GST |
| igst | number | Integrated GST |
| other\_transfer\_expenses | number | Any other expense relating to the transfer of units |
## Futures and Options Trades
Derivative contracts including futures and options trading with comprehensive expense tracking.
| Param | Type | Description |
| ----------------- | ------ | ----------------------------------------------------------- |
| transaction\_id | string | Transaction identifier to uniquely identify the transaction |
| symbol | string | Symbol or description of the derivative contract |
| type | string | Type, possible values: Futures, Options |
| quantity | number | Trading quantity (lot size) |
| date | number | Transaction epoch timestamp |
| price | number | Transaction price |
| transaction\_type | string | Transaction type possible values: 'BUY', 'SELL' |
| Param | Type | Description |
| ------------------------------ | ------ | --------------------------------------------------- |
| brokerage | number | Brokerage expense |
| clearing\_charges | number | Charges charged by clearing house |
| exchange\_transaction\_charges | number | Transaction charges by exchange |
| sebi\_turnover\_fees | number | Turnover fees by SEBI |
| stt | number | Security Transaction Tax |
| stamp\_duty | number | Stamp duty paid on transfer |
| sgst | number | State GST |
| cgst | number | Central GST |
| igst | number | Integrated GST |
| interest | number | Interest paid on margins eg Margin Trading Facility |
| other\_transfer\_expenses | number | Any other expense relating to the transfer |
## Foreign Securities
International equity share transactions.
| Param | Type | Required | Description |
| ------------------ | ------ | -------- | ----------------------------------------------------------- |
| transaction\_id | string | Yes | Transaction Identifier to uniquely identify the transaction |
| isin | string | No | ISIN is the international security identification number |
| symbol | string | Yes | Symbol or description of equity share |
| quantity | number | Yes | Trading quantity |
| date | number | Yes | Transaction epoch timestamp |
| price | number | Yes | Transaction price |
| transaction\_type | string | Yes | Transaction type from possible values of 'BUY' or 'SELL' |
| transfer\_expenses | number | Yes | Transfer expense |
| corporate\_action | string | No | Corporate Action. Possible values: BUY\_BACK, DIVIDEND |
American Depositary Receipt transactions.
| Param | Type | Required | Description |
| ------------------ | ------ | -------- | ----------------------------------------------------------- |
| transaction\_id | string | No | Transaction Identifier to uniquely identify the transaction |
| isin | string | No | ISIN is the international security identification number |
| symbol | string | Yes | Symbol or description of ADR |
| quantity | number | Yes | Trading quantity |
| date | number | Yes | Transaction epoch timestamp |
| price | number | Yes | Transaction price |
| transaction\_type | string | Yes | Transaction type from possible values of 'BUY' or 'SELL' |
| transfer\_expenses | number | Yes | Transfer expense |
| corporate\_action | string | No | Corporate Action. Possible values: BUY\_BACK, DIVIDEND |
Foreign mutual fund transactions.
| Param | Type | Required | Description |
| ------------------ | ------ | -------- | ----------------------------------------------------------- |
| transaction\_id | string | Yes | Transaction Identifier to uniquely identify the transaction |
| isin | string | No | ISIN is the international security identification number |
| type | string | Yes | Scheme type, possible values: Equity, Debt, Other |
| symbol | string | Yes | Symbol or description of mutual fund scheme |
| quantity | number | Yes | Trading quantity (units) |
| date | number | Yes | Transaction epoch timestamp |
| price | number | Yes | NAV (Net Asset Value) at transaction |
| transaction\_type | string | Yes | Transaction type from possible values of 'BUY' or 'SELL' |
| transfer\_expenses | number | Yes | Transfer expense |
Foreign futures and options trading.
| Param | Type | Required | Description |
| ------------------ | ------ | -------- | ----------------------------------------------------------- |
| transaction\_id | string | Yes | Transaction Identifier to uniquely identify the transaction |
| symbol | string | Yes | Symbol or description of the derivative contract |
| type | string | Yes | Type, possible values: Futures, Options |
| quantity | number | Yes | Trading quantity (lot size) |
| date | number | Yes | Transaction epoch timestamp |
| price | number | Yes | Transaction price |
| transaction\_type | string | Yes | Transaction type possible values: 'BUY', 'SELL' |
| transfer\_expenses | number | Yes | Transfer expenses |
For foreign securities, transfer expenses typically include foreign exchange fees, wire transfer charges, and custodian fees.
## Corporate Actions
Use these standard enumeration values when reporting corporate actions in trade data.
Corporate actions can significantly impact capital gains calculations. Ensure you use the correct enum value for accurate tax reporting.
| Corporate Action | ENUM Value | Description |
| ---------------------------- | ----------------- | -------------------------------------------------- |
| Bonus Issue | **BONUS\_ISSUE** | Free additional shares to shareholders |
| Stock Split | **STOCK\_SPLIT** | Subdivision of existing shares |
| Consolidation of Shares | **CONSOLIDATION** | Reverse stock split |
| Right Issue of Equity Shares | **RIGHT\_ISSUE** | Additional shares offered to existing shareholders |
| Corporate Action | ENUM Value | Description |
| --------------------------- | ------------------------------- | ------------------------------ |
| Dividend | **DIVIDEND** | Cash or stock dividend payment |
| Income Distribution (InvIT) | **INCOME\_DISTRIBUTION\_INVIT** | InvIT income distribution |
| Income Distribution RITES | **RITES** | RITES income distribution |
| InvIT - Return of Capital | **RETURN\_OF\_CAPITAL\_INVIT** | Return of capital from InvIT |
| Corporate Action | ENUM Value | Description |
| --------------------- | --------------------------- | ------------------------------- |
| Amalgamation | **AMALGAMATION** | Merger of two or more companies |
| Scheme of Arrangement | **SCHEME\_OF\_ARRANGEMENT** | Corporate restructuring scheme |
| Spin Off | **SPIN\_OFF** | Separation of business division |
| Corporate Action | ENUM Value | Description |
| ----------------------------- | -------------------------- | ------------------------------------ |
| Buy Back of Shares | **BUY\_BACK** | Company repurchasing its own shares |
| Reduction of Capital | **REDUCTION\_OF\_CAPITAL** | Reduction in company's share capital |
| Preferential Issue of shares | **PREFERENTIAL\_ISSUE** | Private placement of shares |
| Voluntary Delisting of Shares | **DELISTING** | Removal from stock exchange listing |
When processing corporate actions, ensure you maintain the continuity of cost basis and holding period for accurate capital gains tax calculations.