Scripwise Settlements Payload

Scripwise trading activity collates all trades to a scrip/instrument. Brokers can use scripwise trading activity to calculate Tax P&L for investors and traders.

API Endpoint  Contact Us  Free Trial

View Workbook

Equity Scripwise Settlements

ParamTypeRequiredDescription
isinstringNoISIN is the international security identification number
symbolstringYesSymbol or description of equity share
is_listedbooleanYesis the equity share listed in public markets
is_stt_paidbooleanYeswas security transaction tax paid on this trade
quantitynumberYesTrading quantity
buy_averagenumberYesAverage buy price across all trades
sell_averagenumberYesAverage sell price across all trades
holding_periodnumberYesHolding period, possible values
intraday, long_term, short_term
brokeragenumberNoBrokerage expense
clearing_chargesnumberNoCharges charged by clearing house
exchange_transaction_chargesnumberNoTransaction charges by exchange
sebi_turnover_feesnumberNoTurnover fees by SEBI
sttnumberNoSecurity Transaction Tax
stamp_dutynumberNoStamp duty paid on transfer of shares
sgstnumberNoState GST
cgstnumberNoCentral GST
igstnumberNoIntegrated GST
other_transfer_expensesnumberNoAny other expense relating to the transfer of shares

Mutual Fund Scripwise Settlements

ParamTypeRequiredDescription
isinstringNoISIN is the international security identification number
scheme_namestringYesSymbol or name of mutual fund
asset_classstringYesAsset class of fund, possible values
equity, debt, other
quantitynumberYesTrading quantity
buy_averagenumberYesAverage buy price across all trades
sell_averagenumberYesAverage sell price across all trades
holding_periodnumberYesHolding period, possible values
short_term, long_term
transfer_expensesnumberNoAny expense relating to the transfer of asset

Futures Scripwise Settlements

ParamTypeRequiredDescription
isinstringNoISIN is the international security identification number
contract_namestringYesName of contract
asset_classstringYesThe asset class of the contract. Possible values
equity, currency & commodity
quantitynumberYesTrading quantity
buy_averagenumberYesAverage buy price across all trades
sell_averagenumberYesAverage sell price across all trades
brokeragenumberNoBrokerage expense
clearing_chargesnumberNoCharges charged by clearing house
exchange_transaction_chargesnumberNoTransaction charges by exchange
sebi_turnover_feesnumberNoTurnover fees by SEBI
sttnumberNoSecurity Transaction Tax
stamp_dutynumberNoStamp duty paid on transfer of shares
sgstnumberNoState GST
cgstnumberNoCentral GST
igstnumberNoIntegrated GST
other_transfer_expensesnumberNoAny other expense relating to the transfer of shares

Options Scripwise Settlements

ParamTypeRequiredDescription
isinstringNoISIN is the international security identification number
contract_namestringYesName of contract
asset_classstringYesThe asset class of the contract. Possible values
equity, currency & commodity
quantitynumberYesTrading quantity
buy_averagenumberYesAverage buy price across all trades
sell_averagenumberYesAverage sell price across all trades
brokeragenumberNoBrokerage expense
clearing_chargesnumberNoCharges charged by clearing house
exchange_transaction_chargesnumberNoTransaction charges by exchange
sebi_turnover_feesnumberNoTurnover fees by SEBI
sttnumberNoSecurity Transaction Tax
stamp_dutynumberNoStamp duty paid on transfer of shares
sgstnumberNoState GST
cgstnumberNoCentral GST
igstnumberNoIntegrated GST
other_transfer_expensesnumberNoAny other expense relating to the transfer of shares

ETF Scripwise Settlements

ParamTypeRequiredDescription
isinstringNoISIN is the international security identification number
scheme_namestringYesSymbol or name of fund
asset_classstringYesAsset class of fund, possible values
equity, debt, other
quantitynumberYesTrading quantity
buy_averagenumberYesAverage buy price across all trades
sell_averagenumberYesAverage sell price across all trades
holding_periodnumberYesHolding period, possible values
short_term, long_term
brokeragenumberNoBrokerage expense
clearing_chargesnumberNoCharges charged by clearing house
exchange_transaction_chargesnumberNoTransaction charges by exchange
sebi_turnover_feesnumberNoTurnover fees by SEBI
sttnumberNoSecurity Transaction Tax
stamp_dutynumberNoStamp duty paid on transfer of shares
sgstnumberNoState GST
cgstnumberNoCentral GST
igstnumberNoIntegrated GST
other_transfer_expensesnumberNoAny other expense relating to the transfer of shares

Bonds Scripwise Settlements

ParamTypeRequiredDescription
isinstringNoISIN is the international security identification number
security_namestringYesSymbol or description of bond
is_listedbooleanYesis the equity share listed in public markets
quantitynumberYesTrading quantity
buy_averagenumberYesAverage buy price across all trades
sell_averagenumberYesAverage sell price across all trades
holding_periodnumberYesHolding period, possible values
short_term, long_term
brokeragenumberNoBrokerage expense
clearing_chargesnumberNoCharges charged by clearing house
exchange_transaction_chargesnumberNoTransaction charges by exchange
sebi_turnover_feesnumberNoTurnover fees by SEBI
sttnumberNoSecurity Transaction Tax
stamp_dutynumberNoStamp duty paid on transfer of shares
sgstnumberNoState GST
cgstnumberNoCentral GST
igstnumberNoIntegrated GST
other_transfer_expensesnumberNoAny other expense relating to the transfer of shares

Debentures Scripwise Settlements

ParamTypeRequiredDescription
isinstringNoISIN is the international security identification number
security_namestringYesSymbol or description of bond
is_listedbooleanYesis the equity share listed in public markets
quantitynumberYesTrading quantity
buy_averagenumberYesAverage buy price across all trades
sell_averagenumberYesAverage sell price across all trades
holding_periodnumberYesHolding period, possible values
short_term, long_term
brokeragenumberNoBrokerage expense
clearing_chargesnumberNoCharges charged by clearing house
exchange_transaction_chargesnumberNoTransaction charges by exchange
sebi_turnover_feesnumberNoTurnover fees by SEBI
sttnumberNoSecurity Transaction Tax
stamp_dutynumberNoStamp duty paid on transfer of shares
sgstnumberNoState GST
cgstnumberNoCentral GST
igstnumberNoIntegrated GST
other_transfer_expensesnumberNoAny other expense relating to the transfer of shares

Sample JSON Payload

{
    "@entity": "workbook",
    "name": "scripwise_pnl_workbook",
    "sheets": [
        {
            "@entity": "sheet",
            "name": "equity_scripwise_pnl_sheet",
            "blocks": [
                {
                    "@entity": "block",
                    "name": "equity_scripwise_pnl_table",
                    "header": [
                        "isin",
                        "symbol",
                        "is_listed",
                        "is_stt_paid",
                        "quantity",
                        "buy_average",
                        "sell_average",
                        "holding_period",
                        "brokerage",
                        "clearing_charges",
                        "exchange_transaction_charges",
                        "sebi_turnover_fees",
                        "stt",
                        "stamp_duty",
                        "sgst",
                        "cgst",
                        "igst",
                        "other_transfer_expenses"
                    ],
                    "rows": [
                        [ "null", "INFY", true, true, 55, 203.5, 300, "long_term", 3, 2, 0, 0, 0, 0, 0, 0, 0, 0 ]
                    ]
                }
            ]
        },
        {
            "@entity": "sheet",
            "name": "mutual_fund_scripwise_pnl_sheet",
            "blocks": [
                {
                    "@entity": "block",
                    "name": "mutual_fund_scripwise_pnl_table",
                    "header": [
                        "isin",
                        "scheme_name",
                        "asset_class",
                        "quantity",
                        "buy_average",
                        "sell_average",
                        "holding_period",
                        "transfer_expenses"
                    ],
                    "rows": [
                        ["ISIN_GROWW", "GROWW TAX SAVING FUND", "debt", 50, 200, 300, "long_term", 3]
                    ]
                }
            ]
        },
        {
            "@entity": "sheet",
            "name": "futures_scripwise_pnl_sheet",
            "blocks": [
                {
                    "@entity": "block",
                    "name": "futures_scripwise_pnl_table",
                    "header": [
                        "isin",
                        "contract_name",
                        "asset_class",
                        "quantity",
                        "buy_average",
                        "sell_average",
                        "brokerage",
                        "clearing_charges",
                        "exchange_transaction_charges",
                        "sebi_turnover_fees",
                        "stt",
                        "stamp_duty",
                        "sgst",
                        "cgst",
                        "igst",
                        "other_transfer_expenses"
                    ],
                    "rows": [
                        [null, "NIFTY", "equity", 12, 4000, 5000, 12 ,23, 0, 0, 0, 0, 0, 0, 0, 0]
                    ]
                }
            ]
        },
        {
            "@entity": "sheet",
            "name": "options_scripwise_pnl_sheet",
            "blocks": [
                {
                    "@entity": "block",
                    "name": "options_scripwise_pnl_table",
                    "header": [
                        "isin",
                        "contract_name",
                        "asset_class",
                        "quantity",
                        "buy_average",
                        "sell_average",
                        "brokerage",
                        "clearing_charges",
                        "exchange_transaction_charges",
                        "sebi_turnover_fees",
                        "stt",
                        "stamp_duty",
                        "sgst",
                        "cgst",
                        "igst",
                        "other_transfer_expenses"
                    ],
                    "rows": [
                        [null, "NIFTY", "equity", 12, 4000, 5000, 12 ,23, 0, 0, 0, 0, 0, 0, 0, 0]
                    ]
                }
            ]
        },
        {
            "@entity": "sheet",
            "name": "etf_scripwise_pnl_sheet",
            "blocks": [
                {
                    "@entity": "block",
                    "name": "etf_scripwise_pnl_table",
                    "header": [
                        "isin",
                        "scheme_name",
                        "asset_class",
                        "quantity",
                        "buy_average",
                        "sell_average",
                        "holding_period",
                        "brokerage",
                        "clearing_charges",
                        "exchange_transaction_charges",
                        "sebi_turnover_fees",
                        "stt",
                        "stamp_duty",
                        "sgst",
                        "cgst",
                        "igst",
                        "other_transfer_expenses"
                    ],
                    "rows": [
                        [ null, "GOLDBEES", "debt", 50, 200, 300, "long_term", 5, 0, 0, 0, 0, 0, 0, 0, 0, 0 ],
                        [ null, "GOLDBEES", "equity", 50, 200, 300, "intraday", 5, 0, 0, 0, 0, 0, 0, 0, 0, 0 ]
                    ]
                }
            ]
        },
        {
            "@entity": "sheet",
            "name": "bonds_scripwise_pnl_sheet",
            "blocks": [
                {
                    "@entity": "block",
                    "name": "bonds_scripwise_pnl_table",
                    "header": [
                        "isin",
                        "security_name",
                        "is_listed",
                        "quantity",
                        "buy_average",
                        "sell_average",
                        "holding_period",
                        "brokerage",
                        "clearing_charges",
                        "exchange_transaction_charges",
                        "sebi_turnover_fees",
                        "stt",
                        "stamp_duty",
                        "sgst",
                        "cgst",
                        "igst",
                        "other_transfer_expenses"
                    ],
                    "rows": [
                        ["ISIN_BOND_SVG", "BOND_SVG", true, 10, 100, 200, "short_term", 20, 0 , 0, 0, 0, 0, 0, 0, 0, 0, 0]
                    ]
                }
            ]
        },
        {
            "@entity": "sheet",
            "name": "debentures_scripwise_pnl_sheet",
            "blocks": [
                {
                    "@entity": "block",
                    "name": "debentures_scripwise_pnl_table",
                    "header": [
                        "isin",
                        "security_name",
                        "is_listed",
                        "quantity",
                        "buy_average",
                        "sell_average",
                        "holding_period",
                        "brokerage",
                        "clearing_charges",
                        "exchange_transaction_charges",
                        "sebi_turnover_fees",
                        "stamp_duty",
                        "sgst",
                        "cgst",
                        "igst",
                        "other_transfer_expenses"
                    ],
                    "rows": [
                        ["ISIN_DEBENTURES_HINDALCO", "DEBENTURES_HINDALCO", false, 30, 200, 100, "short_term", 20, 0, 0, 0, 0, 0, 0, 0, 0]
                    ]
                }
            ]
        }
    ]
}