Skip to main content
GET
/
wealth
/
accounts
/
{account_id}
/
tax-optimization
Get tax optimization suggestions
curl --request GET \
  --url https://api.bluumfinance.com/v1/wealth/accounts/{account_id}/tax-optimization \
  --header 'Authorization: Basic <encoded-value>'
{
  "account_id": "3d0b0e65-35d3-4dcd-8df7-10286ebb4b4b",
  "tax_year": 2025,
  "generated_at": "2025-01-15T16:00:00Z",
  "tax_summary": {
    "estimated_short_term_gains": "5000.00",
    "estimated_long_term_gains": "15000.00",
    "realized_losses_ytd": "2000.00",
    "harvestable_losses": "3500.00"
  },
  "opportunities": [
    {
      "opportunity_id": "opp_001",
      "type": "tax_loss_harvest",
      "title": "Tax Loss Harvesting",
      "description": "Sell positions with unrealized losses to offset gains",
      "estimated_tax_savings": "875.00",
      "positions": [
        {
          "position_id": "pos_xlf",
          "symbol": "XLF",
          "unrealized_gain_loss": "-1500.00",
          "holding_period": "short_term",
          "wash_sale_risk": false,
          "replacement_options": [
            "VFH",
            "IYF"
          ]
        }
      ]
    },
    {
      "opportunity_id": "opp_002",
      "type": "long_term_holding",
      "title": "Hold for Long-Term Treatment",
      "description": "Position approaching long-term capital gains threshold",
      "estimated_tax_savings": "400.00",
      "positions": [
        {
          "position_id": "pos_aapl",
          "symbol": "AAPL",
          "unrealized_gain_loss": "2000.00",
          "holding_period": "short_term",
          "days_until_long_term": 45
        }
      ]
    }
  ]
}

Authorizations

Authorization
string
header
required

HTTP Basic Authentication using the API Key as username and API Secret as password.

Path Parameters

account_id
string<uuid>
required

Query Parameters

tax_year
integer

Tax year (default is current year)

Response

Tax optimization suggestions retrieved successfully

Tax optimization suggestions

account_id
string<uuid>
tax_year
integer
generated_at
string<date-time>
tax_summary
object
opportunities
object[]