Capital Gains

About

  • This API can take in transactions details of equity and mutual_fund trades and calculates Long Term and Short Term capital gains on such trades.

Definitions

  • Capital Gain is simply the profit or loss that arises when you transfer a Capital Asset.
  • Capital Asset means any kind of property owned by you, whether or not connected with your business or profession.

Usecases

  • Brokerages and Mutual Funds Dealers can use this API to showcase their customers how much income will be generated post Capital Gains Deductions.

📘

Know More

Capital Gains and Taxes: A Complete Guide


Endpoint

HTTP Method

Endpoint

Description

POST

/calculators/income-tax/securities/capital-gains

A Request Body (JSON) is uploaded for calculating the Capital Gains.

API EndpointAPI Endpoint

Request Body

Equity Trade

Param

Type

Description

Example

symbol

string

Symbol or description of equity share

5PAISA

isin

string

ISIN is the international security identification number

INE618L01018

buy_date

date

Purchase date of the equity

2018-07-11T03:05:00

buy_average

num

Average cost of one equity bought

186.4

quantity

num

Number of the equity bought

2.0

sell_date

date

Sell date of the equity

2019-04-11T08:05:00

sell_average

num

Average sale price of one equity sold

235.1

fmv

num

High stock price on 31/01/2018

0.0

charges

num

Charges charged by clearing house

0.0

Mutual Fund Trade

Param

Type

Description

Example

symbol

string

Symbol or description of Mutual Fund

Axis Liquid Fund - Direct Plan

isin

string

ISIN is the international security identification number

INF846K01CX4

asset_class

string

Scheme type, possible values
Equity, Debt, Other

Debt

buy_date

date

Purchase date of the MF units

2018-05-29T03:05:00

buy_average

num

Average cost of one MF unit bought

1948.9817

quantity

num

Number of the MF unit bought

0.513

sell_date

date

Sell date of the MF unit

2019-08-13T03:08:00

sell_average

num

Average sale price of one MF unit sold

2127.2655

fmv

num

High MF Unit price on 31/01/2018

0.0

charges

num

Charges charged by clearing house

91.4596


Response

Param

Description

Example

coa

186.4

holding_period

Long Term or Short Term

Short Term

gross_profit

Gross Profit

97.4

net_profit

Net Profit

97.4


Did this page help you?