{"uid":"cap_e-6XQRi9CsFW3OuJyJAAg","slug":"api-stocktrends-com-3ef0c47c","name":"Stock Trends Portfolio Comparison","description":"Compares two user-supplied portfolios using Stock Trends decision scoring, alignment, and regime context.","url":"https://api.stocktrends.com/v1/portfolio/compare","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"left":{"type":"array","items":{"type":"object","required":["symbol_exchange","weight"],"properties":{"weight":{"type":"number","maximum":1,"minimum":0},"symbol_exchange":{"type":"string","pattern":"^[A-Z0-9.]+-[A-Z]$"}},"additionalProperties":false}},"right":{"type":"array","items":{"type":"object","required":["symbol_exchange","weight"],"properties":{"weight":{"type":"number","maximum":1,"minimum":0},"symbol_exchange":{"type":"string","pattern":"^[A-Z0-9.]+-[A-Z]$"}},"additionalProperties":false}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"1.25","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":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$1.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"1.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"1.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_dtysbgCWo_9F4wocTrQSj","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"1.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Compares two user-supplied portfolios using Stock Trends decision scoring, signal alignment, and market regime context to identify which portfolio is better positioned.","exampleAgentPrompt":"Compare my two portfolios using Stock Trends decision scoring — Portfolio A holds AAPL, MSFT, and NVDA, and Portfolio B holds JPM, GS, and BAC — tell me which is better aligned with the current market regime and which has stronger trend signals.","exampleUseCases":null,"resultDescription":"Returns a side-by-side comparison of two portfolios with Stock Trends decision scores for each holding, signal alignment metrics, market regime context, and an overall comparative assessment indicating which portfolio is better positioned relative to current trend and regime conditions.","failureModes":["Invalid or unrecognized ticker symbols return an error indicating which symbols are unsupported","Empty or malformed portfolio input returns a 400-level validation error","Symbols with insufficient historical data may be excluded or flagged in results","Payment failure via x402 returns a 402 response before processing","Rate limiting may apply for high-frequency callers"],"whenToPreferThis":"Use this endpoint when you need a direct head-to-head comparison of two portfolios using Stock Trends' proprietary multi-decade classification framework. Prefer this over the single-portfolio evaluation endpoint when the user explicitly wants to contrast two sets of holdings. Ideal for rebalancing decisions, strategy comparisons, or evaluating a proposed portfolio against an existing one within the context of current market regime and trend signals.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:39:36.253Z","isFirstParty":false}