Cryptocurrency Tax PnL Submit Job Calculator API

Key	Type	Description
from	`number`	From date in EPOCH milliseconds
to	`number`	To date in EPOCH milliseconds
report	`string`	Report format in which output is expected, For eg- “Tradewise”
job_id	`string`	Unique Job ID to track the request
tradebook_url	`string`	Pre-signed url to put your payload
status	`string`	Status of the job created

Cryptocurrency Spot Tradebook Sheet

Cryptocurrency Spot Tradebook Table

Param	Type	Required	Description
id	`String`	No	Transaction ID of the particular trade
date	`Number`	Yes	Trade Timestamp in epoch milliseconds
transaction_type	`String`	Yes	Indicates whether the order is : \n `buy`, `sell`, `trade`, `send`, `receive`
label	`String`	No	Indicates the category of transaction type. \nPossible values:- `interest`, `staking`, `staking\_reward`, `lost`, `mining\_reward`, `airdrop`, `donation`, `fork`, `gift`, `payment`, `other\_income`
received_currency	`String`	Yes	Symbol of the cryptocurrency received \n(If `transaction\_type` = `send`/`sell` pass `null`)
received_quantity	`Number`	Yes	Quantity received by executing the transaction. \n(Required when `received\_currency` ≠ `null`)
price	`Number`	Yes	Price at which unit is traded. \n(If `transaction\_type` = `send`/`receive` pass `null`)
price_currency	`Number`	Yes	Currency in which price is considered. \nPossible values: `INR`, `USD`, `BTC` etc. \n(Required when `price` ≠ `null`)
price_in_inr	`Number`	Yes	Per unit value of the crypto in INR \n(Required when `price\_currency` ≠`INR` or = `null`)
sent_currency	`String`	Yes	Symbol/Name of the crypto sent \n(If `transaction\_type` =`recieve`/`buy` pass `null`).
sent_quantity	`Number`	Yes	Quantity sent by executing the transaction \n(Required if `sent\_currency` ≠ `null`).
fee_currency	`String`	No	Currency in which transaction fees or any other expense was made while executing the transaction
fee_amount	`Number`	No	Amount/quantity spent as fees or other expenses while executing transactions
fee_in_inr	`Number`	No	INR value of the fee paid for the transaction. \n(Required if `fee\_currency` ≠ `INR`)

Last Traded Price List

Param	Type	Description
cryptocurrency_name	`string`	Name of the cryptocurrency, the name should match the name passed in the trade book.
last_traded_price	`number`	The last traded price of the currency

Cryptocurrency Future Tradebook Sheet

Cryptocurrency Future Tradebook Table

Param	Type	Required	Description
id	`String`	No	Transaction ID of the particular trade
date	`Number`	Yes	Trade Timestamp in epoch milliseconds
contract_name	`String`	Yes	Name of the cryptocurrency futures contract being purchased or sold
transaction_type	`String`	Yes	Indicates whether the order is : \n `buy`, `sell`
quantity	`Number`	Yes	Quantity of the contract
price	`Number`	Yes	Price at which unit is traded.
price_currency	`Number`	Yes	Currency in which price is considered. \nPossible values: `INR`, `USD`, `BTC` etc.
price_in_inr	`Number`	Yes	Per unit value of the crypto in INR \n(Required when `price\_currency` ≠`INR` or = `null`)
fee_amount	`Number`	No	Amount/quantity spent as fees or other expenses while executing transactions
fee_currency	`String`	No	Currency in which transaction fees or any other expense was made while executing the transaction
fee_in_inr	`Number`	No	INR value of the fee paid for the transaction. \n(Required if `fee\_currency` ≠ `INR`)

Cryptocurrency Futures Last Traded Price List

Param	Type	Description
contract_name	`string`	Name of the contract
last_traded_price	`number`	Last traded price of the contract

Annexures

Annexure 1: Definition of Transaction Type

Transaction Type	Definition
`buy`	OTC buy transaction on an exchange
`sell`	OTC sell transaction on an exchange
`trade`	Crypto to Crypto transaction on the Exchange
`send`	Crypto sent out of the wallet
`receive`	Crypto received in the wallet

Annexure 2: Label

Label	Definition
`margin`	Amount blocked from the wallet for trading crypto futures
`margin\_gain`	Any gains realized while trading in Crypto Futures
`margin\_loss`	Any losses realized while trading in Crypto Futures
`airdrop`	An unsolicited distribution of a cryptocurrency token or coin, usually for free
`interest`	Cryptocurrency received in the form of Interest on the coins kept as a deposit
`staking`	Lock crypto assets for a set period of time to help support the operation of a blockchain
`staking\_reward`	The reward received for locked crypto assets for a set period of time
`fork`	Crypto received due to hard fork
`gift`	Crypto received as a gift in the wallet
`lost`	Irrecoverable cryptocurrency from wallets
`mining\_reward`	The crypto reward received on mining the coin
`donation`	Defines a transaction that was donated to a charity
`payment`	A transaction that was received as a payment for a good or service
`other income`	Defines any other type of reward received
`transfer`	Transaction between wallets owned by same user.

Annexure 3: Nature of Transaction wise Tax Treatment

Nature of Transaction	Income Head	Tax Rate	Notes
`mining\_reward`	`business\_and\_profession`	`slab\_rate`	Tax is applicable on the fair market value of such asset. (as per the price in the open market on the valuation date).
`interest`	`other`	`slab\_rate`	The complete value of interest is taxable and all kinds of expenses are disallowed.
`trading`	`capital\_gains`	`30%`	Tax is applicable on the “Full value of consideration”, less “Cost of acquisition”.
`staking\_reward`	`other`	`slab\_rate`	The total amount received as reward is taxable and all expenses are disallowed.
`fork`	`other`	`slab\_rate`	The total amount received as reward is taxable and all expenses are disallowed.
`gift\_recieved`	`other`	`slab\_rate`	The total amount received as gift is taxable at a slab rate
`gift\_send`	NA	NA	Any cryptocurrency that was sent as a gift, would not be considered for taxation
`lost`	NA	NA	Any irrecoverable cryptocurrency from wallets, would not be considered for taxation.
`airdrop`	`other`	`slab\_rate`	The complete value of airdrop is taxable and all kinds of expenses are disallowed.
`donation`	NA	NA	Any cryptocurrency that was donated to charity, would not be considered for taxation
`payment\_received`	`other`	`slab\_rate`	Any crypto received as a payment is completely taxable and all expenses are disallowed.
`payment\_send`	`capital\_gains`	`30%`	Tax is applicable on the “Full value of consideration” (as per the price in the open market on the payment date), less “Cost of acquisition”.
`other\_income`	`business\_and\_profession`	`30%`	Any other income generated from crypto is completely taxable and all expenses are disallowed.
`transfer\_in`	NA	NA	Transfers between wallets owned by the same taxpayer are not taxable.
`transfer\_out`	NA	NA	Transfers between wallets owned by the same taxpayer are not taxable.