# Ecliptica AI Portfolio Analysis & Trade Recommendations

> Ecliptica AI Portfolio Analysis & Trade Recommendations is a paid API for AI agents from api.ecliptica.ninja, paid per call via x402, $0.15/call, status down (last checked 2026-10-12).

Analyzes open trading positions and account equity to deliver AI-powered regime analysis, position management actions, and new trade ideas

## Facts

- Endpoint: POST https://api.ecliptica.ninja/x402/portfolio?utm_source=zero.xyz
- Price: $0.15/call
- Payment: x402
- Status: down
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ecliptica-ai-trading-api-portfolio-analysis-recommendations-b91cd3e3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xk4osCZ01qaS43GjEHu9x

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability ecliptica-ai-trading-api-portfolio-analysis-recommendations-b91cd3e3 -d '<json body>'
```

Example prompt: Can you analyze my Ecliptica portfolio — I'm long BTC with 1.5 BTC entered at $95,000 and long ETH with 10 ETH entered at $3,100, my account equity is $50,000 and I want a max drawdown of 10% — tell me what to hold, what to adjust, and what new trades look good right now?

## When to prefer this

Choose this endpoint when you need holistic portfolio-level AI analysis that combines position management recommendations with new trade idea generation in a single call. It is ideal when you have multiple open positions and want regime-aware advice on whether to hold, adjust, or exit, alongside fresh alpha ideas — rather than just analyzing a single asset or scanning the market without portfolio context.

## Known failure modes

- Missing required position fields (symbol, side, size, entryPrice) returns validation error
- Invalid side enum value (not LONG or SHORT) causes schema rejection
- Empty positions array may return limited recommendations with no position management actions
- Account equity of zero or negative may produce unreliable sizing recommendations
- Service unavailable or timeout if AI model inference is delayed
- Payment failure via x402 protocol blocks request before processing

## How this service works

Portfolio analysis and recommendations - AI-powered position management and new trade ideas

## Output

Returns a market regime label (e.g. risk-on/risk-off), a regime analysis object with long/short bias percentages, overall risk level, and primary driver reasoning, plus per-position management actions (hold/reduce/close) with confidence scores, and a list of new trade ideas with symbol, direction, entry, stop loss, take profit, and sizing as a percentage of equity.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "positions": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "symbol",
     "side",
     "size",
     "entryPrice"
    ],
    "properties": {
     "side": {
      "enum": [
       "LONG",
       "SHORT"
      ],
      "type": "string"
     },
     "size": {
      "type": "number"
     },
     "symbol": {
      "type": "string"
     },
     "leverage": {
      "type": "number"
     },
     "entryPrice": {
      "type": "number"
     },
     "unrealizedPnl": {
      "type": "number"
     }
    }
   },
   "description": "Current open positions"
  },
  "accountEquity": {
   "type": "number",
   "description": "Account equity in USD"
  },
  "maxDrawdownPct": {
   "type": "number",
   "description": "Maximum allowed drawdown percentage"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "regime": "risk-on",
 "newTrades": [
  {
   "entry": 3200,
   "sizing": "2% of equity",
   "symbol": "ETH",
   "stopLoss": 3050,
   "direction": "long",
   "takeProfit": 3600
  }
 ],
 "timestamp": "2025-01-19T12:00:00Z",
 "regimeAnalysis": {
  "longBias": 70,
  "reasoning": "Market showing risk-on behavior with strong BTC leadership",
  "shortBias": 30,
  "overallRisk": "medium",
  "primaryDriver": "BTC strength and positive macro sentiment"
 },
 "positionManagement": [
  {
   "action": "hold",
   "reason": "Position in profit with favorable regime",
   "symbol": "BTC",
   "confidence": "high",
   "exposureAdjustmentPct": 0
  }
 ]
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ecliptica-ai-trading-api-portfolio-analysis-recommendations-b91cd3e3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.ecliptica.ninja](https://www.zero.xyz/host/api.ecliptica.ninja/llms.txt)