Tax Loss Harvesting

Overview

Aegis includes a tax loss harvesting engine. It scans an agent’s portfolio for unrealized losses, evaluates if harvesting them is profitable after gas, and executes offsetting trades to realize tax-deductible losses.

Audit Ledger

Generate a full tax compliance ledger for an agent’s transaction history:

curl -X GET https://api.aegisintent.xyz/v1/actions/audit/ledger \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Aegis-Email: agent@example.com"

Tax Loss Harvest

Run the harvesting engine in simulation or execution mode:

curl -X POST https://api.aegisintent.xyz/v1/actions/audit/harvest \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Aegis-Email: agent@example.com" \
  -H "Content-Type: application/json" \
  -d '{
    "executionMode": "SIMULATE",
    "taxBracket": 0.30
  }'

Parameters

Field	Type	Required	Description
`executionMode`	string	No	`"SIMULATE"` (default) or `"HARVEST"` for live execution
`taxBracket`	number	No	Tax bracket rate for benefit calculation (default: 0.30)

How It Works

Scans historical trades using FIFO cost basis accounting
Identifies positions with unrealized losses
Evaluates each candidate against gas drag (estimated ~$15 gas cost)
In SIMULATE mode: returns what would happen without executing
In HARVEST mode: executes offsetting trades and logs the results

Response

{
  "success": true,
  "report": {
    "agentId": "...",
    "executionMode": "SIMULATE",
    "candidatesAnalyzedCount": 3,
    "harvestedPositions": [...],
    "netRealizedLossCreatedUsdc": 45.20
  }
}

Start Here

How Aegis Works

Agent Actions

Operations

Overview

Audit Ledger

Tax Loss Harvest

Parameters

How It Works

Response

​Overview

​Audit Ledger

​Tax Loss Harvest

​Parameters

​How It Works

​Response

Overview

Audit Ledger

Tax Loss Harvest

Parameters

How It Works

Response