{"uid":"cap_T7pA_ljIshWu42XoT0NjQ","slug":"api-stocktrends-com-ef7b28de","name":"Stock Trends Portfolio Evaluator","description":"Evaluates a user-supplied portfolio against Stock Trends signal and market regime context.","url":"https://api.stocktrends.com/v1/portfolio/evaluate","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"positions":{"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":{"request":{"positions":[{"weight":0.3,"symbol_exchange":"AAPL-N"},{"weight":0.25,"symbol_exchange":"MSFT-Q"},{"weight":0.25,"symbol_exchange":"NVDA-Q"},{"weight":0.2,"symbol_exchange":"JPM-N"}]},"response":{"weekdate":"2026-06-12","positions":[{"rsi":null,"bias":null,"found":false,"trend":null,"mt_cnt":null,"symbol":"AAPL","weight":0.3,"exchange":"N","alignment":null,"trend_cnt":null,"confidence":null,"decision_score":null,"symbol_exchange":"AAPL-N"},{"rsi":88,"bias":"bearish","found":true,"trend":"v-","mt_cnt":21,"symbol":"MSFT","weight":0.25,"exchange":"Q","alignment":"neutral","trend_cnt":2,"confidence":"moderate","decision_score":0.406,"symbol_exchange":"MSFT-Q"},{"rsi":102,"bias":"bullish","found":true,"trend":"^+","mt_cnt":49,"symbol":"NVDA","weight":0.25,"exchange":"Q","alignment":"neutral","trend_cnt":11,"confidence":"moderate","decision_score":0.436,"symbol_exchange":"NVDA-Q"},{"rsi":101,"bias":"bearish","found":true,"trend":"v+","mt_cnt":11,"symbol":"JPM","weight":0.2,"exchange":"N","alignment":"neutral","trend_cnt":2,"confidence":"moderate","decision_score":0.256,"symbol_exchange":"JPM-N"}],"request_id":"21925c34-6ee2-47d9-9516-54191a446146","portfolio_bias":"bearish","regime_context":{"regime_score":-0.0119,"current_regime":"mixed","weeks_analyzed":5,"forecast_regime":"mixed","recent_direction":"stable","regime_confidence":"low","regime_consistency":1,"forecast_confidence":"moderate"},"portfolio_score":0.3739,"positions_found":3,"effective_weight":0.7,"evaluation_notes":["1 of 4 positions not found in the Stock Trends coverage for weekdate 2026-06-12 — excluded from aggregates","Portfolio aggregates computed on 3 positions representing 0.7 of submitted weight","Portfolio is mixed with current mixed regime"],"positions_missing":1,"portfolio_alignment":"mixed","portfolio_confidence":"moderate"}},"exampleRequest":{"positions":[{"weight":0.3,"symbol_exchange":"AAPL-N"},{"weight":0.25,"symbol_exchange":"MSFT-Q"},{"weight":0.25,"symbol_exchange":"NVDA-Q"},{"weight":0.2,"symbol_exchange":"JPM-N"}]},"tags":["x402"],"displayCostAmount":"0.75","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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":"$0.75/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.75","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.75","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_9d60ZnkfKKp0rTGawolpz","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.75","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Evaluates a user-supplied portfolio against Stock Trends signal context and current market regime to assess portfolio quality and alignment.","exampleAgentPrompt":"Can you evaluate my portfolio — AAPL, MSFT, NVDA, and JPM — against the current Stock Trends signals and market regime context to see how well my holdings are aligned with the trend and regime conditions right now?","exampleUseCases":null,"resultDescription":"Returns an evaluation of the submitted portfolio against Stock Trends signal indicators (trend state, trend persistence, relative performance, volume activity) and the current market regime classification, yielding a structured assessment of how well the portfolio aligns with prevailing trend and regime conditions.","failureModes":["Invalid or unrecognized stock symbols in the portfolio — returns error with offending symbols","Empty or malformed portfolio payload — returns validation error","Market regime data temporarily unavailable — partial or degraded evaluation returned","Symbols outside the Stock Trends coverage universe — excluded from evaluation with a warning","Payment not processed or insufficient USDC — request rejected with payment error"],"whenToPreferThis":"Use this endpoint when you need to evaluate a specific user-defined portfolio (vs. constructing a new one) against Stock Trends signals and market regime context. Prefer this over the symbol-level decision endpoint when assessing multiple holdings collectively, or over the portfolio constructor endpoint when the user already has an existing portfolio they want graded rather than built from scratch.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:39:21.289Z","isFirstParty":false}