> ## Documentation Index > Fetch the complete documentation index at: https://developer.sandbox.co.in/llms.txt > Use this file to discover all available pages before exploring further. # Tradebook | Crypto ## 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. |