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

# Overview

> Calculate profit & loss and capital gains tax across securities (domestic and foreign) and cryptocurrency transactions.

# Tax P\&L Calculator APIs

The Tax P\&L Calculator APIs compute profit and loss for investment transactions across different asset classes, with automatic holding period classification and capital gains tax calculation.

## Capabilities

### Profit & Loss Calculation

Calculate realized and unrealized gains/losses for:

* **Domestic Securities**: Equity shares, mutual funds, derivatives with holding period classification
* **Foreign Securities**: International investments with currency conversion and holding period classification
* **Cryptocurrency**: Digital asset transactions with holding period tracking

### Tax Classification

Automatic classification based on holding periods and asset types:

* **Short-term Capital Gains**: Special tax rates
* **Long-term Capital Gains**: Special tax rates with indexation benefits (for domestic securities)
* **Currency Gains**: For foreign securities transactions
* **Loss Tracking**: Capital losses for offset and carryforward

## Calculator Modules

> **[Domestic Securities Tax P\&L](https://developer.sandbox.co.in/api-reference/it/calculator/tax_pnl/securities/domestic/overview.md)**
>
> Calculate gains/losses for equity, mutual funds, and derivatives trading in India.

> **[Foreign Securities Tax P\&L](https://developer.sandbox.co.in/api-reference/it/calculator/tax_pnl/securities/foreign/overview.md)**
>
> Calculate tax impact for international investments with currency conversion.

> **[Crypto Tax P\&L](https://developer.sandbox.co.in/api-reference/it/calculator/tax_pnl/crypto/overview.md)**
>
> Compute capital gains and losses from cryptocurrency transactions.

## API Endpoints

> **[Domestic Securities](https://developer.sandbox.co.in/api-reference/it/calculator/tax_pnl/securities/domestic/endpoints/submit_job.md)**
>
> Submit Jobs

> **[Foreign Securities](https://developer.sandbox.co.in/api-reference/it/calculator/tax_pnl/securities/foreign/endpoints/submit_job.md)**
>
> Submit Jobs

> **[Crypto](https://developer.sandbox.co.in/api-reference/it/calculator/tax_pnl/crypto/endpoints/submit_job.md)**
>
> Submit Jobs

## Async Job Processing

All calculator operations use async job-based processing:

1. **Submit Job**: POST with transaction data → Receive `job_id` and S3 upload URL
2. **Upload Payload**: PUT transaction data to the provided S3 URL
3. **Check Status & Get Output**: Poll job status endpoint with `job_id` → Returns processing status and results once complete

## Related Documentation

* [Domestic Securities P\&L](https://developer.sandbox.co.in/api-reference/it/calculator/tax_pnl/securities/domestic/overview.md)
* [Foreign Securities P\&L](https://developer.sandbox.co.in/api-reference/it/calculator/tax_pnl/securities/foreign/overview.md)
* [Crypto Tax P\&L](https://developer.sandbox.co.in/api-reference/it/calculator/tax_pnl/crypto/overview.md)
* [API Overview](https://developer.sandbox.co.in/api-reference/it/overview.md)


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