Skip to main content
GET
/
wealth
/
accounts
/
{account_id}
/
tax-optimization
Get tax optimization suggestions
curl --request GET \
  --url https://service.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
        }
      ]
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.bluumfinance.com/llms.txt

Use this file to discover all available pages before exploring further.

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[]