{"endpoint":"/v1/ai/proof/market-edge","version":"v1","cache_policy":{"max_age_seconds":3600,"strategy":"static","note":"This response is static. No live or real-time market data is included."},"agent_guidance":{"purpose":"Demonstrates Stock Trends signal structure and value proposition without requiring payment or authentication.","next_steps":[{"step":1,"call":"GET /v1/pricing/catalog","note":"Resolve live STC costs for target endpoints."},{"step":2,"call":"GET /v1/agent/screener/top","note":"Live premium signals. Auth or payment required."},{"step":3,"call":"GET /v1/workflows","note":"Discover multi-step agent workflows with per-step STC costs."}],"on_payment_required":"Selected agent-pay endpoints may return HTTP 402 with an x402 challenge when no payment has been presented. Inspect the response body for accepted_payment_methods and payment_required fields. The PAYMENT-REQUIRED response header carries base64-encoded x402 requirements. Subscription callers receive 401/403 on auth failure, not 402. MPP uses session authorization rather than the x402 challenge flow."},"value_proposition":{"headline":"Stock Trends delivers processed, ranked, actionable signals — not raw prices.","differentiators":["Proprietary trend classification across 2000+ North American equities and ETFs","Weekly structured signals: trend state, trend persistence (trend_cnt), trend maturity (mt_cnt), relative strength (rsi), volume context (vol_tag)","ST-IM (Stock Trends Inference Model): forward return expectations and statistical distributions across 4, 13, and 40-week horizons","Sector breadth context for market regime detection","Agent-optimized structured JSON with consistent scoring fields","Multi-rail payments: subscription, x402 (per-request), MPP (session-based)"],"vs_raw_price":"A raw price API returns a number. Stock Trends returns a ranked trend signal set, regime context, and a structured workflow-ready response — all in one call."},"market_snapshot":{"note":"SYNTHETIC DATA ONLY — not live, not real-time, not actionable. Symbols are impossible synthetic identifiers, not real tickers. Reflects real response structure.","as_of":"synthetic","instruments":[{"symbol":"SAMPLE_A1","trend":"^+","trend_cnt":12,"mt_cnt":8,"rsi":118,"rsi_updn":"+","vol_tag":"*","rank":1},{"symbol":"SAMPLE_B2","trend":"^-","trend_cnt":7,"mt_cnt":12,"rsi":103,"rsi_updn":"+","vol_tag":"","rank":8},{"symbol":"SAMPLE_C3","trend":"v^","trend_cnt":2,"mt_cnt":1,"rsi":97,"rsi_updn":"-","vol_tag":"","rank":47},{"symbol":"SAMPLE_D4","trend":"v-","trend_cnt":5,"mt_cnt":3,"rsi":88,"rsi_updn":"-","vol_tag":"","rank":189},{"symbol":"SAMPLE_E5","trend":"v+","trend_cnt":11,"mt_cnt":7,"rsi":72,"rsi_updn":"-","vol_tag":"!!","rank":387}],"sector_summary":{"top_sector":"Technology","bottom_sector":"Utilities","breadth_signal":"bullish_expansion"}},"signal_highlights":[{"signal_type":"bullish_trend_entry","description":"Illustrative: instruments in bullish trend states (^+, ^-) with high RSI and persistent trend_cnt represent top-ranked candidates in the screener.","note":"Live ranked signals available via /v1/agent/screener/top."},{"signal_type":"sector_rotation","description":"Illustrative: sector breadth signals identify regime shifts before they appear in index prices.","note":"Live sector context available via /v1/breadth/sector/latest."}],"sample_workflow":{"name":"agent_market_edge","description":"Recommended workflow to extract signal edge from Stock Trends","steps":[{"step":1,"call":"GET /v1/ai/tools","purpose":"Discover all available tools and payment options"},{"step":2,"call":"GET /v1/pricing/catalog","purpose":"Resolve live STC costs"},{"step":3,"call":"GET /v1/agent/screener/top","purpose":"Retrieve top-ranked live signals"},{"step":4,"call":"GET /v1/stim/latest","purpose":"Get ST-IM (Stock Trends Inference Model) forward return expectations and statistical distributions for a symbol"},{"step":5,"call":"POST /v1/portfolio/construct","purpose":"Construct portfolio from signal output"}]},"conversion_prompt":{"action":"Access live signals by authenticating with a subscription API key, or initiate per-request payment via x402 or a session via MPP.","start_here":"/v1/ai/tools","pricing":"/v1/pricing","payment_methods":["subscription","x402","mpp"],"payment_notes":{"subscription":"API key with active plan. Monthly STC allocation. Header: X-API-Key or Authorization: Bearer.","x402":"Per-request payment via HTTP 402 challenge/verify flow. Network: Base (eip155:8453). Token: USDC. Response header: PAYMENT-REQUIRED (base64-encoded requirements).","mpp":"Session-based payments. STC consumed within an active session. Header: X-StockTrends-Session-Id."}},"generated_at":"2026-08-30T12:01:01.989196+00:00"}