{"uid":"cap_LxykPov7LSPwC5k_PP0YA","slug":"api-stocktrends-com-b21a7272","name":"Stock Trends Equal-Weight Portfolio Constructor","description":"Constructs a deterministic equal-weight portfolio from eligible Stock Trends signal candidates.","url":"https://api.stocktrends.com/v1/portfolio/construct","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"bias":{"enum":["auto","bullish","bearish"],"type":"string","default":"auto"},"count":{"type":"integer","default":5,"maximum":10,"minimum":1},"exchange":{"enum":["N","Q","A","T"],"type":"string"},"universe":{"enum":["top"],"type":"string","default":"top"}}},"responseSchema":null,"example":{"request":{"input":{"body":{"bias":"auto","count":5,"exchange":"N","universe":"top"},"type":"http","method":"POST","bodyType":"json"}},"response":{"count":5,"universe":"top","weekdate":"2026-06-05","portfolio":[{"rsi":116,"bias":"bullish","rank":1,"trend":"^+","mt_cnt":48,"symbol":"LOUP","weight":0.2,"exchange":"N","trend_cnt":9,"confidence":"moderate","stim_covered":true,"decision_score":0.5151,"symbol_exchange":"LOUP-N","stim_percentile_13wk":0.9316,"stim_volatility_13wk":18.349,"stim_risk_adjusted_13wk":0.3584,"stim_expected_return_13wk":6.5769},{"rsi":110,"bias":"bullish","rank":2,"trend":"^+","mt_cnt":20,"symbol":"BWLP","weight":0.2,"exchange":"N","trend_cnt":12,"confidence":"moderate","stim_covered":true,"decision_score":0.5151,"symbol_exchange":"BWLP-N","stim_percentile_13wk":0.9024,"stim_volatility_13wk":15.1232,"stim_risk_adjusted_13wk":0.34,"stim_expected_return_13wk":5.1417},{"rsi":122,"bias":"bullish","rank":3,"trend":"^+","mt_cnt":21,"symbol":"TWO","weight":0.2,"exchange":"N","trend_cnt":11,"confidence":"moderate","stim_covered":true,"decision_score":0.5151,"symbol_exchange":"TWO-N","stim_percentile_13wk":0.8548,"stim_volatility_13wk":37.4978,"stim_risk_adjusted_13wk":0.31,"stim_expected_return_13wk":11.6241},{"rsi":118,"bias":"bullish","rank":4,"trend":"^+","mt_cnt":83,"symbol":"OPLN","weight":0.2,"exchange":"N","trend_cnt":10,"confidence":"moderate","stim_covered":true,"decision_score":0.5151,"symbol_exchange":"OPLN-N","stim_percentile_13wk":0.8336,"stim_volatility_13wk":19.9505,"stim_risk_adjusted_13wk":0.2966,"stim_expected_return_13wk":5.917},{"rsi":114,"bias":"bullish","rank":5,"trend":"^+","mt_cnt":18,"symbol":"MUSA","weight":0.2,"exchange":"N","trend_cnt":14,"confidence":"moderate","stim_covered":true,"decision_score":0.5151,"symbol_exchange":"MUSA-N","stim_percentile_13wk":0.8301,"stim_volatility_13wk":17.3789,"stim_risk_adjusted_13wk":0.2944,"stim_expected_return_13wk":5.1158}],"request_id":"abb6c8b2-9e53-404c-aba7-4dfcd0a27d7d","bias_resolved":"mixed","stim_weekdate":"2026-06-05","bias_requested":"auto","ranking_method":"decision_score_stim_tiebreak","regime_context":{"regime_score":-0.0302,"current_regime":"mixed","weeks_analyzed":5,"forecast_regime":"mixed","recent_direction":"stable","regime_confidence":"low","regime_consistency":1,"forecast_confidence":"moderate"},"exchange_filter":["N"],"portfolio_score":0.5151,"stim_coverage_pct":0.9028,"candidate_ordering":"decision_score DESC, stim_percentile_13wk DESC, symbol ASC","construction_notes":["Bias auto-resolved to mixed based on current regime (score: -0.0302)","2540 candidates evaluated across all directional trend states","5 of 5 requested positions filled","Equal weight: 0.2 per position"],"stim_covered_count":2293,"candidates_evaluated":2540,"candidate_selection_method":"full_eligible_universe"}},"exampleRequest":{"bias":"auto","count":5,"exchange":"N","universe":"top"},"tags":["x402"],"displayCostAmount":"1","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":"$1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JdbyV0l-DaSjmrIEjW8ku","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Constructs a deterministic equal-weight portfolio from eligible Stock Trends signal candidates based on current trend and regime context.","exampleAgentPrompt":"Use Stock Trends to build me a deterministic equal-weight portfolio from the current eligible signal candidates — I want a fully constructed allocation I can act on today.","exampleUseCases":null,"resultDescription":"A deterministically constructed equal-weight portfolio listing selected symbols and their equal allocation weights, derived from currently eligible Stock Trends signal candidates filtered through trend state, persistence, and market regime context.","failureModes":["No eligible candidates available given current regime conditions — returns empty or minimal portfolio","Invalid or missing input parameters result in 400 error","Insufficient signal data for candidate evaluation returns reduced candidate pool","Payment failure via x402 protocol returns 402 Payment Required","Service unavailable returns 503 with retry guidance"],"whenToPreferThis":"Use this endpoint when you need a ready-to-trade, rules-based equal-weight portfolio constructed systematically from Stock Trends signal candidates, rather than evaluating individual symbols or screening manually. Prefer this over the symbol-level decision or screener endpoints when you want a complete portfolio output in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:31:41.541Z","isFirstParty":false}