{"uid":"cap_xk4osCZ01qaS43GjEHu9x","slug":"ecliptica-ai-trading-api-portfolio-analysis-recommendations-b91cd3e3","name":"Ecliptica AI Portfolio Analysis & Trade Recommendations","description":"Portfolio analysis and recommendations - AI-powered position management and new trade ideas","url":"https://api.ecliptica.ninja/x402/portfolio?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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"}}},"responseSchema":{"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}]},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.15","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.15/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_vWz8HmavpeAQARtbCSzCm","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.15","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes open trading positions and account equity to deliver AI-powered regime analysis, position management actions, and new trade ideas","exampleAgentPrompt":"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?","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T11:25:53.773Z","isFirstParty":false,"canonicalSlug":"ecliptica-ai-trading-api-portfolio-analysis-recommendations-b91cd3e3"}