> ## Documentation Index
> Fetch the complete documentation index at: https://quickoinfosoftprivatelimited.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Crypto Tradebook

> Tradebook provides you with all the trades that have been executed by an investor or trader. Brokers/Exchanges can share Tradebook to Report and calculate the Taxes

## Overview

The Crypto Tradebook API provides a comprehensive record of all cryptocurrency transactions executed by a user. This includes buy/sell transactions, crypto-to-crypto swaps, transfers, staking rewards, mining rewards, and other income events. This data is critical for Quicko to:

* Calculate capital gains and losses on cryptocurrency transactions
* Track cost basis for tax compliance
* Report cryptocurrency income (mining, staking, airdrops, etc.)
* Prepare accurate crypto tax reports
* Ensure compliance with tax regulations on virtual digital assets

> [!NOTE]
>
> **Important**
>
> All the transactions should be passed in the request since inception of the account to ensure accurate tax calculations and compliance.

## Response Format

Your API should return cryptocurrency transaction data with the following structure:

| Param | Type | Required | Description |
| - | - | - | - |
| id | Number | Optional | Transaction ID of the particular trade |
| date | Number | Yes | Trade Timestamp in epoch milliseconds |
| transaction\_type | String | Yes | Indicates whether the order is :buy, sell, trade, send, receive |
| label | String | Optional | Indicates the category of transaction type.Possible values :- interest, staking, staking\_reward, lost, mining\_reward, airdrop, donation, fork, gift, payment, other\_income |
| received\_currency | String | Yes | Symbol of the cryptocurrency received(If transaction\_type = send/sellpass null) |
| received\_quantity | Number | Yes | Quantity received by executing the transaction.(Required when received\_currency ≠ null) |
| price | Number | Yes | Price at which unit is traded.(If transaction\_type = send/receivepass null) |
| price\_currency | Number | Yes | Currency in which price is considered.Possible values: INR, USD, BTC etc.(Required when price ≠ null) |
| price\_in\_inr | Number | Yes | Per unit value of the crypto in INR(Required when price\_currency ≠INR or = null) |
| sent\_currency | String | Yes | Symbol/Name of the crypto sent(If transaction\_type =recieve/buy pass null). |
| sent\_quantity | Number | Yes | Quantity sent by executing the transaction(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.(Required if fee\_currency ≠ INR) |

> [!NOTE]
>
> **Note**
>
> Whenever a field is blank pass `null`

> [!NOTE]
>
> **Important**
>
> All the Transactions should be passed in the request since inception of the account.

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

## Label

| Label | Definition |
| - | - |
| 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 |


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