Rhetra TaxGuard

# Rhetra TaxGuard

Your trading bot's tax advisor. Silently monitors every trade for tax pitfalls and optimization opportunities. Delivers a daily report. Works with Alpaca, Crypto.com, Bitget, Polymarket — any trading MCP.

Rules

Daily Report Format

At end of day, present:

═══ TAXGUARD DAILY REPORT ═══

Trades today: 12
Checks run: 12 (all passed)

⚠️  WASH SALE FLAGS (2):
  • Bought NVDA — wash sale triggered. $420 loss disallowed. 
    Sold NVDA at loss on Mar 15. 30-day window ends Apr 14.
  • Bought TSLA — wash sale triggered. $1,200 loss disallowed.
    Sold TSLA at loss on Mar 18. 30-day window ends Apr 17.

💡 OPTIMIZATION OPPORTUNITIES (1):
  • AAPL: Selling now = short-term (37% tax). Hold 14 more 
    days = long-term (15-20%). Potential savings: $510.

📊 TAX SUMMARY:
  • Realized gains today: $2,400
  • Realized losses today: $0
  • YTD gains: $47,400 | YTD losses: $5,200
  • Estimated tax owed: $11,850
  • Q1 estimated payment due: Apr 15
  • Wash sale losses disallowed today: $1,620

🛡️ GUARDIAN MODE: Wash sale blocking ON | PDT blocking OFF

═══════════════════════════════

Setup

On first use:

1. Run the signup script to get a free API key instantly:

```bash

node signup.js your@email.com

```

This returns your API key immediately. No website visit needed.

2. Save the key for all future calls.

3. Ask: "How do you want TaxGuard to work?"

- **Silent Monitor (default):** Checks every trade silently. Daily report at end of day. Never interrupts.

- **Guardian Mode:** Same daily report, but also blocks specific risks before they happen:

- Block wash sales (prevents repurchasing within 30-day loss window)

- Block PDT triggers (prevents 4th day trade when equity < $25K)

- Block short-term sells (prevents selling when long-term rate is days away)

4. Run a test check to verify the key works.

No key yet? Run: `node signup.js your@email.com` — first 10 checks/month free, $0.01/trade after.

How to call TaxGuard

Before every trade, gather context from the connected trading MCP and call SILENTLY:

node check-trade.js \
  --key "YOUR_API_KEY" \
  --action "BUY 50 NVDA at market" \
  --ticker "NVDA" \
  --equity 18500 \
  --day-trades 3 \
  --exchange "alpaca" \
  --recent-sales '[{"ticker":"NVDA","date":"2026-03-15","type":"SELL","gainLoss":-420}]' \
  --positions '[{"ticker":"NVDA","acquiredDate":"2026-01-10","quantity":100,"costBasis":12000,"currentValue":13500}]' \
  --annual-gains 45000 \
  --harvested-losses 5200 \
  --total-trades 340 \
  --magi 180000

Store the response. Do NOT show it to the trader. Add it to the daily report accumulator.

Exception: if Guardian Mode flags fire and the outcome is BLOCKED, show the warning and ask "Proceed anyway?" before executing.

Context fields

**Required:**

**Recommended:**

**Tax context (unlocks advanced disclosures):**

What TaxGuard catches

**High Priority (flagged prominently in daily report):**

**Medium Priority (included in daily report):**

**Informational (noted in report):**

Trader commands

Pricing

Strategy Assessment

During setup OR at any time, the trader can ask: "Assess my strategy" or "Review my trading plan."

Gather their strategy details and call:

curl -s -X POST "https://api.rhetra.io/api/assess-strategy" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer API_KEY" \
  -d '{
    "strategy": "Day trading NVDA, TSLA, AMD. Momentum plays.",
    "accountEquity": 18500,
    "annualIncome": 95000,
    "filingStatus": "single",
    "exchange": "alpaca",
    "tickers": ["NVDA", "TSLA", "AMD"],
    "tradesPerDay": 15,
    "holdingPeriod": "5 minutes to 2 hours"
  }'

Present the findings organized by severity. For each finding, show:

1. The risk name and severity

2. The problem in plain English

3. ALL solutions — numbered, actionable

After the assessment, ask: "Want me to set up Guardian Mode based on these findings?" and configure blocking for any HIGH severity risks the trader wants protected.