> ## 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. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.