Summarise a tax year.

GET

/api/expenses/tax-summary

const url = 'https://api.tradr.cloud/api/expenses/tax-summary?year=1';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://api.tradr.cloud/api/expenses/tax-summary?year=1'

Authed. Realised P&L (split short- and long-term), tracked expenses by category, and wash-sale or superficial-loss flags for the user’s jurisdiction. Deliberately reports no single net taxable figure: fees are already inside realised P&L, and combining the numbers correctly depends on rules Tradr does not model.

This is a reporting aid, not tax advice, and it is not a filing.

Parameters

Query Parameters

year

required

integer

>= 1900 <= 9999

Responses

200

The summary for the year.

application/json

object

displayCurrency

string

nullable

flags

Wash sales (US) or superficial losses (CA), with the counterparty positions.

object

jurisdiction

string

nullable

Allowed values: US CA other

realisedPnl

object

trackedExpenses

object

year

integer

Example

{
  "jurisdiction": "US"
}

400

Missing or invalid year.