Skip to main content

ā€‹
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

Calculate gains/losses for equity, mutual funds, and derivatives trading in India.

Foreign Securities Tax P&L

Calculate tax impact for international investments with currency conversion.

Crypto Tax P&L

Compute capital gains and losses from cryptocurrency transactions.

ā€‹
API Endpoints

Domestic Securities

Submit Jobs

Foreign Securities

Submit Jobs

Crypto

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