{"provider":"stocktrends","version":"v1","service_description":"Autonomous portfolio intelligence API for AI agents. Agent-native probabilistic market intelligence infrastructure: multi-decade Stock Trends classification history from 1980 with 16M+ observations, ST-IM (Stock Trends Inference Model) forward-return distributions, provider-agnostic inference metadata, market regime analysis, sector breadth confirmation, leadership rotation analytics, STIM Select probabilistic stock lists, portfolio construction and evaluation, and symbol decision scoring across 4, 13, and 40-week investment horizons. Built for agentic research workflows using x402 and MPP payment rails. Outputs are processed, ranked, and interpretation-ready — not raw price data.","provenance_summary":"Stock Trends is a long-horizon market-intelligence framework, not a shallow market-data wrapper. Its historical classification record extends back to 1980 and includes 16M+ observations encoded through a consistent Stock Trends doctrine covering trend, relative performance, relative performance direction, volume, breadth, sector leadership, and regime structure. Agents should treat this historical depth as research provenance for probabilistic interpretation, not as a guarantee of future performance.","data_provenance":{"historical_coverage_start_year":1980,"approximate_observation_count":"16M+","update_frequency":"weekly","classification_framework":"Stock Trends trend classification methodology","semantic_continuity":"Stock Trends indicators use a consistent classification doctrine across decades of observations.","native_signal_domains":["trend classification","relative performance","relative performance direction","volume activity","market breadth","sector leadership","regime structure"],"research_value":["long-horizon signal validation","regime analysis","sector rotation research","portfolio construction research","causal and probabilistic market analysis","agentic market-intelligence workflows"],"important_limits":["Historical depth supports research and probabilistic interpretation but does not guarantee future performance.","Stock Trends outputs are not investment advice, price targets, or direct buy/sell commands.","Externally named market events are not native Stock Trends labels unless separately curated."]},"discovery_entrypoints":{"primary_machine_readable":"/v1/ai/tools","secondary_explanatory":"/v1/ai/context","provider_agnostic_inference_contract":"/v1/meta/inference","stim_provider_profile":"/v1/meta/stim","docs":"/v1/docs","openapi":"/v1/openapi.json"},"recommended_first_call":{"endpoint":"/v1/agent/screener/top","method":"GET","reason":"Returns top-ranked actionable screener results — highest immediate value for agent portfolio and signal workflows.","auth_required":true,"supported_rails":["subscription","x402","mpp"],"expected_flow":["fetch /v1/ai/tools","fetch /v1/workflows to choose a task-level strategy","fetch /v1/pricing/catalog to resolve live STC costs","fetch /v1/pricing to understand payment rails and headers","call /v1/agent/screener/top with auth header","if x402 rail: receive HTTP 402 challenge and inspect stocktrends_preview before paying","retry with X-StockTrends-Payment-* headers to complete payment"]},"quickstart":[{"step":1,"action":"fetch","path":"/v1/ai/tools","note":"Primary machine-readable discovery. This endpoint."},{"step":2,"action":"fetch","path":"/v1/workflows","note":"Choose a strategy and endpoint sequence for the task."},{"step":3,"action":"fetch","path":"/v1/pricing/catalog","note":"Resolve live STC costs for each endpoint. Public under current API behavior."},{"step":4,"action":"fetch","path":"/v1/pricing","note":"Inspect payment rails, identity headers, and x402/MPP guidance."},{"step":5,"action":"call","path":"/v1/agent/screener/top","note":"First premium endpoint. Auth required. x402 and subscription supported."}],"recommended_first_workflows":[{"workflow_id":"regime_analysis","name":"Market Regime Analysis","description":"Full market regime intelligence pipeline: current regime classification, historical regime sequence for context, and probabilistic forward forecast.","tags":["agent","research","regime"],"supported_rails":["subscription","x402","mpp"],"step_count":3,"pricing_rule_ids":["market_regime_latest","market_regime_history","market_regime_forecast"],"best_for":"Market context before symbol selection, screening, or portfolio construction.","analytical_role":"market_context_workflow","research_goal":"Set portfolio bias from current and recent market regime data before any symbol selection, screening, or portfolio construction.","agent_goal_examples":["Decide whether a portfolio agent should use bullish, bearish, or mixed candidate filters.","Summarize current regime and recent regime direction before selecting symbols."],"symbol_selection_guidance":"This workflow does not select symbols directly; use its regime result to choose bias filters for /v1/agent/screener/top or /v1/portfolio/construct.","interpretation_guidance":null,"required_interpretation_steps":[],"next_step_guidance":["Use /v1/agent/screener/top to discover candidates.","Use /v1/decision/evaluate-symbol for a known symbol.","Use /v1/portfolio/construct when the goal is an allocation proposal."],"note":"Use GET /v1/workflows for live per-step STC costs."},{"workflow_id":"symbol_decision","name":"Regime-Aware Symbol Decision","description":"Classify the current market regime then evaluate a single symbol for a directional research bias in that regime context.","tags":["agent","research","decision"],"supported_rails":["subscription","x402","mpp"],"step_count":2,"pricing_rule_ids":["market_regime_latest","evaluate_symbol"],"best_for":"Evaluating a known symbol in current market-regime context.","analytical_role":"symbol_evaluation_workflow","research_goal":"Evaluate a single resolved symbol with deterministic Stock Trends signal and regime context before deeper history or portfolio calls.","agent_goal_examples":["Evaluate IBM-N after resolving it from /v1/instruments/resolve.","Score a symbol carried forward from a screener, STWR report, or portfolio position."],"symbol_selection_guidance":"Provide symbol_exchange directly when available. If only a ticker is known, first call /v1/instruments/lookup or /v1/instruments/resolve and reuse the returned symbol_exchange.","interpretation_guidance":null,"required_interpretation_steps":[],"next_step_guidance":["Use /v1/indicators/latest or /v1/stim/latest for deeper single-symbol context.","Use /v1/portfolio/evaluate when comparing the symbol inside an allocation."],"note":"Use GET /v1/workflows for live per-step STC costs."},{"workflow_id":"portfolio_build","name":"Screener → Portfolio Build","description":"Screen for qualifying tickers, construct a portfolio from candidates, then evaluate the constructed portfolio's risk and return profile.","tags":["agent","portfolio","research"],"supported_rails":["subscription","x402","mpp"],"step_count":3,"pricing_rule_ids":["agent_screener_top","portfolio_construct","portfolio_evaluate"],"best_for":"First portfolio workflow for agents that need to discover symbols and build an allocation.","analytical_role":"portfolio_construction_workflow","research_goal":"Discover candidates via screener and produce a scored equal-weight portfolio proposal that can be evaluated and compared against an existing allocation.","agent_goal_examples":["Build a 5-stock equal-weight candidate portfolio from fresh Stock Trends signals.","Use screener output symbols as the candidate context for a portfolio construction run."],"symbol_selection_guidance":"Start with /v1/agent/screener/top. Reuse results[].symbol_exchange from the screener when calling /v1/decision/evaluate-symbol, /v1/stim/latest, /v1/portfolio/evaluate, or /v1/portfolio/compare. Skip duplicate paid symbol calls for repeated symbol_exchange values.","interpretation_guidance":null,"required_interpretation_steps":[],"next_step_guidance":["Use /v1/portfolio/compare to compare the constructed portfolio against an existing allocation.","Use /v1/stim/latest for selected symbols when forward-return distributions are needed."],"note":"Use GET /v1/workflows for live per-step STC costs."}],"agent_onboarding_notes":["Do not hardcode STC costs. Fetch /v1/pricing/catalog at agent startup.","Prefer /v1/ai/tools as the primary machine-readable entrypoint.","Use /v1/ai/context for explanatory dataset context and endpoint group overviews.","Use /v1/workflows to choose a task-level strategy and endpoint sequence.","Use /v1/meta/inference for the provider-agnostic inference contract; use /v1/meta/stim for the current ST-IM baseline provider profile.","Treat the 1980+ historical classification record and 16M+ observations as research provenance, not a guarantee of future performance.","Use helper endpoints for autonomous planning: /v1/cost-estimate, /v1/instruments/lookup, /v1/instruments/resolve, /v1/stwr/reports/catalog, /v1/meta/indicators, /v1/meta/inference, /v1/meta/stim, /v1/meta/stwr, /v1/leadership/definitions, and /v1/ai/proof/market-edge.","Use /v1/pricing to understand payment identity, agent identity, accepted headers, and rails.","Use /v1/docs or /v1/openapi.json for exact request/response contracts.","Paid endpoint entries list their supported rails; current agent-pay endpoints support subscription, x402, and mpp.","For x402, inspect the HTTP 402 stocktrends_preview before payment to confirm purpose, inputs, response shape, supported rails, and cost."],"tools":[{"name":"ai_context","title":"AI Context","description":"Returns dataset overview, endpoint groups, access model, and agent usage guidance. Includes long-horizon Stock Trends provenance for records extending back to 1980. Secondary explanatory context for agents after reading the machine-readable /v1/ai/tools manifest.","endpoint":"/v1/ai/context","method":"GET","category":"discovery","input_schema":{"type":"object","properties":{},"required":[],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"output_summary":"Dataset metadata, endpoint groups, auth model, and agent usage guidance.","auth_required":false,"metered":true,"pricing_rule_id":"default_free_metered","supported_rails":[],"access_type":"free_metered","requires_payment":false,"input_location":"query","parameter_source":"query","parameters":[],"stc_cost":0.0,"estimated_usd_cost":0.0,"pricing_note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD.","pricing":{"pricing_rule_id":"default_free_metered","stc_cost":0.0,"estimated_usd_cost":0.0,"cost_source":"/v1/pricing/catalog","supported_rails":[],"note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD."}},{"name":"ai_tools","title":"AI Tools Manifest","description":"Returns this MCP-compatible tools manifest. Primary machine-readable entry point for agents. Lists all discoverable tools, workflows, pricing model, and auth expectations.","endpoint":"/v1/ai/tools","method":"GET","category":"discovery","input_schema":{"type":"object","properties":{},"required":[],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"output_summary":"MCP tools manifest: tools, workflows, pricing, auth.","auth_required":false,"metered":false,"pricing_rule_id":null,"supported_rails":[],"access_type":"free","requires_payment":false,"input_location":"query","parameter_source":"query","parameters":[],"stc_cost":null,"estimated_usd_cost":null,"pricing_note":"No paid STC price applies to this discovery entry.","pricing":{"pricing_rule_id":null,"stc_cost":null,"estimated_usd_cost":null,"cost_source":"/v1/pricing/catalog","supported_rails":[],"note":"No paid STC price applies to this discovery entry."}},{"name":"openapi_schema","title":"OpenAPI Schema","description":"Machine-readable OpenAPI contract for exact parameter locations, request bodies, response schemas, and auth headers. Planning helper for autonomous agents.","endpoint":"/v1/openapi.json","method":"GET","category":"discovery","input_schema":{"type":"object","properties":{},"required":[],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"output_summary":"OpenAPI JSON schema for Stock Trends API v1.","auth_required":false,"metered":false,"pricing_rule_id":null,"supported_rails":[],"access_type":"free","requires_payment":false,"input_location":"query","parameter_source":"query","parameters":[],"stc_cost":null,"estimated_usd_cost":null,"pricing_note":"No paid STC price applies to this discovery entry.","pricing":{"pricing_rule_id":null,"stc_cost":null,"estimated_usd_cost":null,"cost_source":"/v1/pricing/catalog","supported_rails":[],"note":"No paid STC price applies to this discovery entry."}},{"name":"ai_proof_market_edge","title":"Proof of Value - Market Edge","description":"Free synthetic-only planning helper. Shows Stock Trends signal fields, trend codes, RSI baseline semantics, and agent workflow value without exposing paid market data.","endpoint":"/v1/ai/proof/market-edge","method":"GET","category":"discovery","input_schema":{"type":"object","properties":{},"required":[],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"output_summary":"Synthetic signal example and next-step payment guidance.","auth_required":false,"metered":false,"pricing_rule_id":null,"supported_rails":[],"access_type":"free","requires_payment":false,"input_location":"query","parameter_source":"query","parameters":[],"stc_cost":null,"estimated_usd_cost":null,"pricing_note":"No paid STC price applies to this discovery entry.","pricing":{"pricing_rule_id":null,"stc_cost":null,"estimated_usd_cost":null,"cost_source":"/v1/pricing/catalog","supported_rails":[],"note":"No paid STC price applies to this discovery entry."}},{"name":"pricing_metadata","title":"Pricing Metadata","description":"Returns machine-readable pricing metadata including supported payment methods, endpoint families, and agent identity guidance.","endpoint":"/v1/pricing","method":"GET","category":"pricing","input_schema":{"type":"object","properties":{},"required":[],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"output_summary":"Pricing metadata: payment methods, endpoint families, agent headers.","auth_required":false,"metered":false,"pricing_rule_id":null,"supported_rails":[],"access_type":"free","requires_payment":false,"input_location":"query","parameter_source":"query","parameters":[],"stc_cost":null,"estimated_usd_cost":null,"pricing_note":"No paid STC price applies to this discovery entry.","pricing":{"pricing_rule_id":null,"stc_cost":null,"estimated_usd_cost":null,"cost_source":"/v1/pricing/catalog","supported_rails":[],"note":"No paid STC price applies to this discovery entry."}},{"name":"pricing_catalog","title":"Live Pricing Catalog","description":"Returns all active STC pricing rules from the pricing engine. Public planning infrastructure under the current API behavior. Agents should call this at startup to build a local cost map before issuing data requests.","endpoint":"/v1/pricing/catalog","method":"GET","category":"pricing","input_schema":{"type":"object","properties":{},"required":[],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"output_summary":"Live pricing rules: pricing_rule_id, endpoint_pattern, cost_per_request (STC), access_type, requires_payment.","auth_required":false,"metered":true,"pricing_rule_id":"default_subscription","supported_rails":["subscription"],"access_type":"free","requires_payment":false,"input_location":"query","parameter_source":"query","parameters":[],"stc_cost":0.0,"estimated_usd_cost":0.0,"pricing_note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD.","pricing":{"pricing_rule_id":"default_subscription","stc_cost":0.0,"estimated_usd_cost":0.0,"cost_source":"/v1/pricing/catalog","supported_rails":["subscription"],"note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD."}},{"name":"workflow_registry","title":"Workflow Registry","description":"Returns the static workflow registry with live per-step STC costs resolved from the pricing engine. Use this to understand available multi-step workflows and their costs.","endpoint":"/v1/workflows","method":"GET","category":"discovery","input_schema":{"type":"object","properties":{},"required":[],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"output_summary":"Workflow definitions with live per-step STC costs.","auth_required":false,"metered":false,"pricing_rule_id":null,"supported_rails":[],"access_type":"free","requires_payment":false,"input_location":"query","parameter_source":"query","parameters":[],"stc_cost":null,"estimated_usd_cost":null,"pricing_note":"No paid STC price applies to this discovery entry.","pricing":{"pricing_rule_id":null,"stc_cost":null,"estimated_usd_cost":null,"cost_source":"/v1/pricing/catalog","supported_rails":[],"note":"No paid STC price applies to this discovery entry."}},{"name":"cost_estimate","title":"Workflow Cost Estimate","description":"Returns a deterministic cost estimate for a named workflow. Costs resolved from live pricing rules. Public, free, and non-metered.","endpoint":"/v1/cost-estimate","method":"GET","category":"pricing","input_schema":{"type":"object","properties":{"workflow_id":{"type":"string","enum":["regime_analysis","symbol_decision","stim_forecast_review","portfolio_build","portfolio_compare_review"],"example":"portfolio_build","examples":["regime_analysis","symbol_decision","stim_forecast_review","portfolio_build","portfolio_compare_review"],"description":"Workflow ID. Safe executable examples are listed in enum; see GET /v1/workflows for full details.","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"quota_remaining":{"type":"integer","minimum":0,"description":"Caller's current subscription quota remaining (optional).","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"rail_preference":{"type":"string","enum":["subscription","x402","mpp","auto"],"description":"Rail preference for cost assignment (default: auto).","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"}},"required":["workflow_id"],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"output_summary":"Estimated total STC cost and per-step rail assignment for the workflow.","safe_example_request":{"method":"GET","path":"/v1/cost-estimate","query":{"workflow_id":"portfolio_build","rail_preference":"auto"}},"auth_required":false,"metered":false,"pricing_rule_id":null,"supported_rails":[],"access_type":"free","requires_payment":false,"input_location":"query","parameter_source":"query","parameters":[{"name":"workflow_id","in":"query","input_location":"query","parameter_source":"query","required":true,"schema":{"type":"string","enum":["regime_analysis","symbol_decision","stim_forecast_review","portfolio_build","portfolio_compare_review"],"example":"portfolio_build","examples":["regime_analysis","symbol_decision","stim_forecast_review","portfolio_build","portfolio_compare_review"],"description":"Workflow ID. Safe executable examples are listed in enum; see GET /v1/workflows for full details.","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Workflow ID. Safe executable examples are listed in enum; see GET /v1/workflows for full details.","example":"portfolio_build","style":"form","explode":true},{"name":"quota_remaining","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Caller's current subscription quota remaining (optional).","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Caller's current subscription quota remaining (optional).","style":"form","explode":true},{"name":"rail_preference","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","enum":["subscription","x402","mpp","auto"],"description":"Rail preference for cost assignment (default: auto).","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Rail preference for cost assignment (default: auto).","style":"form","explode":true}],"stc_cost":null,"estimated_usd_cost":null,"pricing_note":"No paid STC price applies to this discovery entry.","pricing":{"pricing_rule_id":null,"stc_cost":null,"estimated_usd_cost":null,"cost_source":"/v1/pricing/catalog","supported_rails":[],"note":"No paid STC price applies to this discovery entry."}},{"name":"instrument_lookup","title":"Instrument Lookup","description":"Planning helper for resolving a ticker into Stock Trends instrument rows and symbol_exchange values before paid symbol, ST-IM, or portfolio calls.","endpoint":"/v1/instruments/lookup","method":"GET","category":"planning_helper","input_schema":{"type":"object","properties":{"symbol":{"type":"string","description":"Ticker symbol, for example IBM.","example":"IBM","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"cs_only":{"type":"boolean","default":true,"description":"Filter to common stocks only.","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"limit":{"type":"integer","minimum":1,"maximum":500,"default":50,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"details":{"type":"boolean","default":false,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"}},"required":["symbol"],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"safe_example_request":{"method":"GET","path":"/v1/instruments/lookup","query":{"symbol":"IBM"}},"output_summary":"Candidate instruments and symbol_exchange keys such as IBM-N.","auth_required":false,"metered":false,"pricing_rule_id":null,"supported_rails":[],"access_type":"free","requires_payment":false,"input_location":"query","parameter_source":"query","parameters":[{"name":"symbol","in":"query","input_location":"query","parameter_source":"query","required":true,"schema":{"type":"string","description":"Ticker symbol, for example IBM.","example":"IBM","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Ticker symbol, for example IBM.","example":"IBM","style":"form","explode":true},{"name":"cs_only","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"boolean","default":true,"description":"Filter to common stocks only.","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Filter to common stocks only.","style":"form","explode":true},{"name":"limit","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500,"default":50,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"style":"form","explode":true},{"name":"details","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"boolean","default":false,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"style":"form","explode":true}],"stc_cost":null,"estimated_usd_cost":null,"pricing_note":"No paid STC price applies to this discovery entry.","pricing":{"pricing_rule_id":null,"stc_cost":null,"estimated_usd_cost":null,"cost_source":"/v1/pricing/catalog","supported_rails":[],"note":"No paid STC price applies to this discovery entry."}},{"name":"instrument_resolve","title":"Instrument Resolve","description":"Planning helper that resolves symbol_exchange or symbol plus exchange into one instrument before downstream paid intelligence calls.","endpoint":"/v1/instruments/resolve","method":"GET","category":"planning_helper","input_schema":{"type":"object","properties":{"symbol_exchange":{"type":"string","description":"Combined symbol and exchange.","example":"IBM-N","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"symbol":{"type":"string","description":"Ticker symbol.","example":"IBM","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"exchange":{"type":"string","enum":["N","Q","A","B","T","I"],"description":"Exchange code.","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"prefer_exchange":{"type":"string","default":"N","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"cs_only":{"type":"boolean","default":true,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"details":{"type":"boolean","default":false,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"}},"required":[],"oneOf":[{"required":["symbol_exchange"]},{"required":["symbol","exchange"]}],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"safe_example_request":{"method":"GET","path":"/v1/instruments/resolve","query":{"symbol_exchange":"IBM-N"}},"output_summary":"One resolved instrument, or ambiguity guidance with candidate matches.","auth_required":false,"metered":false,"pricing_rule_id":null,"supported_rails":[],"access_type":"free","requires_payment":false,"input_location":"query","parameter_source":"query","parameters":[{"name":"symbol_exchange","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","description":"Combined symbol and exchange.","example":"IBM-N","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Combined symbol and exchange.","example":"IBM-N","style":"form","explode":true},{"name":"symbol","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","description":"Ticker symbol.","example":"IBM","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Ticker symbol.","example":"IBM","style":"form","explode":true},{"name":"exchange","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","enum":["N","Q","A","B","T","I"],"description":"Exchange code.","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Exchange code.","style":"form","explode":true},{"name":"prefer_exchange","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","default":"N","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"style":"form","explode":true},{"name":"cs_only","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"boolean","default":true,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"style":"form","explode":true},{"name":"details","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"boolean","default":false,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"style":"form","explode":true}],"stc_cost":null,"estimated_usd_cost":null,"pricing_note":"No paid STC price applies to this discovery entry.","pricing":{"pricing_rule_id":null,"stc_cost":null,"estimated_usd_cost":null,"cost_source":"/v1/pricing/catalog","supported_rails":[],"note":"No paid STC price applies to this discovery entry."}},{"name":"stwr_reports_catalog","title":"STWR Reports Catalog","description":"Planning helper listing Stock Trends Weekly Reporter report codes. Use before paid /v1/stwr/reports/latest or /v1/stwr/reports/history calls.","endpoint":"/v1/stwr/reports/catalog","method":"GET","category":"planning_helper","input_schema":{"type":"object","properties":{},"required":[],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"safe_example_request":{"method":"GET","path":"/v1/stwr/reports/catalog","query":{}},"output_summary":"Report codes, names, and descriptions.","auth_required":false,"metered":false,"pricing_rule_id":null,"supported_rails":[],"access_type":"free","requires_payment":false,"input_location":"query","parameter_source":"query","parameters":[],"stc_cost":null,"estimated_usd_cost":null,"pricing_note":"No paid STC price applies to this discovery entry.","pricing":{"pricing_rule_id":null,"stc_cost":null,"estimated_usd_cost":null,"cost_source":"/v1/pricing/catalog","supported_rails":[],"note":"No paid STC price applies to this discovery entry."}},{"name":"meta_indicators","title":"Indicator Metadata","description":"Planning helper with definitions for Stock Trends fields such as trend, trend_cnt, mt_cnt, rsi, rsi_updn, and vol_tag. Includes the multi-decade indicator provenance reference.","endpoint":"/v1/meta/indicators","method":"GET","category":"planning_helper","input_schema":{"type":"object","properties":{},"required":[],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"safe_example_request":{"method":"GET","path":"/v1/meta/indicators","query":{}},"output_summary":"Indicator field definitions and trend-code meanings.","auth_required":false,"metered":false,"pricing_rule_id":null,"supported_rails":[],"access_type":"free","requires_payment":false,"input_location":"query","parameter_source":"query","parameters":[],"stc_cost":null,"estimated_usd_cost":null,"pricing_note":"No paid STC price applies to this discovery entry.","pricing":{"pricing_rule_id":null,"stc_cost":null,"estimated_usd_cost":null,"cost_source":"/v1/pricing/catalog","supported_rails":[],"note":"No paid STC price applies to this discovery entry."}},{"name":"meta_inference","title":"Inference Cognition Contract","description":"Planning helper defining the provider-agnostic Stock Trends inference contract. Use before interpreting ST-IM or future causal AI outputs so agents preserve provider identity, forecast horizon, distribution, confidence, evidence, uncertainty, explanation, signal sources, and auditability.","endpoint":"/v1/meta/inference","method":"GET","category":"planning_helper","input_schema":{"type":"object","properties":{},"required":[],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"safe_example_request":{"method":"GET","path":"/v1/meta/inference","query":{}},"output_summary":"Provider-agnostic inference and cognition contract metadata.","auth_required":false,"metered":false,"pricing_rule_id":null,"supported_rails":[],"access_type":"free","requires_payment":false,"input_location":"query","parameter_source":"query","parameters":[],"stc_cost":null,"estimated_usd_cost":null,"pricing_note":"No paid STC price applies to this discovery entry.","pricing":{"pricing_rule_id":null,"stc_cost":null,"estimated_usd_cost":null,"cost_source":"/v1/pricing/catalog","supported_rails":[],"note":"No paid STC price applies to this discovery entry."}},{"name":"meta_stim","title":"ST-IM Metadata","description":"Planning helper explaining the ST-IM provider profile, fields, base-period mean returns, confidence bounds, and 4, 13, and 40 week horizons. ST-IM is the current baseline inference provider, not the final intelligence layer. Includes historical classification provenance and limitations language.","endpoint":"/v1/meta/stim","method":"GET","category":"planning_helper","input_schema":{"type":"object","properties":{},"required":[],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"safe_example_request":{"method":"GET","path":"/v1/meta/stim","query":{}},"output_summary":"ST-IM field definitions and base-period mean return metadata.","auth_required":false,"metered":false,"pricing_rule_id":null,"supported_rails":[],"access_type":"free","requires_payment":false,"input_location":"query","parameter_source":"query","parameters":[],"stc_cost":null,"estimated_usd_cost":null,"pricing_note":"No paid STC price applies to this discovery entry.","pricing":{"pricing_rule_id":null,"stc_cost":null,"estimated_usd_cost":null,"cost_source":"/v1/pricing/catalog","supported_rails":[],"note":"No paid STC price applies to this discovery entry."}},{"name":"meta_stwr","title":"STWR Metadata","description":"Planning helper summarizing Stock Trends Weekly Reporter report families and how to choose report codes before paid report calls.","endpoint":"/v1/meta/stwr","method":"GET","category":"planning_helper","input_schema":{"type":"object","properties":{},"required":[],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"safe_example_request":{"method":"GET","path":"/v1/meta/stwr","query":{}},"output_summary":"STWR report family metadata and report-code guidance.","auth_required":false,"metered":false,"pricing_rule_id":null,"supported_rails":[],"access_type":"free","requires_payment":false,"input_location":"query","parameter_source":"query","parameters":[],"stc_cost":null,"estimated_usd_cost":null,"pricing_note":"No paid STC price applies to this discovery entry.","pricing":{"pricing_rule_id":null,"stc_cost":null,"estimated_usd_cost":null,"cost_source":"/v1/pricing/catalog","supported_rails":[],"note":"No paid STC price applies to this discovery entry."}},{"name":"evaluate_symbol","title":"Symbol Decision Evaluation","description":"Evaluates a single symbol's trend context against the live market regime to produce a synthesized bias, confidence score, and decision_score (0–1). Fully deterministic — no ML.","endpoint":"/v1/decision/evaluate-symbol","method":"POST","category":"decision","input_schema":{"type":"object","properties":{"symbol_exchange":{"type":"string","description":"Combined symbol and exchange, e.g. 'AAPL-Q'.","x-stocktrends-input-location":"body","x-stocktrends-parameter-source":"body"},"symbol":{"type":"string","description":"Ticker symbol, e.g. 'AAPL'. Requires exchange when used alone.","x-stocktrends-input-location":"body","x-stocktrends-parameter-source":"body"},"exchange":{"type":"string","description":"Exchange code, e.g. 'Q' (Nasdaq), 'N' (NYSE).","x-stocktrends-input-location":"body","x-stocktrends-parameter-source":"body"}},"required":[],"oneOf":[{"required":["symbol_exchange"]},{"required":["symbol","exchange"]}],"x-stocktrends-input-location":"body","x-stocktrends-parameter-source":"body"},"output_summary":"bias, confidence, decision_score (0–1), alignment, symbol_context, regime_context, signal_notes.","analytical_role":"symbol_decision_engine","auth_required":true,"metered":true,"pricing_rule_id":"evaluate_symbol","supported_rails":["subscription","x402","mpp"],"access_type":"paid","requires_payment":true,"input_location":"body","parameter_source":"body","request_body_schema":{"type":"object","properties":{"symbol_exchange":{"type":"string","description":"Combined symbol and exchange, e.g. 'AAPL-Q'.","x-stocktrends-input-location":"body","x-stocktrends-parameter-source":"body"},"symbol":{"type":"string","description":"Ticker symbol, e.g. 'AAPL'. Requires exchange when used alone.","x-stocktrends-input-location":"body","x-stocktrends-parameter-source":"body"},"exchange":{"type":"string","description":"Exchange code, e.g. 'Q' (Nasdaq), 'N' (NYSE).","x-stocktrends-input-location":"body","x-stocktrends-parameter-source":"body"}},"required":[],"oneOf":[{"required":["symbol_exchange"]},{"required":["symbol","exchange"]}],"x-stocktrends-input-location":"body","x-stocktrends-parameter-source":"body"},"stc_cost":0.5,"estimated_usd_cost":0.5,"pricing_note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD.","pricing":{"pricing_rule_id":"evaluate_symbol","stc_cost":0.5,"estimated_usd_cost":0.5,"cost_source":"/v1/pricing/catalog","supported_rails":["subscription","x402","mpp"],"note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD."}},{"name":"market_regime_latest","title":"Current Market Regime","description":"Returns the current market regime classification derived from the distribution of Stock Trends trend codes across all active signals. regime_score = bullish_pct - bearish_pct, range -1.0 to +1.0. Bullish codes: {^+, ^-, v^}. Bearish codes: {v-, v+, ^v}. Also returns avg_rsi (universe relative performance) and avg_mt_cnt (universe trend maturity).","endpoint":"/v1/market/regime/latest","method":"GET","category":"market","input_schema":{"type":"object","properties":{},"required":[],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"output_summary":"regime, confidence, regime_score, bullish_pct, bearish_pct, avg_rsi, avg_mt_cnt, signal_count, weekdate.","analytical_role":"market_regime_classifier","interpretation_guidance":{"regime_score_scale":{"range":[-1.0,1.0],"formula":"bullish_pct - bearish_pct","strong_bullish":"> 0.5","mixed":"-0.1 to 0.1","strong_bearish":"< -0.5"},"interpretation_rules":["regime_score = bullish_pct minus bearish_pct across all active trend signals.","Do not use regime_score as a trade entry signal; use it as a portfolio bias input.","avg_rsi > 100 indicates the average universe security outperforms the S&P 500 benchmark.","avg_mt_cnt reveals whether the current regime is early-stage or mature.","Confirm with /v1/market/regime/history before acting on a single regime reading."],"downstream_workflow":"Use regime result to set bias in /v1/agent/screener/top or /v1/portfolio/construct. Confirm with /v1/breadth/sector/latest and /v1/leadership/summary/latest.","confirmation_endpoints":["/v1/breadth/sector/latest","/v1/leadership/summary/latest"]},"auth_required":true,"metered":true,"pricing_rule_id":"market_regime_latest","supported_rails":["subscription","x402","mpp"],"access_type":"paid","requires_payment":true,"input_location":"query","parameter_source":"query","parameters":[],"stc_cost":0.15,"estimated_usd_cost":0.15,"pricing_note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD.","pricing":{"pricing_rule_id":"market_regime_latest","stc_cost":0.15,"estimated_usd_cost":0.15,"cost_source":"/v1/pricing/catalog","supported_rails":["subscription","x402","mpp"],"note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD."}},{"name":"market_regime_history","title":"Market Regime History","description":"Returns a historical sequence of weekly market regime snapshots, most recent first. Each entry uses the same classification logic as /market/regime/latest. regime_score = bullish_pct - bearish_pct per week. Useful for trend context and regime transition analysis.","endpoint":"/v1/market/regime/history","method":"GET","category":"market","input_schema":{"type":"object","properties":{},"required":[],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"output_summary":"history[](weekdate, regime, confidence, regime_score, bullish_pct, bearish_pct, avg_rsi, avg_mt_cnt, signal_count), count, limit.","analytical_role":"market_regime_classifier","interpretation_guidance":{"regime_score_scale":{"range":[-1.0,1.0],"formula":"bullish_pct - bearish_pct","strong_bullish":"> 0.5","mixed":"-0.1 to 0.1","strong_bearish":"< -0.5"},"interpretation_rules":["regime_score = bullish_pct minus bearish_pct across all active trend signals.","Do not use regime_score as a trade entry signal; use it as a portfolio bias input.","avg_rsi > 100 indicates the average universe security outperforms the S&P 500 benchmark.","avg_mt_cnt reveals whether the current regime is early-stage or mature.","Confirm with /v1/market/regime/history before acting on a single regime reading."],"downstream_workflow":"Use regime result to set bias in /v1/agent/screener/top or /v1/portfolio/construct. Confirm with /v1/breadth/sector/latest and /v1/leadership/summary/latest.","confirmation_endpoints":["/v1/breadth/sector/latest","/v1/leadership/summary/latest"]},"auth_required":true,"metered":true,"pricing_rule_id":"market_regime_history","supported_rails":["subscription","x402","mpp"],"access_type":"paid","requires_payment":true,"input_location":"query","parameter_source":"query","parameters":[],"stc_cost":0.25,"estimated_usd_cost":0.25,"pricing_note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD.","pricing":{"pricing_rule_id":"market_regime_history","stc_cost":0.25,"estimated_usd_cost":0.25,"cost_source":"/v1/pricing/catalog","supported_rails":["subscription","x402","mpp"],"note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD."}},{"name":"market_regime_forecast","title":"Market Regime Forecast","description":"Returns a deterministic forward regime outlook derived from the direction and consistency of recent weekly regime scores. No ML. forecast_regime: bullish | bearish | mixed. forecast_confidence based on regime_consistency and avg_weekly_score_delta. Reuses the same trend classification as /market/regime/latest.","endpoint":"/v1/market/regime/forecast","method":"GET","category":"market","input_schema":{"type":"object","properties":{},"required":[],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"output_summary":"forecast_regime, forecast_confidence, current_regime, current_regime_score, recent_direction, regime_consistency, projected_regime_score.","analytical_role":"market_regime_classifier","auth_required":true,"metered":true,"pricing_rule_id":"market_regime_forecast","supported_rails":["subscription","x402","mpp"],"access_type":"paid","requires_payment":true,"input_location":"query","parameter_source":"query","parameters":[],"stc_cost":0.35,"estimated_usd_cost":0.35,"pricing_note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD.","pricing":{"pricing_rule_id":"market_regime_forecast","stc_cost":0.35,"estimated_usd_cost":0.35,"cost_source":"/v1/pricing/catalog","supported_rails":["subscription","x402","mpp"],"note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD."}},{"name":"screener_top","title":"Agent Screener Top","description":"Find a ranked candidate set from the latest Stock Trends signal data. Gives agents a compact first paid call for discovering securities with directional Stock Trends signal context before deeper symbol, ST-IM, or portfolio analysis. Fetch /v1/pricing/catalog for current STC cost.","endpoint":"/v1/agent/screener/top","method":"GET","category":"screener","access_type":"paid","requires_payment":true,"input_location":"query","parameter_source":"query","input_schema":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100,"default":25,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"min_rsi":{"type":"integer","description":"Minimum Stock Trends RSI threshold. RSI baseline is 100.","example":40,"default":40,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"exchange":{"type":"string","enum":["N","Q","A","B","T","I"],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"}},"required":[],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"output_summary":"Ranked instruments with Stock Trends signal fields and filter summary.","workflow_role":"Candidate discovery and ranking.","investment_agent_value":"Gives agents a compact first paid call for discovering securities with directional Stock Trends signal context before deeper symbol, ST-IM, or portfolio analysis.","required_inputs":{},"optional_inputs":{"limit":{"type":"integer","required":false,"safe_default":25,"minimum":1,"maximum":100,"input_location":"query","parameter_source":"query"},"min_rsi":{"type":"integer","required":false,"safe_default":40,"example":40,"description":"Minimum Stock Trends RSI threshold. RSI baseline is 100.","input_location":"query","parameter_source":"query"},"exchange":{"type":"string","required":false,"enum":["N","Q","A","B","T","I"],"input_location":"query","parameter_source":"query"}},"safe_example_request":{"method":"GET","path":"/v1/agent/screener/top","query":{"limit":10,"min_rsi":40}},"related_endpoints":["/v1/decision/evaluate-symbol","/v1/portfolio/construct","/v1/stim/latest"],"next_recommended_calls":["/v1/decision/evaluate-symbol","/v1/portfolio/construct"],"analytical_role":"market_intelligence_filter","provenance_reference":{"historical_coverage_start_year":1980,"approximate_observation_count":"16M+","classification_framework":"Stock Trends trend classification methodology","semantic_continuity":"Stock Trends indicators use a consistent classification doctrine across decades of observations.","full_metadata_endpoints":["/v1/ai/context","/v1/meta/indicators","/v1/meta/stim"],"interpretation_limit":"Historical depth supports research and probabilistic interpretation but does not guarantee future performance."},"parameters":[{"name":"limit","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":25,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"style":"form","explode":true},{"name":"min_rsi","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"integer","description":"Minimum Stock Trends RSI threshold. RSI baseline is 100.","example":40,"default":40,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Minimum Stock Trends RSI threshold. RSI baseline is 100.","example":40,"style":"form","explode":true},{"name":"exchange","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","enum":["N","Q","A","B","T","I"],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"style":"form","explode":true}],"auth_required":true,"metered":true,"pricing_rule_id":"agent_screener_top","supported_rails":["subscription","x402","mpp"],"stc_cost":0.5,"estimated_usd_cost":0.5,"pricing_note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD.","pricing":{"pricing_rule_id":"agent_screener_top","stc_cost":0.5,"estimated_usd_cost":0.5,"cost_source":"/v1/pricing/catalog","supported_rails":["subscription","x402","mpp"],"note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD."}},{"name":"portfolio_construct","title":"Portfolio Construct","description":"Build an equal-weight candidate portfolio from Stock Trends signals. Turns ranked signals into a bounded portfolio proposal with deterministic scoring context. Fetch /v1/pricing/catalog for current STC cost.","endpoint":"/v1/portfolio/construct","method":"POST","category":"portfolio","access_type":"paid","requires_payment":true,"input_location":"body","parameter_source":"body","input_schema":{"type":"object","properties":{"universe":{"type":"string","enum":["top"],"description":"Candidate universe selector. Currently supports top-ranked signal candidates.","example":"top","default":"top","x-stocktrends-input-location":"body","x-stocktrends-parameter-source":"body"},"count":{"type":"integer","minimum":1,"maximum":10,"description":"Number of equal-weight positions to construct.","example":5,"default":5,"x-stocktrends-input-location":"body","x-stocktrends-parameter-source":"body"},"bias":{"type":"string","enum":["auto","bullish","bearish"],"description":"Portfolio orientation selector. auto derives context from market regime signals.","example":"auto","default":"auto","x-stocktrends-input-location":"body","x-stocktrends-parameter-source":"body"},"exchange":{"type":"string","enum":["N","Q","A","T"],"description":"Optional exchange filter for candidate selection.","example":"N","x-stocktrends-input-location":"body","x-stocktrends-parameter-source":"body"}},"required":[],"x-stocktrends-input-location":"body","x-stocktrends-parameter-source":"body"},"output_summary":"Constructed equal-weight portfolio with signal, decision, ST-IM tiebreaker, and regime fields.","workflow_role":"Portfolio construction.","investment_agent_value":"Turns ranked signals into a bounded portfolio proposal with deterministic scoring context.","required_inputs":{},"optional_inputs":{"universe":{"type":"string","required":false,"enum":["top"],"safe_default":"top","example":"top","description":"Candidate universe selector. Currently supports top-ranked signal candidates.","input_location":"body","parameter_source":"body"},"count":{"type":"integer","required":false,"minimum":1,"maximum":10,"safe_default":5,"example":5,"description":"Number of equal-weight positions to construct.","input_location":"body","parameter_source":"body"},"bias":{"type":"string","required":false,"enum":["auto","bullish","bearish"],"safe_default":"auto","example":"auto","description":"Portfolio orientation selector. auto derives context from market regime signals.","input_location":"body","parameter_source":"body"},"exchange":{"type":"string","required":false,"enum":["N","Q","A","T"],"example":"N","description":"Optional exchange filter for candidate selection.","input_location":"body","parameter_source":"body"}},"safe_example_request":{"method":"POST","path":"/v1/portfolio/construct","json":{"universe":"top","count":5,"bias":"auto"}},"related_endpoints":["/v1/agent/screener/top","/v1/portfolio/evaluate","/v1/portfolio/compare"],"next_recommended_calls":["/v1/portfolio/evaluate","/v1/portfolio/compare"],"analytical_role":"portfolio_construction_engine","provenance_reference":{"historical_coverage_start_year":1980,"approximate_observation_count":"16M+","classification_framework":"Stock Trends trend classification methodology","semantic_continuity":"Stock Trends indicators use a consistent classification doctrine across decades of observations.","full_metadata_endpoints":["/v1/ai/context","/v1/meta/indicators","/v1/meta/stim"],"interpretation_limit":"Historical depth supports research and probabilistic interpretation but does not guarantee future performance."},"request_body_schema":{"type":"object","properties":{"universe":{"type":"string","enum":["top"],"description":"Candidate universe selector. Currently supports top-ranked signal candidates.","example":"top","default":"top","x-stocktrends-input-location":"body","x-stocktrends-parameter-source":"body"},"count":{"type":"integer","minimum":1,"maximum":10,"description":"Number of equal-weight positions to construct.","example":5,"default":5,"x-stocktrends-input-location":"body","x-stocktrends-parameter-source":"body"},"bias":{"type":"string","enum":["auto","bullish","bearish"],"description":"Portfolio orientation selector. auto derives context from market regime signals.","example":"auto","default":"auto","x-stocktrends-input-location":"body","x-stocktrends-parameter-source":"body"},"exchange":{"type":"string","enum":["N","Q","A","T"],"description":"Optional exchange filter for candidate selection.","example":"N","x-stocktrends-input-location":"body","x-stocktrends-parameter-source":"body"}},"required":[],"x-stocktrends-input-location":"body","x-stocktrends-parameter-source":"body"},"auth_required":true,"metered":true,"pricing_rule_id":"portfolio_construct","supported_rails":["subscription","x402","mpp"],"stc_cost":1.0,"estimated_usd_cost":1.0,"pricing_note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD.","pricing":{"pricing_rule_id":"portfolio_construct","stc_cost":1.0,"estimated_usd_cost":1.0,"cost_source":"/v1/pricing/catalog","supported_rails":["subscription","x402","mpp"],"note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD."}},{"name":"portfolio_evaluate","title":"Portfolio Evaluate","description":"Evaluate an existing or proposed portfolio. Lets agents score portfolio alignment to current Stock Trends signal and regime context. Fetch /v1/pricing/catalog for current STC cost.","endpoint":"/v1/portfolio/evaluate","method":"POST","category":"portfolio","access_type":"paid","requires_payment":true,"input_location":"body","parameter_source":"body","input_schema":{"type":"object","properties":{"positions":{"type":"array","items":{"type":"object","properties":{"symbol_exchange":{"type":"string","example":"IBM-N","pattern":"^[A-Z0-9.]+-[A-Z]$","description":"Stock Trends symbol plus exchange suffix."},"weight":{"type":"number","minimum":0,"maximum":1,"example":1.0,"description":"Portfolio weight for this position."}},"required":["symbol_exchange","weight"],"additionalProperties":false},"description":"List of symbol/weight positions.","example":[{"symbol_exchange":"IBM-N","weight":1.0}],"x-stocktrends-input-location":"body","x-stocktrends-parameter-source":"body"}},"required":["positions"],"x-stocktrends-input-location":"body","x-stocktrends-parameter-source":"body"},"output_summary":"Portfolio-level and position-level Stock Trends evaluation.","workflow_role":"Portfolio review.","investment_agent_value":"Lets agents score portfolio alignment to current Stock Trends signal and regime context.","required_inputs":{"positions":{"type":"array","required":true,"description":"List of symbol/weight positions.","example":[{"symbol_exchange":"IBM-N","weight":1.0}],"items":{"type":"object","properties":{"symbol_exchange":{"type":"string","example":"IBM-N","pattern":"^[A-Z0-9.]+-[A-Z]$","description":"Stock Trends symbol plus exchange suffix."},"weight":{"type":"number","minimum":0,"maximum":1,"example":1.0,"description":"Portfolio weight for this position."}},"required":["symbol_exchange","weight"],"additionalProperties":false},"input_location":"body","parameter_source":"body"}},"optional_inputs":{},"safe_example_request":{"method":"POST","path":"/v1/portfolio/evaluate","json":{"positions":[{"symbol_exchange":"IBM-N","weight":1.0}]}},"related_endpoints":["/v1/portfolio/construct","/v1/portfolio/compare"],"next_recommended_calls":["/v1/portfolio/compare"],"analytical_role":"portfolio_evaluation_engine","provenance_reference":{"historical_coverage_start_year":1980,"approximate_observation_count":"16M+","classification_framework":"Stock Trends trend classification methodology","semantic_continuity":"Stock Trends indicators use a consistent classification doctrine across decades of observations.","full_metadata_endpoints":["/v1/ai/context","/v1/meta/indicators","/v1/meta/stim"],"interpretation_limit":"Historical depth supports research and probabilistic interpretation but does not guarantee future performance."},"request_body_schema":{"type":"object","properties":{"positions":{"type":"array","items":{"type":"object","properties":{"symbol_exchange":{"type":"string","example":"IBM-N","pattern":"^[A-Z0-9.]+-[A-Z]$","description":"Stock Trends symbol plus exchange suffix."},"weight":{"type":"number","minimum":0,"maximum":1,"example":1.0,"description":"Portfolio weight for this position."}},"required":["symbol_exchange","weight"],"additionalProperties":false},"description":"List of symbol/weight positions.","example":[{"symbol_exchange":"IBM-N","weight":1.0}],"x-stocktrends-input-location":"body","x-stocktrends-parameter-source":"body"}},"required":["positions"],"x-stocktrends-input-location":"body","x-stocktrends-parameter-source":"body"},"auth_required":true,"metered":true,"pricing_rule_id":"portfolio_evaluate","supported_rails":["subscription","x402","mpp"],"stc_cost":0.75,"estimated_usd_cost":0.75,"pricing_note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD.","pricing":{"pricing_rule_id":"portfolio_evaluate","stc_cost":0.75,"estimated_usd_cost":0.75,"cost_source":"/v1/pricing/catalog","supported_rails":["subscription","x402","mpp"],"note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD."}},{"name":"portfolio_compare","title":"Portfolio Compare","description":"Compare current and proposed portfolios. Helps agents quantify whether a proposed portfolio improves Stock Trends score and regime alignment. Fetch /v1/pricing/catalog for current STC cost.","endpoint":"/v1/portfolio/compare","method":"POST","category":"portfolio","access_type":"paid","requires_payment":true,"input_location":"body","parameter_source":"body","input_schema":{"type":"object","properties":{"left":{"type":"array","items":{"type":"object","properties":{"symbol_exchange":{"type":"string","example":"IBM-N","pattern":"^[A-Z0-9.]+-[A-Z]$","description":"Stock Trends symbol plus exchange suffix."},"weight":{"type":"number","minimum":0,"maximum":1,"example":1.0,"description":"Portfolio weight for this position."}},"required":["symbol_exchange","weight"],"additionalProperties":false},"description":"Left portfolio as a direct array of symbol-weight positions.","example":[{"symbol_exchange":"IBM-N","weight":1.0}],"x-stocktrends-input-location":"body","x-stocktrends-parameter-source":"body"},"right":{"type":"array","items":{"type":"object","properties":{"symbol_exchange":{"type":"string","example":"IBM-N","pattern":"^[A-Z0-9.]+-[A-Z]$","description":"Stock Trends symbol plus exchange suffix."},"weight":{"type":"number","minimum":0,"maximum":1,"example":1.0,"description":"Portfolio weight for this position."}},"required":["symbol_exchange","weight"],"additionalProperties":false},"description":"Right portfolio as a direct array of symbol-weight positions.","example":[{"symbol_exchange":"MSFT-Q","weight":1.0}],"x-stocktrends-input-location":"body","x-stocktrends-parameter-source":"body"}},"required":["left","right"],"x-stocktrends-input-location":"body","x-stocktrends-parameter-source":"body"},"output_summary":"Side-by-side portfolio evaluations and comparison metrics.","workflow_role":"Portfolio comparison.","investment_agent_value":"Helps agents quantify whether a proposed portfolio improves Stock Trends score and regime alignment.","required_inputs":{"left":{"type":"array","required":true,"description":"Left portfolio as a direct array of symbol-weight positions.","example":[{"symbol_exchange":"IBM-N","weight":1.0}],"items":{"type":"object","properties":{"symbol_exchange":{"type":"string","example":"IBM-N","pattern":"^[A-Z0-9.]+-[A-Z]$","description":"Stock Trends symbol plus exchange suffix."},"weight":{"type":"number","minimum":0,"maximum":1,"example":1.0,"description":"Portfolio weight for this position."}},"required":["symbol_exchange","weight"],"additionalProperties":false},"input_location":"body","parameter_source":"body"},"right":{"type":"array","required":true,"description":"Right portfolio as a direct array of symbol-weight positions.","example":[{"symbol_exchange":"MSFT-Q","weight":1.0}],"items":{"type":"object","properties":{"symbol_exchange":{"type":"string","example":"IBM-N","pattern":"^[A-Z0-9.]+-[A-Z]$","description":"Stock Trends symbol plus exchange suffix."},"weight":{"type":"number","minimum":0,"maximum":1,"example":1.0,"description":"Portfolio weight for this position."}},"required":["symbol_exchange","weight"],"additionalProperties":false},"input_location":"body","parameter_source":"body"}},"optional_inputs":{},"safe_example_request":{"method":"POST","path":"/v1/portfolio/compare","json":{"left":[{"symbol_exchange":"IBM-N","weight":1.0}],"right":[{"symbol_exchange":"MSFT-Q","weight":1.0}]}},"related_endpoints":["/v1/portfolio/evaluate","/v1/portfolio/construct"],"next_recommended_calls":["/v1/portfolio/evaluate"],"analytical_role":"portfolio_evaluation_engine","provenance_reference":{"historical_coverage_start_year":1980,"approximate_observation_count":"16M+","classification_framework":"Stock Trends trend classification methodology","semantic_continuity":"Stock Trends indicators use a consistent classification doctrine across decades of observations.","full_metadata_endpoints":["/v1/ai/context","/v1/meta/indicators","/v1/meta/stim"],"interpretation_limit":"Historical depth supports research and probabilistic interpretation but does not guarantee future performance."},"request_body_schema":{"type":"object","properties":{"left":{"type":"array","items":{"type":"object","properties":{"symbol_exchange":{"type":"string","example":"IBM-N","pattern":"^[A-Z0-9.]+-[A-Z]$","description":"Stock Trends symbol plus exchange suffix."},"weight":{"type":"number","minimum":0,"maximum":1,"example":1.0,"description":"Portfolio weight for this position."}},"required":["symbol_exchange","weight"],"additionalProperties":false},"description":"Left portfolio as a direct array of symbol-weight positions.","example":[{"symbol_exchange":"IBM-N","weight":1.0}],"x-stocktrends-input-location":"body","x-stocktrends-parameter-source":"body"},"right":{"type":"array","items":{"type":"object","properties":{"symbol_exchange":{"type":"string","example":"IBM-N","pattern":"^[A-Z0-9.]+-[A-Z]$","description":"Stock Trends symbol plus exchange suffix."},"weight":{"type":"number","minimum":0,"maximum":1,"example":1.0,"description":"Portfolio weight for this position."}},"required":["symbol_exchange","weight"],"additionalProperties":false},"description":"Right portfolio as a direct array of symbol-weight positions.","example":[{"symbol_exchange":"MSFT-Q","weight":1.0}],"x-stocktrends-input-location":"body","x-stocktrends-parameter-source":"body"}},"required":["left","right"],"x-stocktrends-input-location":"body","x-stocktrends-parameter-source":"body"},"auth_required":true,"metered":true,"pricing_rule_id":"portfolio_compare","supported_rails":["subscription","x402","mpp"],"stc_cost":1.25,"estimated_usd_cost":1.25,"pricing_note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD.","pricing":{"pricing_rule_id":"portfolio_compare","stc_cost":1.25,"estimated_usd_cost":1.25,"cost_source":"/v1/pricing/catalog","supported_rails":["subscription","x402","mpp"],"note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD."}},{"name":"stim_latest","title":"STIM Latest","description":"Retrieve latest ST-IM forward return distribution outputs for one instrument. Provides probabilistic forward return context for ranking and decision workflows. Fetch /v1/pricing/catalog for current STC cost.","endpoint":"/v1/stim/latest","method":"GET","category":"stim","access_type":"paid","requires_payment":true,"input_location":"query","parameter_source":"query","input_schema":{"type":"object","properties":{"symbol_exchange":{"type":"string","pattern":"^[A-Z0-9.]+-[A-Z]$","description":"Stock Trends symbol plus exchange suffix.","example":"IBM-N","safe_default_for_demo":"IBM-N","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"symbol":{"type":"string","description":"Ticker symbol. Use with exchange when symbol_exchange is not supplied.","example":"IBM","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"exchange":{"type":"string","enum":["N","Q","A","B","T","I"],"description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","example":"N","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"}},"required":["symbol_exchange"],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query","description":"Provide symbol_exchange, or provide both symbol and exchange."},"output_summary":"ST-IM forward return expectations and statistical distributions across 4, 13, and 40 weeks.","workflow_role":"Forward distribution enrichment.","investment_agent_value":"Provides probabilistic forward return context for ranking and decision workflows.","required_inputs":{"symbol_exchange":{"type":"string","required":true,"example":"IBM-N","safe_default_for_demo":"IBM-N","pattern":"^[A-Z0-9.]+-[A-Z]$","description":"Stock Trends symbol plus exchange suffix.","input_location":"query","parameter_source":"query"}},"optional_inputs":{"symbol":{"type":"string","required":false,"example":"IBM","description":"Ticker symbol. Use with exchange when symbol_exchange is not supplied.","input_location":"query","parameter_source":"query"},"exchange":{"type":"string","required":false,"enum":["N","Q","A","B","T","I"],"example":"N","description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","input_location":"query","parameter_source":"query"}},"safe_example_request":{"method":"GET","path":"/v1/stim/latest","query":{"symbol_exchange":"IBM-N"}},"related_endpoints":["/v1/meta/inference","/v1/meta/stim","/v1/indicators/latest","/v1/stim/history","/v1/selections/published/latest"],"next_recommended_calls":["/v1/meta/inference","/v1/meta/stim","/v1/decision/evaluate-symbol","/v1/portfolio/construct"],"analytical_role":"probabilistic_forward_inference","interpretation_dependency":{"endpoint":"/v1/meta/stim","method":"GET","required_before_interpretation":true,"reason":"The ST-IM provider profile supplies base-period mean returns and provider-specific interpretation rules. /v1/meta/inference supplies the provider-agnostic cognition contract.","inference_contract_endpoint":"/v1/meta/inference","cognition_architecture":"docs/STOCK_TRENDS_COGNITION_ARCHITECTURE.md"},"interpretation_guidance":{"inference_contract_endpoint":"/v1/meta/inference","inference_provider":{"provider_id":"stim","provider_role":"current_baseline_inference_provider","not_final_intelligence_layer":true,"profile_endpoint":"/v1/meta/stim"},"base_period_mean_returns_pct":{"x4wk":"4-week baseline from /v1/meta/stim","x13wk":"13-week baseline from /v1/meta/stim","x40wk":"40-week baseline from /v1/meta/stim"},"mean_return_fields":["x4wk","x13wk","x40wk"],"standard_deviation_fields":["x4wksd","x13wksd","x40wksd"],"calculation":{"delta_vs_base":"stim_mean - base_mean","z":"(base_mean - stim_mean) / standard_deviation","probability_outperform":"1 - normal_cdf(z)"},"interpretation_rules":["Call /v1/meta/inference and /v1/meta/stim before interpreting ST-IM results.","Raw x4wk/x13wk/x40wk means are estimated mean returns, not standalone bullish signals.","Do not interpret a positive raw mean as bullish unless it exceeds the relevant base mean or has adequate probability of exceeding it.","Use x4wksd/x13wksd/x40wksd to estimate probability of exceeding base-period means under the stated distribution assumption.","Interpret ST-IM probabilities as conditional historical tendencies, not guarantees, price targets, or buy/sell commands.","If is_stale=true or missing_reason is present, treat the ST-IM result as historical fallback and disclose that limitation."],"randomness_assumptions":["Markets are noisy, uncertain, and partly random.","ST-IM does not eliminate randomness; it estimates conditional historical tendencies.","Individual outcomes can diverge materially from the estimated distribution."],"distribution_framing":{"assumption":"normal_approximation","central_limit_theorem_intuition":"Large historical populations of similarly classified observations can support distribution-level reasoning even though individual securities remain uncertain.","probability_formula":"probability_outperform = 1 - normal_cdf((base_mean - stim_mean) / standard_deviation)"},"classification_role":"The Stock Trends classification system converts raw weekly market behavior into structured, repeatable factor states. These states create historical populations from which forward-return distributions can be estimated and compared.","limitations":["regime_shifts","non_stationarity","sample_size_weakness","tail_events","liquidity_shocks","news_shocks","uncertainty_in_individual_stock_outcomes"],"portfolio_applications":["ranking","screening","allocation_review","regime-aware interpretation","market-structure analysis","repeated decision-making under uncertainty"],"stim_select_style_logic":{"prob13wk_minimum":0.55,"prob13wk_minimum_description":"13-week probability of exceeding the base-period mean should be at least 55%.","lower_confidence_bounds":"Emphasize lower confidence bounds relative to base-period means where applicable."}},"required_interpretation_steps":["Fetch GET /v1/meta/inference.","Fetch GET /v1/meta/stim.","Read base_period_mean_returns_pct.x4wk, x13wk, and x40wk.","For each horizon, compare xNwk to the matching base mean.","Compute delta_vs_base = stim_mean - base_mean.","Compute z = (base_mean - stim_mean) / standard_deviation.","Compute probability_outperform = 1 - normal_cdf(z).","Review lower confidence bounds against base-period means where available.","Preserve provider identity, evidence, uncertainty, confidence, and explanation in downstream reasoning.","Disclose stale or fallback data when is_stale=true or missing_reason is present."],"inference_contract":{"endpoint":"/v1/meta/inference","provider_agnostic":true,"core_concepts":["inference_provider","forecast_horizon","probability_distribution","confidence_measure","evidence","uncertainty","explanation","signal_source","reasoning_interpretation"]},"inference_provider":{"provider_id":"stim","provider_name":"Stock Trends Inference Model","provider_role":"current_baseline_inference_provider","provider_profile_endpoint":"/v1/meta/stim","not_final_intelligence_layer":true,"future_causal_ai_compatible":true},"cognition_architecture":"docs/STOCK_TRENDS_COGNITION_ARCHITECTURE.md","parameters":[{"name":"symbol_exchange","in":"query","input_location":"query","parameter_source":"query","required":true,"schema":{"type":"string","pattern":"^[A-Z0-9.]+-[A-Z]$","description":"Stock Trends symbol plus exchange suffix.","example":"IBM-N","safe_default_for_demo":"IBM-N","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Stock Trends symbol plus exchange suffix.","example":"IBM-N","style":"form","explode":true},{"name":"symbol","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","description":"Ticker symbol. Use with exchange when symbol_exchange is not supplied.","example":"IBM","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Ticker symbol. Use with exchange when symbol_exchange is not supplied.","example":"IBM","style":"form","explode":true},{"name":"exchange","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","enum":["N","Q","A","B","T","I"],"description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","example":"N","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","example":"N","style":"form","explode":true}],"auth_required":true,"metered":true,"pricing_rule_id":"stim_latest_paid","supported_rails":["subscription","x402","mpp"],"stc_cost":0.0025,"estimated_usd_cost":0.0025,"pricing_note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD.","pricing":{"pricing_rule_id":"stim_latest_paid","stc_cost":0.0025,"estimated_usd_cost":0.0025,"cost_source":"/v1/pricing/catalog","supported_rails":["subscription","x402","mpp"],"note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD."}},{"name":"stim_history","title":"STIM History","description":"Retrieve a symbol-level history of ST-IM distribution records. Lets agents compare current distribution outputs with prior weekly estimates. Fetch /v1/pricing/catalog for current STC cost.","endpoint":"/v1/stim/history","method":"GET","category":"stim","access_type":"paid","requires_payment":true,"input_location":"query","parameter_source":"query","input_schema":{"type":"object","properties":{"symbol_exchange":{"type":"string","pattern":"^[A-Z0-9.]+-[A-Z]$","description":"Stock Trends symbol plus exchange suffix.","example":"IBM-N","safe_default_for_demo":"IBM-N","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"symbol":{"type":"string","description":"Ticker symbol. Use with exchange when symbol_exchange is not supplied.","example":"IBM","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"exchange":{"type":"string","enum":["N","Q","A","B","T","I"],"description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","example":"N","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"start":{"type":"string","format":"date","description":"Inclusive start weekdate in YYYY-MM-DD format.","example":"2025-01-03","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"end":{"type":"string","format":"date","description":"Inclusive end weekdate in YYYY-MM-DD format.","example":"2025-12-26","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"limit":{"type":"integer","minimum":1,"maximum":2600,"description":"Maximum number of rows returned.","example":260,"default":260,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"include_gaps":{"type":"boolean","default":false,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"}},"required":["symbol_exchange"],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query","description":"Provide symbol_exchange, or provide both symbol and exchange."},"output_summary":"Historical ST-IM distributions across 4, 13, and 40 week horizons.","workflow_role":"Historical forward-distribution context.","investment_agent_value":"Lets agents compare current distribution outputs with prior weekly estimates.","required_inputs":{"symbol_exchange":{"type":"string","required":true,"example":"IBM-N","safe_default_for_demo":"IBM-N","pattern":"^[A-Z0-9.]+-[A-Z]$","description":"Stock Trends symbol plus exchange suffix.","input_location":"query","parameter_source":"query"}},"optional_inputs":{"symbol":{"type":"string","required":false,"example":"IBM","description":"Ticker symbol. Use with exchange when symbol_exchange is not supplied.","input_location":"query","parameter_source":"query"},"exchange":{"type":"string","required":false,"enum":["N","Q","A","B","T","I"],"example":"N","description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","input_location":"query","parameter_source":"query"},"start":{"type":"string","required":false,"format":"date","example":"2025-01-03","description":"Inclusive start weekdate in YYYY-MM-DD format.","input_location":"query","parameter_source":"query"},"end":{"type":"string","required":false,"format":"date","example":"2025-12-26","description":"Inclusive end weekdate in YYYY-MM-DD format.","input_location":"query","parameter_source":"query"},"limit":{"type":"integer","required":false,"safe_default":260,"minimum":1,"maximum":2600,"example":260,"description":"Maximum number of rows returned.","input_location":"query","parameter_source":"query"},"include_gaps":{"type":"boolean","required":false,"safe_default":false,"input_location":"query","parameter_source":"query"}},"safe_example_request":{"method":"GET","path":"/v1/stim/history","query":{"symbol_exchange":"IBM-N","limit":52}},"related_endpoints":["/v1/meta/inference","/v1/meta/stim","/v1/stim/latest","/v1/indicators/history"],"next_recommended_calls":["/v1/meta/inference","/v1/meta/stim","/v1/indicators/history","/v1/decision/evaluate-symbol"],"analytical_role":"probabilistic_forward_inference","interpretation_dependency":{"endpoint":"/v1/meta/stim","method":"GET","required_before_interpretation":true,"reason":"The ST-IM provider profile supplies base-period mean returns and provider-specific interpretation rules. /v1/meta/inference supplies the provider-agnostic cognition contract.","inference_contract_endpoint":"/v1/meta/inference","cognition_architecture":"docs/STOCK_TRENDS_COGNITION_ARCHITECTURE.md"},"interpretation_guidance":{"inference_contract_endpoint":"/v1/meta/inference","inference_provider":{"provider_id":"stim","provider_role":"current_baseline_inference_provider","not_final_intelligence_layer":true,"profile_endpoint":"/v1/meta/stim"},"base_period_mean_returns_pct":{"x4wk":"4-week baseline from /v1/meta/stim","x13wk":"13-week baseline from /v1/meta/stim","x40wk":"40-week baseline from /v1/meta/stim"},"mean_return_fields":["x4wk","x13wk","x40wk"],"standard_deviation_fields":["x4wksd","x13wksd","x40wksd"],"calculation":{"delta_vs_base":"stim_mean - base_mean","z":"(base_mean - stim_mean) / standard_deviation","probability_outperform":"1 - normal_cdf(z)"},"interpretation_rules":["Call /v1/meta/inference and /v1/meta/stim before interpreting ST-IM results.","Raw x4wk/x13wk/x40wk means are estimated mean returns, not standalone bullish signals.","Do not interpret a positive raw mean as bullish unless it exceeds the relevant base mean or has adequate probability of exceeding it.","Use x4wksd/x13wksd/x40wksd to estimate probability of exceeding base-period means under the stated distribution assumption.","Interpret ST-IM probabilities as conditional historical tendencies, not guarantees, price targets, or buy/sell commands.","If is_stale=true or missing_reason is present, treat the ST-IM result as historical fallback and disclose that limitation."],"randomness_assumptions":["Markets are noisy, uncertain, and partly random.","ST-IM does not eliminate randomness; it estimates conditional historical tendencies.","Individual outcomes can diverge materially from the estimated distribution."],"distribution_framing":{"assumption":"normal_approximation","central_limit_theorem_intuition":"Large historical populations of similarly classified observations can support distribution-level reasoning even though individual securities remain uncertain.","probability_formula":"probability_outperform = 1 - normal_cdf((base_mean - stim_mean) / standard_deviation)"},"classification_role":"The Stock Trends classification system converts raw weekly market behavior into structured, repeatable factor states. These states create historical populations from which forward-return distributions can be estimated and compared.","limitations":["regime_shifts","non_stationarity","sample_size_weakness","tail_events","liquidity_shocks","news_shocks","uncertainty_in_individual_stock_outcomes"],"portfolio_applications":["ranking","screening","allocation_review","regime-aware interpretation","market-structure analysis","repeated decision-making under uncertainty"],"stim_select_style_logic":{"prob13wk_minimum":0.55,"prob13wk_minimum_description":"13-week probability of exceeding the base-period mean should be at least 55%.","lower_confidence_bounds":"Emphasize lower confidence bounds relative to base-period means where applicable."}},"required_interpretation_steps":["Fetch GET /v1/meta/inference.","Fetch GET /v1/meta/stim.","Read base_period_mean_returns_pct.x4wk, x13wk, and x40wk.","For each horizon, compare xNwk to the matching base mean.","Compute delta_vs_base = stim_mean - base_mean.","Compute z = (base_mean - stim_mean) / standard_deviation.","Compute probability_outperform = 1 - normal_cdf(z).","Review lower confidence bounds against base-period means where available.","Preserve provider identity, evidence, uncertainty, confidence, and explanation in downstream reasoning.","Disclose stale or fallback data when is_stale=true or missing_reason is present."],"inference_contract":{"endpoint":"/v1/meta/inference","provider_agnostic":true,"core_concepts":["inference_provider","forecast_horizon","probability_distribution","confidence_measure","evidence","uncertainty","explanation","signal_source","reasoning_interpretation"]},"inference_provider":{"provider_id":"stim","provider_name":"Stock Trends Inference Model","provider_role":"current_baseline_inference_provider","provider_profile_endpoint":"/v1/meta/stim","not_final_intelligence_layer":true,"future_causal_ai_compatible":true},"cognition_architecture":"docs/STOCK_TRENDS_COGNITION_ARCHITECTURE.md","parameters":[{"name":"symbol_exchange","in":"query","input_location":"query","parameter_source":"query","required":true,"schema":{"type":"string","pattern":"^[A-Z0-9.]+-[A-Z]$","description":"Stock Trends symbol plus exchange suffix.","example":"IBM-N","safe_default_for_demo":"IBM-N","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Stock Trends symbol plus exchange suffix.","example":"IBM-N","style":"form","explode":true},{"name":"symbol","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","description":"Ticker symbol. Use with exchange when symbol_exchange is not supplied.","example":"IBM","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Ticker symbol. Use with exchange when symbol_exchange is not supplied.","example":"IBM","style":"form","explode":true},{"name":"exchange","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","enum":["N","Q","A","B","T","I"],"description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","example":"N","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","example":"N","style":"form","explode":true},{"name":"start","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","format":"date","description":"Inclusive start weekdate in YYYY-MM-DD format.","example":"2025-01-03","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Inclusive start weekdate in YYYY-MM-DD format.","example":"2025-01-03","style":"form","explode":true},{"name":"end","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","format":"date","description":"Inclusive end weekdate in YYYY-MM-DD format.","example":"2025-12-26","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Inclusive end weekdate in YYYY-MM-DD format.","example":"2025-12-26","style":"form","explode":true},{"name":"limit","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":2600,"description":"Maximum number of rows returned.","example":260,"default":260,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Maximum number of rows returned.","example":260,"style":"form","explode":true},{"name":"include_gaps","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"boolean","default":false,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"style":"form","explode":true}],"auth_required":true,"metered":true,"pricing_rule_id":"stim_history_paid","supported_rails":["subscription","x402","mpp"],"stc_cost":0.0075,"estimated_usd_cost":0.0075,"pricing_note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD.","pricing":{"pricing_rule_id":"stim_history_paid","stc_cost":0.0075,"estimated_usd_cost":0.0075,"cost_source":"/v1/pricing/catalog","supported_rails":["subscription","x402","mpp"],"note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD."}},{"name":"selections_latest","title":"Selections Latest","description":"Returns the latest base ST-IM selection universe for the most recent weekdate, ranked by prob13wk descending — the probability of exceeding the 13-week base-period mean random return (2.19%), assuming a normal distribution. No published threshold filter is applied; all base selection records for the week are returned. Use /selections/published/latest for the three-horizon published STIM Select definition.","endpoint":"/v1/selections/latest","method":"GET","category":"selections","input_schema":{"type":"object","properties":{"exchange":{"type":"string","description":"Optional exchange filter: N, Q, A, B, T, I.","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"min_prob13wk":{"type":"number","description":"Optional minimum prob13wk threshold (0.0–1.0).","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"}},"required":[],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"output_summary":"weekdate, count, data[](weekdate, exchange, symbol, prob13wk, symbol_exchange).","analytical_role":"probabilistic_selection_universe","auth_required":true,"metered":true,"pricing_rule_id":"selections_latest_paid","supported_rails":["subscription","x402","mpp"],"access_type":"paid","requires_payment":true,"input_location":"query","parameter_source":"query","parameters":[{"name":"exchange","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","description":"Optional exchange filter: N, Q, A, B, T, I.","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Optional exchange filter: N, Q, A, B, T, I.","style":"form","explode":true},{"name":"min_prob13wk","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"number","description":"Optional minimum prob13wk threshold (0.0–1.0).","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Optional minimum prob13wk threshold (0.0–1.0).","style":"form","explode":true}],"stc_cost":0.05,"estimated_usd_cost":0.05,"pricing_note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD.","pricing":{"pricing_rule_id":"selections_latest_paid","stc_cost":0.05,"estimated_usd_cost":0.05,"cost_source":"/v1/pricing/catalog","supported_rails":["subscription","x402","mpp"],"note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD."}},{"name":"selections_history","title":"Selections History","description":"Returns historical base ST-IM selection records. Filter by symbol_exchange, symbol, exchange, or date range. Each entry includes prob13wk — probability of exceeding the 13-week base-period mean random return (2.19%), assuming a normal distribution. No threshold filter is applied unless min_prob13wk is set. Use /selections/published/history for the three-horizon published definition.","endpoint":"/v1/selections/history","method":"GET","category":"selections","input_schema":{"type":"object","properties":{"symbol_exchange":{"type":"string","description":"Combined symbol and exchange, e.g. 'IBM-N'.","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"symbol":{"type":"string","description":"Ticker symbol, e.g. 'IBM'.","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"exchange":{"type":"string","description":"Exchange code, e.g. 'N'.","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"start":{"type":"string","description":"Start date YYYY-MM-DD (inclusive).","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"end":{"type":"string","description":"End date YYYY-MM-DD (inclusive).","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"min_prob13wk":{"type":"number","description":"Optional minimum prob13wk threshold.","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"}},"required":[],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"output_summary":"count, data[](weekdate, exchange, symbol, prob13wk, symbol_exchange).","analytical_role":"probabilistic_selection_universe","auth_required":true,"metered":true,"pricing_rule_id":"selections_history_paid","supported_rails":["subscription","x402","mpp"],"access_type":"paid","requires_payment":true,"input_location":"query","parameter_source":"query","parameters":[{"name":"symbol_exchange","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","description":"Combined symbol and exchange, e.g. 'IBM-N'.","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Combined symbol and exchange, e.g. 'IBM-N'.","style":"form","explode":true},{"name":"symbol","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","description":"Ticker symbol, e.g. 'IBM'.","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Ticker symbol, e.g. 'IBM'.","style":"form","explode":true},{"name":"exchange","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","description":"Exchange code, e.g. 'N'.","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Exchange code, e.g. 'N'.","style":"form","explode":true},{"name":"start","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","description":"Start date YYYY-MM-DD (inclusive).","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Start date YYYY-MM-DD (inclusive).","style":"form","explode":true},{"name":"end","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","description":"End date YYYY-MM-DD (inclusive).","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"End date YYYY-MM-DD (inclusive).","style":"form","explode":true},{"name":"min_prob13wk","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"number","description":"Optional minimum prob13wk threshold.","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Optional minimum prob13wk threshold.","style":"form","explode":true}],"stc_cost":0.15,"estimated_usd_cost":0.15,"pricing_note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD.","pricing":{"pricing_rule_id":"selections_history_paid","stc_cost":0.15,"estimated_usd_cost":0.15,"cost_source":"/v1/pricing/catalog","supported_rails":["subscription","x402","mpp"],"note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD."}},{"name":"selections_published_latest","title":"Published STIM Select Latest","description":"Returns the latest published STIM Select list filtered to the published definition: x4wk1 > 0% (4-week lower CI bound), x13wk1 > 2.19% (13-week), x40wk1 > 6.45% (40-week), and prob13wk >= 55% by default. Ranked by prob13wk descending. Includes full ST-IM distribution fields.","endpoint":"/v1/selections/published/latest","method":"GET","category":"selections","input_schema":{"type":"object","properties":{"exchange":{"type":"string","description":"Optional exchange filter: N, Q, A, B, T, I.","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"min_prob13wk":{"type":"number","description":"Minimum prob13wk threshold (default 0.55).","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"}},"required":[],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"output_summary":"weekdate, count, data[](weekdate, exchange, symbol, prob13wk, x4wk1, x13wk1, x40wk1, symbol_exchange).","analytical_role":"probabilistic_selection_list","interpretation_guidance":{"publication_criteria":{"x4wk1":{"operator":">","threshold_pct":0.0,"description":"4-week ST-IM lower CI bound must exceed base-period mean of 0%."},"x13wk1":{"operator":">","threshold_pct":2.19,"description":"13-week ST-IM lower CI bound must exceed base-period mean of 2.19%."},"x40wk1":{"operator":">","threshold_pct":6.45,"description":"40-week ST-IM lower CI bound must exceed base-period mean of 6.45%."},"prob13wk":{"operator":">=","threshold":0.55,"description":"Probability of exceeding 13-week base-period mean must be at least 55%."},"all_criteria_required":true},"interpretation_rules":["All four publication criteria must be satisfied simultaneously.","prob13wk >= 0.55 is the documented publication threshold.","Rank by prob13wk descending; higher prob13wk means stronger 13-week outperformance probability.","These are probabilistic candidates, not guaranteed outcomes — not investment advice.","Use /v1/stim/latest on individual symbols to see full distribution context."],"base_period_context_endpoint":"/v1/meta/stim"},"auth_required":true,"metered":true,"pricing_rule_id":"selections_published_latest_paid","supported_rails":["subscription","x402","mpp"],"access_type":"paid","requires_payment":true,"input_location":"query","parameter_source":"query","parameters":[{"name":"exchange","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","description":"Optional exchange filter: N, Q, A, B, T, I.","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Optional exchange filter: N, Q, A, B, T, I.","style":"form","explode":true},{"name":"min_prob13wk","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"number","description":"Minimum prob13wk threshold (default 0.55).","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Minimum prob13wk threshold (default 0.55).","style":"form","explode":true}],"stc_cost":0.075,"estimated_usd_cost":0.075,"pricing_note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD.","pricing":{"pricing_rule_id":"selections_published_latest_paid","stc_cost":0.075,"estimated_usd_cost":0.075,"cost_source":"/v1/pricing/catalog","supported_rails":["subscription","x402","mpp"],"note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD."}},{"name":"selections_published_history","title":"Published STIM Select History","description":"Returns historical published STIM Select records filtered to the three-horizon confidence interval criteria and prob13wk threshold. Filter by symbol_exchange, symbol, exchange, or date range.","endpoint":"/v1/selections/published/history","method":"GET","category":"selections","input_schema":{"type":"object","properties":{"symbol_exchange":{"type":"string","description":"e.g. 'IBM-N'.","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"symbol":{"type":"string","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"exchange":{"type":"string","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"start":{"type":"string","description":"Start date YYYY-MM-DD.","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"end":{"type":"string","description":"End date YYYY-MM-DD.","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"min_prob13wk":{"type":"number","description":"Minimum prob13wk threshold (default 0.55).","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"}},"required":[],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"output_summary":"count, data[](weekdate, exchange, symbol, prob13wk, x4wk1, x13wk1, x40wk1, symbol_exchange).","analytical_role":"probabilistic_selection_list","interpretation_guidance":{"publication_criteria":{"x4wk1":{"operator":">","threshold_pct":0.0,"description":"4-week ST-IM lower CI bound must exceed base-period mean of 0%."},"x13wk1":{"operator":">","threshold_pct":2.19,"description":"13-week ST-IM lower CI bound must exceed base-period mean of 2.19%."},"x40wk1":{"operator":">","threshold_pct":6.45,"description":"40-week ST-IM lower CI bound must exceed base-period mean of 6.45%."},"prob13wk":{"operator":">=","threshold":0.55,"description":"Probability of exceeding 13-week base-period mean must be at least 55%."},"all_criteria_required":true},"interpretation_rules":["All four publication criteria must be satisfied simultaneously.","prob13wk >= 0.55 is the documented publication threshold.","Rank by prob13wk descending; higher prob13wk means stronger 13-week outperformance probability.","These are probabilistic candidates, not guaranteed outcomes — not investment advice.","Use /v1/stim/latest on individual symbols to see full distribution context."],"base_period_context_endpoint":"/v1/meta/stim"},"auth_required":true,"metered":true,"pricing_rule_id":"selections_published_history_paid","supported_rails":["subscription","x402","mpp"],"access_type":"paid","requires_payment":true,"input_location":"query","parameter_source":"query","parameters":[{"name":"symbol_exchange","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","description":"e.g. 'IBM-N'.","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"e.g. 'IBM-N'.","style":"form","explode":true},{"name":"symbol","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"style":"form","explode":true},{"name":"exchange","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"style":"form","explode":true},{"name":"start","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","description":"Start date YYYY-MM-DD.","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Start date YYYY-MM-DD.","style":"form","explode":true},{"name":"end","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","description":"End date YYYY-MM-DD.","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"End date YYYY-MM-DD.","style":"form","explode":true},{"name":"min_prob13wk","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"number","description":"Minimum prob13wk threshold (default 0.55).","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Minimum prob13wk threshold (default 0.55).","style":"form","explode":true}],"stc_cost":0.2,"estimated_usd_cost":0.2,"pricing_note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD.","pricing":{"pricing_rule_id":"selections_published_history_paid","stc_cost":0.2,"estimated_usd_cost":0.2,"cost_source":"/v1/pricing/catalog","supported_rails":["subscription","x402","mpp"],"note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD."}},{"name":"indicators_latest","title":"Indicators Latest","description":"Retrieve the latest weekly Stock Trends indicator row for one instrument. Lets an investment agent inspect current structural direction, trend persistence, trend maturity, relative performance, and volume context before deciding whether to request history, ST-IM distributions, or portfolio evaluation. Fetch /v1/pricing/catalog for current STC cost.","endpoint":"/v1/indicators/latest","method":"GET","category":"indicators","access_type":"paid","requires_payment":true,"input_location":"query","parameter_source":"query","input_schema":{"type":"object","properties":{"symbol_exchange":{"type":"string","pattern":"^[A-Z0-9.]+-[A-Z]$","description":"Stock Trends symbol plus exchange suffix.","example":"IBM-N","safe_default_for_demo":"IBM-N","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"symbol":{"type":"string","description":"Ticker symbol. Use with exchange when symbol_exchange is not supplied.","example":"IBM","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"exchange":{"type":"string","enum":["N","Q","A","B","T","I"],"description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","example":"N","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"cs_only":{"type":"boolean","description":"Filter to Common Stocks only where the endpoint supports instrument type filtering.","example":true,"default":true,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"}},"required":["symbol_exchange"],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query","description":"Provide symbol_exchange, or provide both symbol and exchange."},"output_summary":"Latest indicator snapshot with trend classification, trend_cnt, mt_cnt, rsi, rsi_updn, vol_tag, price-change fields, moving averages, and weekly high/low context.","workflow_role":"Single-symbol signal confirmation.","investment_agent_value":"Lets an investment agent inspect current structural direction, trend persistence, trend maturity, relative performance, and volume context before deciding whether to request history, ST-IM distributions, or portfolio evaluation.","required_inputs":{"symbol_exchange":{"type":"string","required":true,"example":"IBM-N","safe_default_for_demo":"IBM-N","pattern":"^[A-Z0-9.]+-[A-Z]$","description":"Stock Trends symbol plus exchange suffix.","input_location":"query","parameter_source":"query"}},"optional_inputs":{"symbol":{"type":"string","required":false,"example":"IBM","description":"Ticker symbol. Use with exchange when symbol_exchange is not supplied.","input_location":"query","parameter_source":"query"},"exchange":{"type":"string","required":false,"enum":["N","Q","A","B","T","I"],"example":"N","description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","input_location":"query","parameter_source":"query"},"cs_only":{"type":"boolean","required":false,"safe_default":true,"example":true,"description":"Filter to Common Stocks only where the endpoint supports instrument type filtering.","input_location":"query","parameter_source":"query"}},"safe_example_request":{"method":"GET","path":"/v1/indicators/latest","query":{"symbol_exchange":"IBM-N","cs_only":true}},"related_endpoints":["/v1/indicators/history","/v1/stim/latest","/v1/selections/history"],"next_recommended_calls":["/v1/indicators/history","/v1/stim/latest"],"analytical_role":"symbol_signal_intelligence","provenance_reference":{"historical_coverage_start_year":1980,"approximate_observation_count":"16M+","classification_framework":"Stock Trends trend classification methodology","semantic_continuity":"Stock Trends indicators use a consistent classification doctrine across decades of observations.","full_metadata_endpoints":["/v1/ai/context","/v1/meta/indicators","/v1/meta/stim"],"interpretation_limit":"Historical depth supports research and probabilistic interpretation but does not guarantee future performance."},"parameters":[{"name":"symbol_exchange","in":"query","input_location":"query","parameter_source":"query","required":true,"schema":{"type":"string","pattern":"^[A-Z0-9.]+-[A-Z]$","description":"Stock Trends symbol plus exchange suffix.","example":"IBM-N","safe_default_for_demo":"IBM-N","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Stock Trends symbol plus exchange suffix.","example":"IBM-N","style":"form","explode":true},{"name":"symbol","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","description":"Ticker symbol. Use with exchange when symbol_exchange is not supplied.","example":"IBM","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Ticker symbol. Use with exchange when symbol_exchange is not supplied.","example":"IBM","style":"form","explode":true},{"name":"exchange","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","enum":["N","Q","A","B","T","I"],"description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","example":"N","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","example":"N","style":"form","explode":true},{"name":"cs_only","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"boolean","description":"Filter to Common Stocks only where the endpoint supports instrument type filtering.","example":true,"default":true,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Filter to Common Stocks only where the endpoint supports instrument type filtering.","example":true,"style":"form","explode":true}],"auth_required":true,"metered":true,"pricing_rule_id":"indicators_latest_paid","supported_rails":["subscription","x402","mpp"],"stc_cost":0.0035,"estimated_usd_cost":0.0035,"pricing_note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD.","pricing":{"pricing_rule_id":"indicators_latest_paid","stc_cost":0.0035,"estimated_usd_cost":0.0035,"cost_source":"/v1/pricing/catalog","supported_rails":["subscription","x402","mpp"],"note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD."}},{"name":"indicators_history","title":"Indicators History","description":"Retrieve a bounded weekly history of Stock Trends indicator rows for one instrument. Helps an agent evaluate signal persistence, maturity changes, relative performance behavior, and volume context over time before paying for deeper ST-IM or portfolio workflow steps. Fetch /v1/pricing/catalog for current STC cost.","endpoint":"/v1/indicators/history","method":"GET","category":"indicators","access_type":"paid","requires_payment":true,"input_location":"query","parameter_source":"query","input_schema":{"type":"object","properties":{"symbol_exchange":{"type":"string","pattern":"^[A-Z0-9.]+-[A-Z]$","description":"Stock Trends symbol plus exchange suffix.","example":"IBM-N","safe_default_for_demo":"IBM-N","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"symbol":{"type":"string","description":"Ticker symbol. Use with exchange when symbol_exchange is not supplied.","example":"IBM","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"exchange":{"type":"string","enum":["N","Q","A","B","T","I"],"description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","example":"N","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"cs_only":{"type":"boolean","description":"Filter to Common Stocks only where the endpoint supports instrument type filtering.","example":true,"default":true,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"start":{"type":"string","format":"date","description":"Inclusive start weekdate in YYYY-MM-DD format.","example":"2025-01-03","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"end":{"type":"string","format":"date","description":"Inclusive end weekdate in YYYY-MM-DD format.","example":"2025-12-26","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"limit":{"type":"integer","minimum":1,"maximum":2600,"description":"Maximum number of rows returned.","example":260,"default":260,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"}},"required":["symbol_exchange"],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query","description":"Provide symbol_exchange, or provide both symbol and exchange."},"output_summary":"Weekly indicator history with trend classification, trend_cnt, mt_cnt, rsi, rsi_updn, vol_tag, price-change fields, moving averages, and high/low context.","workflow_role":"Historical signal context and trend persistence review.","investment_agent_value":"Helps an agent evaluate signal persistence, maturity changes, relative performance behavior, and volume context over time before paying for deeper ST-IM or portfolio workflow steps.","required_inputs":{"symbol_exchange":{"type":"string","required":true,"example":"IBM-N","safe_default_for_demo":"IBM-N","pattern":"^[A-Z0-9.]+-[A-Z]$","description":"Stock Trends symbol plus exchange suffix.","input_location":"query","parameter_source":"query"}},"optional_inputs":{"symbol":{"type":"string","required":false,"example":"IBM","description":"Ticker symbol. Use with exchange when symbol_exchange is not supplied.","input_location":"query","parameter_source":"query"},"exchange":{"type":"string","required":false,"enum":["N","Q","A","B","T","I"],"example":"N","description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","input_location":"query","parameter_source":"query"},"cs_only":{"type":"boolean","required":false,"safe_default":true,"example":true,"description":"Filter to Common Stocks only where the endpoint supports instrument type filtering.","input_location":"query","parameter_source":"query"},"start":{"type":"string","required":false,"format":"date","example":"2025-01-03","description":"Inclusive start weekdate in YYYY-MM-DD format.","input_location":"query","parameter_source":"query"},"end":{"type":"string","required":false,"format":"date","example":"2025-12-26","description":"Inclusive end weekdate in YYYY-MM-DD format.","input_location":"query","parameter_source":"query"},"limit":{"type":"integer","required":false,"safe_default":260,"minimum":1,"maximum":2600,"example":260,"description":"Maximum number of rows returned.","input_location":"query","parameter_source":"query"}},"safe_example_request":{"method":"GET","path":"/v1/indicators/history","query":{"symbol_exchange":"IBM-N","limit":52,"cs_only":true}},"related_endpoints":["/v1/indicators/latest","/v1/stim/history","/v1/prices/history"],"next_recommended_calls":["/v1/stim/history","/v1/decision/evaluate-symbol"],"analytical_role":"symbol_signal_intelligence","provenance_reference":{"historical_coverage_start_year":1980,"approximate_observation_count":"16M+","classification_framework":"Stock Trends trend classification methodology","semantic_continuity":"Stock Trends indicators use a consistent classification doctrine across decades of observations.","full_metadata_endpoints":["/v1/ai/context","/v1/meta/indicators","/v1/meta/stim"],"interpretation_limit":"Historical depth supports research and probabilistic interpretation but does not guarantee future performance."},"parameters":[{"name":"symbol_exchange","in":"query","input_location":"query","parameter_source":"query","required":true,"schema":{"type":"string","pattern":"^[A-Z0-9.]+-[A-Z]$","description":"Stock Trends symbol plus exchange suffix.","example":"IBM-N","safe_default_for_demo":"IBM-N","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Stock Trends symbol plus exchange suffix.","example":"IBM-N","style":"form","explode":true},{"name":"symbol","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","description":"Ticker symbol. Use with exchange when symbol_exchange is not supplied.","example":"IBM","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Ticker symbol. Use with exchange when symbol_exchange is not supplied.","example":"IBM","style":"form","explode":true},{"name":"exchange","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","enum":["N","Q","A","B","T","I"],"description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","example":"N","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","example":"N","style":"form","explode":true},{"name":"cs_only","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"boolean","description":"Filter to Common Stocks only where the endpoint supports instrument type filtering.","example":true,"default":true,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Filter to Common Stocks only where the endpoint supports instrument type filtering.","example":true,"style":"form","explode":true},{"name":"start","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","format":"date","description":"Inclusive start weekdate in YYYY-MM-DD format.","example":"2025-01-03","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Inclusive start weekdate in YYYY-MM-DD format.","example":"2025-01-03","style":"form","explode":true},{"name":"end","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","format":"date","description":"Inclusive end weekdate in YYYY-MM-DD format.","example":"2025-12-26","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Inclusive end weekdate in YYYY-MM-DD format.","example":"2025-12-26","style":"form","explode":true},{"name":"limit","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":2600,"description":"Maximum number of rows returned.","example":260,"default":260,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Maximum number of rows returned.","example":260,"style":"form","explode":true}],"auth_required":true,"metered":true,"pricing_rule_id":"indicators_history_paid","supported_rails":["subscription","x402","mpp"],"stc_cost":0.01,"estimated_usd_cost":0.01,"pricing_note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD.","pricing":{"pricing_rule_id":"indicators_history_paid","stc_cost":0.01,"estimated_usd_cost":0.01,"cost_source":"/v1/pricing/catalog","supported_rails":["subscription","x402","mpp"],"note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD."}},{"name":"prices_latest","title":"Prices Latest","description":"Retrieve latest weekly price context for one instrument. Provides price and volume context to pair with Stock Trends indicator and ST-IM signal analysis. Fetch /v1/pricing/catalog for current STC cost.","endpoint":"/v1/prices/latest","method":"GET","category":"prices","access_type":"paid","requires_payment":true,"input_location":"query","parameter_source":"query","input_schema":{"type":"object","properties":{"symbol_exchange":{"type":"string","pattern":"^[A-Z0-9.]+-[A-Z]$","description":"Stock Trends symbol plus exchange suffix.","example":"IBM-N","safe_default_for_demo":"IBM-N","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"symbol":{"type":"string","description":"Ticker symbol. Use with exchange when symbol_exchange is not supplied.","example":"IBM","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"exchange":{"type":"string","enum":["N","Q","A","B","T","I"],"description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","example":"N","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"cs_only":{"type":"boolean","description":"Filter to Common Stocks only where the endpoint supports instrument type filtering.","example":true,"default":true,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"}},"required":["symbol_exchange"],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query","description":"Provide symbol_exchange, or provide both symbol and exchange."},"output_summary":"Latest weekly price, adjusted close, high/low, volume (actual shares traded), trades, split factor, and price change.","workflow_role":"Price context enrichment.","investment_agent_value":"Provides price and volume context to pair with Stock Trends indicator and ST-IM signal analysis.","required_inputs":{"symbol_exchange":{"type":"string","required":true,"example":"IBM-N","safe_default_for_demo":"IBM-N","pattern":"^[A-Z0-9.]+-[A-Z]$","description":"Stock Trends symbol plus exchange suffix.","input_location":"query","parameter_source":"query"}},"optional_inputs":{"symbol":{"type":"string","required":false,"example":"IBM","description":"Ticker symbol. Use with exchange when symbol_exchange is not supplied.","input_location":"query","parameter_source":"query"},"exchange":{"type":"string","required":false,"enum":["N","Q","A","B","T","I"],"example":"N","description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","input_location":"query","parameter_source":"query"},"cs_only":{"type":"boolean","required":false,"safe_default":true,"example":true,"description":"Filter to Common Stocks only where the endpoint supports instrument type filtering.","input_location":"query","parameter_source":"query"}},"safe_example_request":{"method":"GET","path":"/v1/prices/latest","query":{"symbol_exchange":"IBM-N","cs_only":true}},"related_endpoints":["/v1/indicators/latest","/v1/prices/history"],"next_recommended_calls":["/v1/indicators/latest","/v1/stim/latest"],"analytical_role":"price_context","parameters":[{"name":"symbol_exchange","in":"query","input_location":"query","parameter_source":"query","required":true,"schema":{"type":"string","pattern":"^[A-Z0-9.]+-[A-Z]$","description":"Stock Trends symbol plus exchange suffix.","example":"IBM-N","safe_default_for_demo":"IBM-N","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Stock Trends symbol plus exchange suffix.","example":"IBM-N","style":"form","explode":true},{"name":"symbol","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","description":"Ticker symbol. Use with exchange when symbol_exchange is not supplied.","example":"IBM","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Ticker symbol. Use with exchange when symbol_exchange is not supplied.","example":"IBM","style":"form","explode":true},{"name":"exchange","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","enum":["N","Q","A","B","T","I"],"description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","example":"N","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","example":"N","style":"form","explode":true},{"name":"cs_only","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"boolean","description":"Filter to Common Stocks only where the endpoint supports instrument type filtering.","example":true,"default":true,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Filter to Common Stocks only where the endpoint supports instrument type filtering.","example":true,"style":"form","explode":true}],"auth_required":true,"metered":true,"pricing_rule_id":"prices_latest_paid","supported_rails":["subscription","x402","mpp"],"stc_cost":0.0025,"estimated_usd_cost":0.0025,"pricing_note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD.","pricing":{"pricing_rule_id":"prices_latest_paid","stc_cost":0.0025,"estimated_usd_cost":0.0025,"cost_source":"/v1/pricing/catalog","supported_rails":["subscription","x402","mpp"],"note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD."}},{"name":"prices_history","title":"Prices History","description":"Retrieve weekly price history for one instrument. Gives agents a bounded historical price context to interpret Stock Trends indicator changes. Fetch /v1/pricing/catalog for current STC cost.","endpoint":"/v1/prices/history","method":"GET","category":"prices","access_type":"paid","requires_payment":true,"input_location":"query","parameter_source":"query","input_schema":{"type":"object","properties":{"symbol_exchange":{"type":"string","pattern":"^[A-Z0-9.]+-[A-Z]$","description":"Stock Trends symbol plus exchange suffix.","example":"IBM-N","safe_default_for_demo":"IBM-N","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"symbol":{"type":"string","description":"Ticker symbol. Use with exchange when symbol_exchange is not supplied.","example":"IBM","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"exchange":{"type":"string","enum":["N","Q","A","B","T","I"],"description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","example":"N","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"cs_only":{"type":"boolean","description":"Filter to Common Stocks only where the endpoint supports instrument type filtering.","example":true,"default":true,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"start":{"type":"string","format":"date","description":"Inclusive start weekdate in YYYY-MM-DD format.","example":"2025-01-03","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"end":{"type":"string","format":"date","description":"Inclusive end weekdate in YYYY-MM-DD format.","example":"2025-12-26","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"limit":{"type":"integer","minimum":1,"maximum":2600,"description":"Maximum number of rows returned.","example":260,"default":260,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"}},"required":["symbol_exchange"],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query","description":"Provide symbol_exchange, or provide both symbol and exchange."},"output_summary":"Weekly price history for one symbol.","workflow_role":"Historical price context.","investment_agent_value":"Gives agents a bounded historical price context to interpret Stock Trends indicator changes.","required_inputs":{"symbol_exchange":{"type":"string","required":true,"example":"IBM-N","safe_default_for_demo":"IBM-N","pattern":"^[A-Z0-9.]+-[A-Z]$","description":"Stock Trends symbol plus exchange suffix.","input_location":"query","parameter_source":"query"}},"optional_inputs":{"symbol":{"type":"string","required":false,"example":"IBM","description":"Ticker symbol. Use with exchange when symbol_exchange is not supplied.","input_location":"query","parameter_source":"query"},"exchange":{"type":"string","required":false,"enum":["N","Q","A","B","T","I"],"example":"N","description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","input_location":"query","parameter_source":"query"},"cs_only":{"type":"boolean","required":false,"safe_default":true,"example":true,"description":"Filter to Common Stocks only where the endpoint supports instrument type filtering.","input_location":"query","parameter_source":"query"},"start":{"type":"string","required":false,"format":"date","example":"2025-01-03","description":"Inclusive start weekdate in YYYY-MM-DD format.","input_location":"query","parameter_source":"query"},"end":{"type":"string","required":false,"format":"date","example":"2025-12-26","description":"Inclusive end weekdate in YYYY-MM-DD format.","input_location":"query","parameter_source":"query"},"limit":{"type":"integer","required":false,"safe_default":260,"minimum":1,"maximum":2600,"example":260,"description":"Maximum number of rows returned.","input_location":"query","parameter_source":"query"}},"safe_example_request":{"method":"GET","path":"/v1/prices/history","query":{"symbol_exchange":"IBM-N","limit":52,"cs_only":true}},"related_endpoints":["/v1/prices/latest","/v1/indicators/history"],"next_recommended_calls":["/v1/indicators/history"],"analytical_role":"price_context","parameters":[{"name":"symbol_exchange","in":"query","input_location":"query","parameter_source":"query","required":true,"schema":{"type":"string","pattern":"^[A-Z0-9.]+-[A-Z]$","description":"Stock Trends symbol plus exchange suffix.","example":"IBM-N","safe_default_for_demo":"IBM-N","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Stock Trends symbol plus exchange suffix.","example":"IBM-N","style":"form","explode":true},{"name":"symbol","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","description":"Ticker symbol. Use with exchange when symbol_exchange is not supplied.","example":"IBM","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Ticker symbol. Use with exchange when symbol_exchange is not supplied.","example":"IBM","style":"form","explode":true},{"name":"exchange","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","enum":["N","Q","A","B","T","I"],"description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","example":"N","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","example":"N","style":"form","explode":true},{"name":"cs_only","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"boolean","description":"Filter to Common Stocks only where the endpoint supports instrument type filtering.","example":true,"default":true,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Filter to Common Stocks only where the endpoint supports instrument type filtering.","example":true,"style":"form","explode":true},{"name":"start","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","format":"date","description":"Inclusive start weekdate in YYYY-MM-DD format.","example":"2025-01-03","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Inclusive start weekdate in YYYY-MM-DD format.","example":"2025-01-03","style":"form","explode":true},{"name":"end","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","format":"date","description":"Inclusive end weekdate in YYYY-MM-DD format.","example":"2025-12-26","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Inclusive end weekdate in YYYY-MM-DD format.","example":"2025-12-26","style":"form","explode":true},{"name":"limit","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":2600,"description":"Maximum number of rows returned.","example":260,"default":260,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Maximum number of rows returned.","example":260,"style":"form","explode":true}],"auth_required":true,"metered":true,"pricing_rule_id":"prices_history_paid","supported_rails":["subscription","x402","mpp"],"stc_cost":0.0075,"estimated_usd_cost":0.0075,"pricing_note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD.","pricing":{"pricing_rule_id":"prices_history_paid","stc_cost":0.0075,"estimated_usd_cost":0.0075,"cost_source":"/v1/pricing/catalog","supported_rails":["subscription","x402","mpp"],"note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD."}},{"name":"stim_select_outcomes_summary","title":"ST-IM Select Outcomes Summary","description":"Summarize mature historical outcomes for the ST-IM Select signal-selection rule. Gives agents public evidence about historical ST-IM Select signal outcomes before paying for current selection lists or symbol-level inference. Fetch /v1/pricing/catalog for current STC cost.","endpoint":"/v1/selections/stim-select/outcomes/summary","method":"GET","category":"selections","access_type":"free","requires_payment":false,"input_location":"query","parameter_source":"query","input_schema":{"type":"object","properties":{"start_date":{"type":"string","format":"date","description":"Inclusive signal weekdate filter in YYYY-MM-DD format. If both date filters are omitted, the persistent summary table's trailing 10-year default window is applied.","example":"2020-01-03","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"end_date":{"type":"string","format":"date","description":"Inclusive signal weekdate filter in YYYY-MM-DD format. If both date filters are omitted, the persistent summary table row defines the latest mature outcome date.","example":"2024-12-27","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"exchange":{"type":"string","enum":["N","Q","A","B","T"],"description":"Optional exchange filter.","example":"N","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"limit_rank":{"type":"integer","minimum":1,"maximum":5000,"description":"Optional per-week rank cutoff by prob13wk descending. When start_date and end_date are omitted, seeded default summary rows support limit_rank omitted/null and limit_rank=10; other no-date limit_rank values require explicit date filters or a custom summary refresh.","example":10,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"}},"required":[],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"output_summary":"Aggregate historical count, date range, realized return averages/medians, positive-return rates, and base-period outperformance rates for ST-IM Select signal observations.","workflow_role":"Public signal outcome evidence.","investment_agent_value":"Gives agents public evidence about historical ST-IM Select signal outcomes before paying for current selection lists or symbol-level inference.","required_inputs":{},"optional_inputs":{"start_date":{"type":"string","required":false,"format":"date","example":"2020-01-03","description":"Inclusive signal weekdate filter in YYYY-MM-DD format. If both date filters are omitted, the persistent summary table's trailing 10-year default window is applied.","input_location":"query","parameter_source":"query"},"end_date":{"type":"string","required":false,"format":"date","example":"2024-12-27","description":"Inclusive signal weekdate filter in YYYY-MM-DD format. If both date filters are omitted, the persistent summary table row defines the latest mature outcome date.","input_location":"query","parameter_source":"query"},"exchange":{"type":"string","required":false,"enum":["N","Q","A","B","T"],"example":"N","description":"Optional exchange filter.","input_location":"query","parameter_source":"query"},"limit_rank":{"type":"integer","required":false,"minimum":1,"maximum":5000,"example":10,"description":"Optional per-week rank cutoff by prob13wk descending. When start_date and end_date are omitted, seeded default summary rows support limit_rank omitted/null and limit_rank=10; other no-date limit_rank values require explicit date filters or a custom summary refresh.","input_location":"query","parameter_source":"query"}},"safe_example_request":{"method":"GET","path":"/v1/selections/stim-select/outcomes/summary","query":{"limit_rank":10}},"related_endpoints":["/v1/meta/stim","/v1/stim/latest","/v1/selections/history","/v1/selections/published/history"],"next_recommended_calls":["/v1/meta/stim","/v1/selections/published/latest"],"analytical_role":"probabilistic_signal_outcome_evidence","interpretation_guidance":{"signal_criteria":{"x4wk1":{"operator":">","threshold_pct":0.0,"description":"4-week ST-IM lower CI bound must exceed base-period mean of 0%."},"x13wk1":{"operator":">","threshold_pct":2.19,"description":"13-week ST-IM lower CI bound must exceed base-period mean of 2.19%."},"x40wk1":{"operator":">","threshold_pct":6.45,"description":"40-week ST-IM lower CI bound must exceed base-period mean of 6.45%."},"price":{"operator":">=","threshold":2.0,"description":"Signal observation price must be at least 2."},"volume":{"operator":">","threshold":100000,"description":"Signal observation weekly trading volume must exceed 100,000 actual shares traded."},"ranking":"prob13wk descending","all_criteria_required":true},"outcome_measurement":{"realized_return_field":"fpr_chg13","realized_return_fields":["fpr_chg4","fpr_chg13","fpr_chg40"],"horizon":"13 weeks","horizons":["4 weeks","13 weeks","40 weeks"],"mature_outcomes_only":true,"base_period_mean_4wk":0.0,"base_period_mean_13wk":2.19,"base_period_mean_40wk":6.45},"business_boundary":{"aggregate_only":true,"published_report_limited":false,"current_live_selections_excluded":true,"individual_symbols_excluded":true},"summary_table_behavior":{"default_no_date_window_reads_summary_table":true,"summary_table":"stweekly.stim_select_outcome_summary","refresh_command":"python -m maintenance.refresh_stim_select_outcome_summary_cache","supported_default_rows":[{"exchange":null,"limit_rank":null},{"exchange":null,"limit_rank":10}],"explicit_date_windows_may_compute_live":true},"base_period_context_endpoint":"/v1/meta/stim"},"inference_contract":{"endpoint":"/v1/meta/inference","provider_agnostic":true,"core_concepts":["inference_provider","forecast_horizon","probability_distribution","confidence_measure","evidence","uncertainty","explanation","signal_source","reasoning_interpretation"]},"inference_provider":{"provider_id":"stim","provider_name":"Stock Trends Inference Model","provider_role":"current_baseline_inference_provider","provider_profile_endpoint":"/v1/meta/stim","not_final_intelligence_layer":true,"future_causal_ai_compatible":true},"cognition_architecture":"docs/STOCK_TRENDS_COGNITION_ARCHITECTURE.md","provenance_reference":{"historical_coverage_start_year":1980,"approximate_observation_count":"16M+","classification_framework":"Stock Trends trend classification methodology","semantic_continuity":"Stock Trends indicators use a consistent classification doctrine across decades of observations.","full_metadata_endpoints":["/v1/ai/context","/v1/meta/indicators","/v1/meta/stim"],"interpretation_limit":"Historical depth supports research and probabilistic interpretation but does not guarantee future performance."},"parameters":[{"name":"start_date","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","format":"date","description":"Inclusive signal weekdate filter in YYYY-MM-DD format. If both date filters are omitted, the persistent summary table's trailing 10-year default window is applied.","example":"2020-01-03","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Inclusive signal weekdate filter in YYYY-MM-DD format. If both date filters are omitted, the persistent summary table's trailing 10-year default window is applied.","example":"2020-01-03","style":"form","explode":true},{"name":"end_date","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","format":"date","description":"Inclusive signal weekdate filter in YYYY-MM-DD format. If both date filters are omitted, the persistent summary table row defines the latest mature outcome date.","example":"2024-12-27","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Inclusive signal weekdate filter in YYYY-MM-DD format. If both date filters are omitted, the persistent summary table row defines the latest mature outcome date.","example":"2024-12-27","style":"form","explode":true},{"name":"exchange","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","enum":["N","Q","A","B","T"],"description":"Optional exchange filter.","example":"N","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Optional exchange filter.","example":"N","style":"form","explode":true},{"name":"limit_rank","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":5000,"description":"Optional per-week rank cutoff by prob13wk descending. When start_date and end_date are omitted, seeded default summary rows support limit_rank omitted/null and limit_rank=10; other no-date limit_rank values require explicit date filters or a custom summary refresh.","example":10,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Optional per-week rank cutoff by prob13wk descending. When start_date and end_date are omitted, seeded default summary rows support limit_rank omitted/null and limit_rank=10; other no-date limit_rank values require explicit date filters or a custom summary refresh.","example":10,"style":"form","explode":true}],"auth_required":false,"metered":false,"pricing_rule_id":null,"supported_rails":[],"stc_cost":null,"estimated_usd_cost":null,"pricing_note":"No paid STC price applies to this discovery entry.","pricing":{"pricing_rule_id":null,"stc_cost":null,"estimated_usd_cost":null,"cost_source":"/v1/pricing/catalog","supported_rails":[],"note":"No paid STC price applies to this discovery entry."}},{"name":"stwr_reports_latest","title":"STWR Reports Latest","description":"Retrieve the latest named STWR screening report. Provides curated Stock Trends screening lists for agent research workflows. Fetch /v1/pricing/catalog for current STC cost.","endpoint":"/v1/stwr/reports/latest","method":"GET","category":"stwr","access_type":"paid","requires_payment":true,"input_location":"query","parameter_source":"query","input_schema":{"type":"object","properties":{"rpt":{"type":"string","description":"Report code from /v1/stwr/reports/catalog.","example":"bullcross","safe_default_for_demo":"bullcross","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"exchange":{"type":"string","enum":["N","Q","A","B","T","I"],"description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","example":"N","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"weekdate":{"type":"string","format":"date","description":"Inclusive end weekdate in YYYY-MM-DD format.","example":"2025-12-26","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"include_mast":{"type":"boolean","default":false,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"limit":{"type":"integer","minimum":1,"maximum":50000,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"}},"required":["rpt"],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"output_summary":"Latest named STWR report rows.","workflow_role":"Curated report discovery.","investment_agent_value":"Provides curated Stock Trends screening lists for agent research workflows.","required_inputs":{"rpt":{"type":"string","required":true,"example":"bullcross","safe_default_for_demo":"bullcross","description":"Report code from /v1/stwr/reports/catalog.","input_location":"query","parameter_source":"query"},"exchange":{"type":"string","required":false,"enum":["N","Q","A","B","T","I"],"example":"N","description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","input_location":"query","parameter_source":"query"}},"optional_inputs":{"weekdate":{"type":"string","required":false,"format":"date","example":"2025-12-26","description":"Inclusive end weekdate in YYYY-MM-DD format.","input_location":"query","parameter_source":"query"},"include_mast":{"type":"boolean","required":false,"safe_default":false,"input_location":"query","parameter_source":"query"},"limit":{"type":"integer","required":false,"minimum":1,"maximum":50000,"input_location":"query","parameter_source":"query"}},"safe_example_request":{"method":"GET","path":"/v1/stwr/reports/latest","query":{"rpt":"bullcross","exchange":"N","limit":25}},"related_endpoints":["/v1/stwr/reports/catalog","/v1/stwr/reports/history"],"next_recommended_calls":["/v1/indicators/latest","/v1/stim/latest"],"analytical_role":"curated_signal_report","parameters":[{"name":"rpt","in":"query","input_location":"query","parameter_source":"query","required":true,"schema":{"type":"string","description":"Report code from /v1/stwr/reports/catalog.","example":"bullcross","safe_default_for_demo":"bullcross","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Report code from /v1/stwr/reports/catalog.","example":"bullcross","style":"form","explode":true},{"name":"exchange","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","enum":["N","Q","A","B","T","I"],"description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","example":"N","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","example":"N","style":"form","explode":true},{"name":"weekdate","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","format":"date","description":"Inclusive end weekdate in YYYY-MM-DD format.","example":"2025-12-26","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Inclusive end weekdate in YYYY-MM-DD format.","example":"2025-12-26","style":"form","explode":true},{"name":"include_mast","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"boolean","default":false,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"style":"form","explode":true},{"name":"limit","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50000,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"style":"form","explode":true}],"auth_required":true,"metered":true,"pricing_rule_id":"stwr_reports_latest_paid","supported_rails":["subscription","x402","mpp"],"stc_cost":0.15,"estimated_usd_cost":0.15,"pricing_note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD.","pricing":{"pricing_rule_id":"stwr_reports_latest_paid","stc_cost":0.15,"estimated_usd_cost":0.15,"cost_source":"/v1/pricing/catalog","supported_rails":["subscription","x402","mpp"],"note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD."}},{"name":"stwr_reports_history","title":"STWR Reports History","description":"Retrieve historical rows for a named STWR report. Lets agents study persistence and recurrence of curated report membership over time. Fetch /v1/pricing/catalog for current STC cost.","endpoint":"/v1/stwr/reports/history","method":"GET","category":"stwr","access_type":"paid","requires_payment":true,"input_location":"query","parameter_source":"query","input_schema":{"type":"object","properties":{"rpt":{"type":"string","description":"Report code from /v1/stwr/reports/catalog.","example":"bullcross","safe_default_for_demo":"bullcross","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"exchange":{"type":"string","enum":["N","Q","A","B","T","I"],"description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","example":"N","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"start":{"type":"string","format":"date","description":"Inclusive start weekdate in YYYY-MM-DD format.","example":"2025-01-03","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"end":{"type":"string","format":"date","description":"Inclusive end weekdate in YYYY-MM-DD format.","example":"2025-12-26","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"group_by_week":{"type":"boolean","default":true,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"include_mast":{"type":"boolean","default":false,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"limit":{"type":"integer","minimum":1,"maximum":500000,"default":200000,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"}},"required":["rpt"],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"output_summary":"Historical STWR report rows, grouped by week by default.","workflow_role":"Curated report history.","investment_agent_value":"Lets agents study persistence and recurrence of curated report membership over time.","required_inputs":{"rpt":{"type":"string","required":true,"example":"bullcross","safe_default_for_demo":"bullcross","description":"Report code from /v1/stwr/reports/catalog.","input_location":"query","parameter_source":"query"},"exchange":{"type":"string","required":false,"enum":["N","Q","A","B","T","I"],"example":"N","description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","input_location":"query","parameter_source":"query"}},"optional_inputs":{"start":{"type":"string","required":false,"format":"date","example":"2025-01-03","description":"Inclusive start weekdate in YYYY-MM-DD format.","input_location":"query","parameter_source":"query"},"end":{"type":"string","required":false,"format":"date","example":"2025-12-26","description":"Inclusive end weekdate in YYYY-MM-DD format.","input_location":"query","parameter_source":"query"},"group_by_week":{"type":"boolean","required":false,"safe_default":true,"input_location":"query","parameter_source":"query"},"include_mast":{"type":"boolean","required":false,"safe_default":false,"input_location":"query","parameter_source":"query"},"limit":{"type":"integer","required":false,"safe_default":200000,"minimum":1,"maximum":500000,"input_location":"query","parameter_source":"query"}},"safe_example_request":{"method":"GET","path":"/v1/stwr/reports/history","query":{"rpt":"bullcross","exchange":"N","limit":500}},"related_endpoints":["/v1/stwr/reports/latest","/v1/indicators/history"],"next_recommended_calls":["/v1/indicators/history"],"analytical_role":"curated_signal_report","parameters":[{"name":"rpt","in":"query","input_location":"query","parameter_source":"query","required":true,"schema":{"type":"string","description":"Report code from /v1/stwr/reports/catalog.","example":"bullcross","safe_default_for_demo":"bullcross","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Report code from /v1/stwr/reports/catalog.","example":"bullcross","style":"form","explode":true},{"name":"exchange","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","enum":["N","Q","A","B","T","I"],"description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","example":"N","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","example":"N","style":"form","explode":true},{"name":"start","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","format":"date","description":"Inclusive start weekdate in YYYY-MM-DD format.","example":"2025-01-03","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Inclusive start weekdate in YYYY-MM-DD format.","example":"2025-01-03","style":"form","explode":true},{"name":"end","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","format":"date","description":"Inclusive end weekdate in YYYY-MM-DD format.","example":"2025-12-26","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Inclusive end weekdate in YYYY-MM-DD format.","example":"2025-12-26","style":"form","explode":true},{"name":"group_by_week","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"boolean","default":true,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"style":"form","explode":true},{"name":"include_mast","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"boolean","default":false,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"style":"form","explode":true},{"name":"limit","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500000,"default":200000,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"style":"form","explode":true}],"auth_required":true,"metered":true,"pricing_rule_id":"stwr_reports_history_paid","supported_rails":["subscription","x402","mpp"],"stc_cost":0.5,"estimated_usd_cost":0.5,"pricing_note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD.","pricing":{"pricing_rule_id":"stwr_reports_history_paid","stc_cost":0.5,"estimated_usd_cost":0.5,"cost_source":"/v1/pricing/catalog","supported_rails":["subscription","x402","mpp"],"note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD."}},{"name":"breadth_sector_latest","title":"Sector Breadth Latest","description":"Retrieve the latest breadth context across sector or industry groupings. Helps agents identify current market participation, sector strength, and breadth concentration before symbol-level calls. Fetch /v1/pricing/catalog for current STC cost.","endpoint":"/v1/breadth/sector/latest","method":"GET","category":"breadth","access_type":"paid","requires_payment":true,"input_location":"query","parameter_source":"query","input_schema":{"type":"object","properties":{"group_level":{"type":"string","enum":["sector","industry_group","industry"],"default":"sector","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"exchange":{"type":"string","enum":["N","Q","A","B","T","I"],"description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","example":"N","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"weekdate":{"type":"string","format":"date","description":"Override weekdate in YYYY-MM-DD format; defaults to the latest available week.","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"cs_only":{"type":"boolean","description":"Filter to Common Stocks only where the endpoint supports instrument type filtering.","example":true,"default":true,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"include_unknown":{"type":"boolean","default":false,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"min_price":{"type":"number","minimum":0,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"min_volume":{"type":"integer","minimum":0,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"vol_scale":{"type":"integer","minimum":1,"default":100,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"limit":{"type":"integer","minimum":1,"maximum":50000,"default":5000,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"}},"required":[],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"output_summary":"Latest breadth groups and current signal distribution metrics.","workflow_role":"Current market breadth context.","investment_agent_value":"Helps agents identify current market participation, sector strength, and breadth concentration before symbol-level calls.","required_inputs":{},"optional_inputs":{"group_level":{"type":"string","required":false,"enum":["sector","industry_group","industry"],"safe_default":"sector","input_location":"query","parameter_source":"query"},"exchange":{"type":"string","required":false,"enum":["N","Q","A","B","T","I"],"example":"N","description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","input_location":"query","parameter_source":"query"},"weekdate":{"type":"string","required":false,"format":"date","description":"Override weekdate in YYYY-MM-DD format; defaults to the latest available week.","input_location":"query","parameter_source":"query"},"cs_only":{"type":"boolean","required":false,"safe_default":true,"example":true,"description":"Filter to Common Stocks only where the endpoint supports instrument type filtering.","input_location":"query","parameter_source":"query"},"include_unknown":{"type":"boolean","required":false,"safe_default":false,"input_location":"query","parameter_source":"query"},"min_price":{"type":"number","required":false,"minimum":0,"input_location":"query","parameter_source":"query"},"min_volume":{"type":"integer","required":false,"minimum":0,"input_location":"query","parameter_source":"query"},"vol_scale":{"type":"integer","required":false,"safe_default":100,"minimum":1,"input_location":"query","parameter_source":"query"},"limit":{"type":"integer","required":false,"safe_default":5000,"minimum":1,"maximum":50000,"input_location":"query","parameter_source":"query"}},"safe_example_request":{"method":"GET","path":"/v1/breadth/sector/latest","query":{"group_level":"sector","limit":5000}},"related_endpoints":["/v1/breadth/sector/history","/v1/market/regime/latest"],"next_recommended_calls":["/v1/market/regime/latest","/v1/leadership/summary/latest"],"analytical_role":"market_breadth_context","provenance_reference":{"historical_coverage_start_year":1980,"approximate_observation_count":"16M+","classification_framework":"Stock Trends trend classification methodology","semantic_continuity":"Stock Trends indicators use a consistent classification doctrine across decades of observations.","full_metadata_endpoints":["/v1/ai/context","/v1/meta/indicators","/v1/meta/stim"],"interpretation_limit":"Historical depth supports research and probabilistic interpretation but does not guarantee future performance."},"parameters":[{"name":"group_level","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","enum":["sector","industry_group","industry"],"default":"sector","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"style":"form","explode":true},{"name":"exchange","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","enum":["N","Q","A","B","T","I"],"description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","example":"N","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","example":"N","style":"form","explode":true},{"name":"weekdate","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","format":"date","description":"Override weekdate in YYYY-MM-DD format; defaults to the latest available week.","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Override weekdate in YYYY-MM-DD format; defaults to the latest available week.","style":"form","explode":true},{"name":"cs_only","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"boolean","description":"Filter to Common Stocks only where the endpoint supports instrument type filtering.","example":true,"default":true,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Filter to Common Stocks only where the endpoint supports instrument type filtering.","example":true,"style":"form","explode":true},{"name":"include_unknown","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"boolean","default":false,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"style":"form","explode":true},{"name":"min_price","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"number","minimum":0,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"style":"form","explode":true},{"name":"min_volume","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"integer","minimum":0,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"style":"form","explode":true},{"name":"vol_scale","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"integer","minimum":1,"default":100,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"style":"form","explode":true},{"name":"limit","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50000,"default":5000,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"style":"form","explode":true}],"auth_required":true,"metered":true,"pricing_rule_id":"breadth_sector_latest_paid","supported_rails":["subscription","x402","mpp"],"stc_cost":0.1,"estimated_usd_cost":0.1,"pricing_note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD.","pricing":{"pricing_rule_id":"breadth_sector_latest_paid","stc_cost":0.1,"estimated_usd_cost":0.1,"cost_source":"/v1/pricing/catalog","supported_rails":["subscription","x402","mpp"],"note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD."}},{"name":"breadth_sector_history","title":"Sector Breadth History","description":"Retrieve historical breadth context across sector or industry groupings. Helps agents identify whether leadership and breadth are broadening or narrowing over time. Fetch /v1/pricing/catalog for current STC cost.","endpoint":"/v1/breadth/sector/history","method":"GET","category":"breadth","access_type":"paid","requires_payment":true,"input_location":"query","parameter_source":"query","input_schema":{"type":"object","properties":{"group_level":{"type":"string","enum":["sector","industry_group","industry"],"default":"sector","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"exchange":{"type":"string","enum":["N","Q","A","B","T","I"],"description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","example":"N","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"start":{"type":"string","format":"date","description":"Inclusive start weekdate in YYYY-MM-DD format.","example":"2025-01-03","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"end":{"type":"string","format":"date","description":"Inclusive end weekdate in YYYY-MM-DD format.","example":"2025-12-26","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"group_by_week":{"type":"boolean","default":true,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"cs_only":{"type":"boolean","description":"Filter to Common Stocks only where the endpoint supports instrument type filtering.","example":true,"default":true,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"include_unknown":{"type":"boolean","default":false,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"limit":{"type":"integer","minimum":1,"maximum":500000,"default":200000,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"}},"required":[],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"output_summary":"Historical breadth groups and weekly signal distribution metrics.","workflow_role":"Market breadth context.","investment_agent_value":"Helps agents identify whether leadership and breadth are broadening or narrowing over time.","required_inputs":{},"optional_inputs":{"group_level":{"type":"string","required":false,"enum":["sector","industry_group","industry"],"safe_default":"sector","input_location":"query","parameter_source":"query"},"exchange":{"type":"string","required":false,"enum":["N","Q","A","B","T","I"],"example":"N","description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","input_location":"query","parameter_source":"query"},"start":{"type":"string","required":false,"format":"date","example":"2025-01-03","description":"Inclusive start weekdate in YYYY-MM-DD format.","input_location":"query","parameter_source":"query"},"end":{"type":"string","required":false,"format":"date","example":"2025-12-26","description":"Inclusive end weekdate in YYYY-MM-DD format.","input_location":"query","parameter_source":"query"},"group_by_week":{"type":"boolean","required":false,"safe_default":true,"input_location":"query","parameter_source":"query"},"cs_only":{"type":"boolean","required":false,"safe_default":true,"example":true,"description":"Filter to Common Stocks only where the endpoint supports instrument type filtering.","input_location":"query","parameter_source":"query"},"include_unknown":{"type":"boolean","required":false,"safe_default":false,"input_location":"query","parameter_source":"query"},"limit":{"type":"integer","required":false,"safe_default":200000,"minimum":1,"maximum":500000,"input_location":"query","parameter_source":"query"}},"safe_example_request":{"method":"GET","path":"/v1/breadth/sector/history","query":{"group_level":"sector","group_by_week":true,"limit":5000}},"related_endpoints":["/v1/breadth/sector/latest","/v1/market/regime/history"],"next_recommended_calls":["/v1/market/regime/latest","/v1/leadership/summary/latest"],"analytical_role":"market_breadth_context","provenance_reference":{"historical_coverage_start_year":1980,"approximate_observation_count":"16M+","classification_framework":"Stock Trends trend classification methodology","semantic_continuity":"Stock Trends indicators use a consistent classification doctrine across decades of observations.","full_metadata_endpoints":["/v1/ai/context","/v1/meta/indicators","/v1/meta/stim"],"interpretation_limit":"Historical depth supports research and probabilistic interpretation but does not guarantee future performance."},"parameters":[{"name":"group_level","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","enum":["sector","industry_group","industry"],"default":"sector","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"style":"form","explode":true},{"name":"exchange","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","enum":["N","Q","A","B","T","I"],"description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","example":"N","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","example":"N","style":"form","explode":true},{"name":"start","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","format":"date","description":"Inclusive start weekdate in YYYY-MM-DD format.","example":"2025-01-03","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Inclusive start weekdate in YYYY-MM-DD format.","example":"2025-01-03","style":"form","explode":true},{"name":"end","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","format":"date","description":"Inclusive end weekdate in YYYY-MM-DD format.","example":"2025-12-26","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Inclusive end weekdate in YYYY-MM-DD format.","example":"2025-12-26","style":"form","explode":true},{"name":"group_by_week","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"boolean","default":true,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"style":"form","explode":true},{"name":"cs_only","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"boolean","description":"Filter to Common Stocks only where the endpoint supports instrument type filtering.","example":true,"default":true,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Filter to Common Stocks only where the endpoint supports instrument type filtering.","example":true,"style":"form","explode":true},{"name":"include_unknown","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"boolean","default":false,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"style":"form","explode":true},{"name":"limit","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500000,"default":200000,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"style":"form","explode":true}],"auth_required":true,"metered":true,"pricing_rule_id":"breadth_sector_history_paid","supported_rails":["subscription","x402","mpp"],"stc_cost":0.3,"estimated_usd_cost":0.3,"pricing_note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD.","pricing":{"pricing_rule_id":"breadth_sector_history_paid","stc_cost":0.3,"estimated_usd_cost":0.3,"cost_source":"/v1/pricing/catalog","supported_rails":["subscription","x402","mpp"],"note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD."}},{"name":"leadership_definitions","title":"Leadership Definitions","description":"Understand leadership screen definitions and ranking fields before paid leadership calls. Lets agents plan leadership workflows without paying or exposing live leadership data. Fetch /v1/pricing/catalog for current STC cost.","endpoint":"/v1/leadership/definitions","method":"GET","category":"planning_helper","access_type":"free","requires_payment":false,"input_location":"query","parameter_source":"query","input_schema":{"type":"object","properties":{},"required":[],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query","description":"No query parameters are required for this endpoint."},"output_summary":"Leadership definitions, indicator meanings, taxonomy levels, and ranking notes.","workflow_role":"Leadership planning metadata.","investment_agent_value":"Lets agents plan leadership workflows without paying or exposing live leadership data.","required_inputs":{},"optional_inputs":{},"safe_example_request":{"method":"GET","path":"/v1/leadership/definitions","query":{}},"related_endpoints":["/v1/leadership/summary/latest","/v1/leadership/rotation/history"],"next_recommended_calls":["/v1/leadership/summary/latest"],"provenance_reference":{"historical_coverage_start_year":1980,"approximate_observation_count":"16M+","classification_framework":"Stock Trends trend classification methodology","semantic_continuity":"Stock Trends indicators use a consistent classification doctrine across decades of observations.","full_metadata_endpoints":["/v1/ai/context","/v1/meta/indicators","/v1/meta/stim"],"interpretation_limit":"Historical depth supports research and probabilistic interpretation but does not guarantee future performance."},"parameters":[],"auth_required":false,"metered":false,"pricing_rule_id":null,"supported_rails":[],"stc_cost":null,"estimated_usd_cost":null,"pricing_note":"No paid STC price applies to this discovery entry.","pricing":{"pricing_rule_id":null,"stc_cost":null,"estimated_usd_cost":null,"cost_source":"/v1/pricing/catalog","supported_rails":[],"note":"No paid STC price applies to this discovery entry."}},{"name":"leadership_summary_latest","title":"Leadership Summary Latest","description":"Retrieve the latest Stock Trends leadership summary across sectors and industry groups. Helps agents identify where relative performance and bullish Stock Trends alignment are concentrated before combining leadership context with breadth, regime, or symbol workflows. Fetch /v1/pricing/catalog for current STC cost.","endpoint":"/v1/leadership/summary/latest","method":"GET","category":"leadership","access_type":"paid","requires_payment":true,"input_location":"query","parameter_source":"query","input_schema":{"type":"object","properties":{"exchange":{"type":"string","enum":["N","Q","A","B","T","I"],"description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","example":"N","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"weekdate":{"type":"string","format":"date","description":"Inclusive end weekdate in YYYY-MM-DD format.","example":"2025-12-26","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"type":{"type":"string","description":"Instrument type filter. CS is the safe default for common-stock leadership scans.","example":"CS","default":"CS","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"min_rsi":{"type":"integer","minimum":0,"maximum":500,"description":"Minimum Stock Trends RSI threshold. RSI baseline is 100.","example":40,"default":40,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"min_mt_cnt":{"type":"integer","minimum":0,"maximum":500,"description":"Minimum trend-category maturity filter.","example":4,"default":4,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"limit_overall":{"type":"integer","minimum":1,"maximum":1000,"example":50,"default":50,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"limit_bucket":{"type":"integer","minimum":1,"maximum":200,"example":20,"default":20,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"}},"required":[],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"output_summary":"Latest leadership groups with overall, sector, and industry-group leaders ranked by Stock Trends RSI and trend-category maturity filters.","workflow_role":"Leadership context enrichment.","investment_agent_value":"Helps agents identify where relative performance and bullish Stock Trends alignment are concentrated before combining leadership context with breadth, regime, or symbol workflows.","required_inputs":{},"optional_inputs":{"exchange":{"type":"string","required":false,"enum":["N","Q","A","B","T","I"],"example":"N","description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","input_location":"query","parameter_source":"query"},"weekdate":{"type":"string","required":false,"format":"date","example":"2025-12-26","description":"Inclusive end weekdate in YYYY-MM-DD format.","input_location":"query","parameter_source":"query"},"type":{"type":"string","required":false,"safe_default":"CS","example":"CS","description":"Instrument type filter. CS is the safe default for common-stock leadership scans.","input_location":"query","parameter_source":"query"},"min_rsi":{"type":"integer","required":false,"safe_default":40,"minimum":0,"maximum":500,"example":40,"description":"Minimum Stock Trends RSI threshold. RSI baseline is 100.","input_location":"query","parameter_source":"query"},"min_mt_cnt":{"type":"integer","required":false,"safe_default":4,"minimum":0,"maximum":500,"example":4,"description":"Minimum trend-category maturity filter.","input_location":"query","parameter_source":"query"},"limit_overall":{"type":"integer","required":false,"safe_default":50,"minimum":1,"maximum":1000,"example":50,"input_location":"query","parameter_source":"query"},"limit_bucket":{"type":"integer","required":false,"safe_default":20,"minimum":1,"maximum":200,"example":20,"input_location":"query","parameter_source":"query"}},"safe_example_request":{"method":"GET","path":"/v1/leadership/summary/latest","query":{"exchange":"N","type":"CS","min_rsi":40,"min_mt_cnt":4}},"related_endpoints":["/v1/breadth/sector/latest","/v1/market/regime/latest","/v1/leadership/rotation/history"],"next_recommended_calls":["/v1/market/regime/latest","/v1/indicators/latest"],"analytical_role":"leadership_intelligence","provenance_reference":{"historical_coverage_start_year":1980,"approximate_observation_count":"16M+","classification_framework":"Stock Trends trend classification methodology","semantic_continuity":"Stock Trends indicators use a consistent classification doctrine across decades of observations.","full_metadata_endpoints":["/v1/ai/context","/v1/meta/indicators","/v1/meta/stim"],"interpretation_limit":"Historical depth supports research and probabilistic interpretation but does not guarantee future performance."},"parameters":[{"name":"exchange","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","enum":["N","Q","A","B","T","I"],"description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","example":"N","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","example":"N","style":"form","explode":true},{"name":"weekdate","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","format":"date","description":"Inclusive end weekdate in YYYY-MM-DD format.","example":"2025-12-26","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Inclusive end weekdate in YYYY-MM-DD format.","example":"2025-12-26","style":"form","explode":true},{"name":"type","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","description":"Instrument type filter. CS is the safe default for common-stock leadership scans.","example":"CS","default":"CS","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Instrument type filter. CS is the safe default for common-stock leadership scans.","example":"CS","style":"form","explode":true},{"name":"min_rsi","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":500,"description":"Minimum Stock Trends RSI threshold. RSI baseline is 100.","example":40,"default":40,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Minimum Stock Trends RSI threshold. RSI baseline is 100.","example":40,"style":"form","explode":true},{"name":"min_mt_cnt","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":500,"description":"Minimum trend-category maturity filter.","example":4,"default":4,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Minimum trend-category maturity filter.","example":4,"style":"form","explode":true},{"name":"limit_overall","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":1000,"example":50,"default":50,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"example":50,"style":"form","explode":true},{"name":"limit_bucket","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200,"example":20,"default":20,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"example":20,"style":"form","explode":true}],"auth_required":true,"metered":true,"pricing_rule_id":"leadership_summary_latest_paid","supported_rails":["subscription","x402","mpp"],"stc_cost":0.25,"estimated_usd_cost":0.25,"pricing_note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD.","pricing":{"pricing_rule_id":"leadership_summary_latest_paid","stc_cost":0.25,"estimated_usd_cost":0.25,"cost_source":"/v1/pricing/catalog","supported_rails":["subscription","x402","mpp"],"note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD."}},{"name":"leadership_rotation_history","title":"Leadership Rotation History","description":"Retrieve historical sector leadership rotation over time. Helps agents identify where leadership is rotating across sectors before combining that context with regime, breadth, and symbol-level workflows. Fetch /v1/pricing/catalog for current STC cost.","endpoint":"/v1/leadership/rotation/history","method":"GET","category":"leadership","access_type":"paid","requires_payment":true,"input_location":"query","parameter_source":"query","input_schema":{"type":"object","properties":{"exchange":{"type":"string","enum":["N","Q","A","B","T","I"],"description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","example":"N","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"start":{"type":"string","format":"date","description":"Inclusive start weekdate in YYYY-MM-DD format.","example":"2025-01-03","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"end":{"type":"string","format":"date","description":"Inclusive end weekdate in YYYY-MM-DD format.","example":"2025-12-26","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"type":{"type":"string","description":"Instrument type filter. CS is the safe default for common-stock leadership rotation.","example":"CS","default":"CS","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"top_k":{"type":"integer","minimum":1,"maximum":50,"description":"Top sectors per week. Omit for all sectors.","example":5,"default":5,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"min_constituents":{"type":"integer","minimum":1,"maximum":5000,"example":25,"default":25,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"group_by_week":{"type":"boolean","example":true,"default":true,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"}},"required":[],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"output_summary":"Historical sector leadership rotation with bullish share, average RSI, trend maturity, leadership_score, and weekly rank.","workflow_role":"Historical leadership rotation context.","investment_agent_value":"Helps agents identify where leadership is rotating across sectors before combining that context with regime, breadth, and symbol-level workflows.","required_inputs":{},"optional_inputs":{"exchange":{"type":"string","required":false,"enum":["N","Q","A","B","T","I"],"example":"N","description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","input_location":"query","parameter_source":"query"},"start":{"type":"string","required":false,"format":"date","example":"2025-01-03","description":"Inclusive start weekdate in YYYY-MM-DD format.","input_location":"query","parameter_source":"query"},"end":{"type":"string","required":false,"format":"date","example":"2025-12-26","description":"Inclusive end weekdate in YYYY-MM-DD format.","input_location":"query","parameter_source":"query"},"type":{"type":"string","required":false,"safe_default":"CS","example":"CS","description":"Instrument type filter. CS is the safe default for common-stock leadership rotation.","input_location":"query","parameter_source":"query"},"top_k":{"type":"integer","required":false,"safe_default":5,"minimum":1,"maximum":50,"example":5,"description":"Top sectors per week. Omit for all sectors.","input_location":"query","parameter_source":"query"},"min_constituents":{"type":"integer","required":false,"safe_default":25,"minimum":1,"maximum":5000,"example":25,"input_location":"query","parameter_source":"query"},"group_by_week":{"type":"boolean","required":false,"safe_default":true,"example":true,"input_location":"query","parameter_source":"query"}},"safe_example_request":{"method":"GET","path":"/v1/leadership/rotation/history","query":{"exchange":"N","type":"CS","top_k":5,"group_by_week":true}},"related_endpoints":["/v1/leadership/summary/latest","/v1/breadth/sector/history","/v1/market/regime/history"],"next_recommended_calls":["/v1/market/regime/history","/v1/indicators/history"],"analytical_role":"leadership_intelligence","provenance_reference":{"historical_coverage_start_year":1980,"approximate_observation_count":"16M+","classification_framework":"Stock Trends trend classification methodology","semantic_continuity":"Stock Trends indicators use a consistent classification doctrine across decades of observations.","full_metadata_endpoints":["/v1/ai/context","/v1/meta/indicators","/v1/meta/stim"],"interpretation_limit":"Historical depth supports research and probabilistic interpretation but does not guarantee future performance."},"parameters":[{"name":"exchange","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","enum":["N","Q","A","B","T","I"],"description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","example":"N","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.","example":"N","style":"form","explode":true},{"name":"start","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","format":"date","description":"Inclusive start weekdate in YYYY-MM-DD format.","example":"2025-01-03","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Inclusive start weekdate in YYYY-MM-DD format.","example":"2025-01-03","style":"form","explode":true},{"name":"end","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","format":"date","description":"Inclusive end weekdate in YYYY-MM-DD format.","example":"2025-12-26","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Inclusive end weekdate in YYYY-MM-DD format.","example":"2025-12-26","style":"form","explode":true},{"name":"type","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","description":"Instrument type filter. CS is the safe default for common-stock leadership rotation.","example":"CS","default":"CS","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Instrument type filter. CS is the safe default for common-stock leadership rotation.","example":"CS","style":"form","explode":true},{"name":"top_k","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"description":"Top sectors per week. Omit for all sectors.","example":5,"default":5,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Top sectors per week. Omit for all sectors.","example":5,"style":"form","explode":true},{"name":"min_constituents","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":5000,"example":25,"default":25,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"example":25,"style":"form","explode":true},{"name":"group_by_week","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"boolean","example":true,"default":true,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"example":true,"style":"form","explode":true}],"auth_required":true,"metered":true,"pricing_rule_id":"leadership_rotation_history_paid","supported_rails":["subscription","x402","mpp"],"stc_cost":0.3,"estimated_usd_cost":0.3,"pricing_note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD.","pricing":{"pricing_rule_id":"leadership_rotation_history_paid","stc_cost":0.3,"estimated_usd_cost":0.3,"cost_source":"/v1/pricing/catalog","supported_rails":["subscription","x402","mpp"],"note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD."}},{"name":"intelligence_guidance_latest","title":"Intelligence Guidance Latest","description":"Retrieve the latest paid market guidance artifact. Gives agents a curated, validated guidance product for market reasoning without exposing private Agent runtime state. Fetch /v1/pricing/catalog for current STC cost.","endpoint":"/v1/intelligence/guidance/latest","method":"GET","category":"intelligence","access_type":"paid","requires_payment":true,"input_location":"query","parameter_source":"query","input_schema":{"type":"object","properties":{},"required":[],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query","description":"No query parameters are required for this endpoint."},"output_summary":"Validated PublicArtifactEnvelope.v1 for the latest market guidance artifact.","workflow_role":"Published guidance artifact retrieval.","investment_agent_value":"Gives agents a curated, validated guidance product for market reasoning without exposing private Agent runtime state.","required_inputs":{},"optional_inputs":{},"safe_example_request":{"method":"GET","path":"/v1/intelligence/guidance/latest","query":{}},"related_endpoints":["/v1/intelligence/discovery","/v1/intelligence/guidance/{artifact_id}","/v1/intelligence/editorial/latest/preview"],"next_recommended_calls":[],"analytical_role":"published_intelligence_artifact","parameters":[],"auth_required":true,"metered":true,"pricing_rule_id":"intelligence_guidance_latest","supported_rails":["subscription","x402","mpp"],"stc_cost":0.25,"estimated_usd_cost":0.25,"pricing_note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD.","pricing":{"pricing_rule_id":"intelligence_guidance_latest","stc_cost":0.25,"estimated_usd_cost":0.25,"cost_source":"/v1/pricing/catalog","supported_rails":["subscription","x402","mpp"],"note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD."}},{"name":"intelligence_guidance_by_id","title":"Intelligence Guidance By ID","description":"Retrieve a paid market guidance artifact by manifest artifact_id. Lets agents fetch an exact published guidance artifact after discovering its id, while preserving the API boundary around exported public envelopes. Fetch /v1/pricing/catalog for current STC cost.","endpoint":"/v1/intelligence/guidance/{artifact_id}","method":"GET","category":"intelligence","access_type":"paid","requires_payment":true,"input_location":"query","parameter_source":"query","input_schema":{"type":"object","properties":{"artifact_id":{"type":"string","description":"Manifest artifact identifier for a market_guidance envelope.","example":"market_guidance:N:YYYY-MM-DD:guidance:example","x-stocktrends-input-location":"path","x-stocktrends-parameter-source":"path"}},"required":["artifact_id"],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query","description":"artifact_id is supplied as the final path segment, not as a query parameter."},"output_summary":"Validated PublicArtifactEnvelope.v1 for the requested market guidance artifact.","workflow_role":"Exact guidance artifact retrieval.","investment_agent_value":"Lets agents fetch an exact published guidance artifact after discovering its id, while preserving the API boundary around exported public envelopes.","required_inputs":{"artifact_id":{"type":"string","required":true,"input_location":"path","parameter_source":"path","example":"market_guidance:N:YYYY-MM-DD:guidance:example","description":"Manifest artifact identifier for a market_guidance envelope."}},"optional_inputs":{},"safe_example_request":{"method":"GET","path":"/v1/intelligence/guidance/market_guidance:N:YYYY-MM-DD:guidance:example","query":{}},"related_endpoints":["/v1/intelligence/discovery","/v1/intelligence/guidance/latest"],"next_recommended_calls":[],"analytical_role":"published_intelligence_artifact","parameters":[{"name":"artifact_id","in":"query","input_location":"query","parameter_source":"query","required":true,"schema":{"type":"string","description":"Manifest artifact identifier for a market_guidance envelope.","example":"market_guidance:N:YYYY-MM-DD:guidance:example","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Manifest artifact identifier for a market_guidance envelope.","example":"market_guidance:N:YYYY-MM-DD:guidance:example","style":"form","explode":true}],"auth_required":true,"metered":true,"pricing_rule_id":"intelligence_guidance_by_id","supported_rails":["subscription","x402","mpp"],"stc_cost":0.25,"estimated_usd_cost":0.25,"pricing_note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD.","pricing":{"pricing_rule_id":"intelligence_guidance_by_id","stc_cost":0.25,"estimated_usd_cost":0.25,"cost_source":"/v1/pricing/catalog","supported_rails":["subscription","x402","mpp"],"note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD."}},{"name":"intelligence_research_latest","title":"Intelligence Research Latest","description":"Retrieve the latest paid market research report artifact. Gives agents a curated, validated research product for deeper market analysis without exposing private Agent runtime state. Fetch /v1/pricing/catalog for current STC cost.","endpoint":"/v1/intelligence/research/latest","method":"GET","category":"intelligence","access_type":"paid","requires_payment":true,"input_location":"query","parameter_source":"query","input_schema":{"type":"object","properties":{},"required":[],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query","description":"No query parameters are required for this endpoint."},"output_summary":"Validated PublicArtifactEnvelope.v1 for the latest market research artifact.","workflow_role":"Published research artifact retrieval.","investment_agent_value":"Gives agents a curated, validated research product for deeper market analysis without exposing private Agent runtime state.","required_inputs":{},"optional_inputs":{},"safe_example_request":{"method":"GET","path":"/v1/intelligence/research/latest","query":{}},"related_endpoints":["/v1/intelligence/discovery","/v1/intelligence/research/{artifact_id}","/v1/intelligence/editorial/latest/preview"],"next_recommended_calls":[],"analytical_role":"published_intelligence_artifact","parameters":[],"auth_required":true,"metered":true,"pricing_rule_id":"intelligence_research_latest","supported_rails":["subscription","x402","mpp"],"stc_cost":0.5,"estimated_usd_cost":0.5,"pricing_note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD.","pricing":{"pricing_rule_id":"intelligence_research_latest","stc_cost":0.5,"estimated_usd_cost":0.5,"cost_source":"/v1/pricing/catalog","supported_rails":["subscription","x402","mpp"],"note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD."}},{"name":"intelligence_research_by_id","title":"Intelligence Research By ID","description":"Retrieve a paid market research artifact by manifest artifact_id. Lets agents fetch an exact published research artifact after discovering its id, while preserving the API boundary around exported public envelopes. Fetch /v1/pricing/catalog for current STC cost.","endpoint":"/v1/intelligence/research/{artifact_id}","method":"GET","category":"intelligence","access_type":"paid","requires_payment":true,"input_location":"query","parameter_source":"query","input_schema":{"type":"object","properties":{"artifact_id":{"type":"string","description":"Manifest artifact identifier for a market_research_report envelope.","example":"market_research_report:N:YYYY-MM-DD:research:example","x-stocktrends-input-location":"path","x-stocktrends-parameter-source":"path"}},"required":["artifact_id"],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query","description":"artifact_id is supplied as the final path segment, not as a query parameter."},"output_summary":"Validated PublicArtifactEnvelope.v1 for the requested market research artifact.","workflow_role":"Exact research artifact retrieval.","investment_agent_value":"Lets agents fetch an exact published research artifact after discovering its id, while preserving the API boundary around exported public envelopes.","required_inputs":{"artifact_id":{"type":"string","required":true,"input_location":"path","parameter_source":"path","example":"market_research_report:N:YYYY-MM-DD:research:example","description":"Manifest artifact identifier for a market_research_report envelope."}},"optional_inputs":{},"safe_example_request":{"method":"GET","path":"/v1/intelligence/research/market_research_report:N:YYYY-MM-DD:research:example","query":{}},"related_endpoints":["/v1/intelligence/discovery","/v1/intelligence/research/latest"],"next_recommended_calls":[],"analytical_role":"published_intelligence_artifact","parameters":[{"name":"artifact_id","in":"query","input_location":"query","parameter_source":"query","required":true,"schema":{"type":"string","description":"Manifest artifact identifier for a market_research_report envelope.","example":"market_research_report:N:YYYY-MM-DD:research:example","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Manifest artifact identifier for a market_research_report envelope.","example":"market_research_report:N:YYYY-MM-DD:research:example","style":"form","explode":true}],"auth_required":true,"metered":true,"pricing_rule_id":"intelligence_research_by_id","supported_rails":["subscription","x402","mpp"],"stc_cost":0.5,"estimated_usd_cost":0.5,"pricing_note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD.","pricing":{"pricing_rule_id":"intelligence_research_by_id","stc_cost":0.5,"estimated_usd_cost":0.5,"cost_source":"/v1/pricing/catalog","supported_rails":["subscription","x402","mpp"],"note":"STC is the source of truth. stc_cost is resolved from /v1/pricing/catalog when available; estimated_usd_cost uses the current planning reference of 1 STC approximately 1 USD."}}],"workflows":[{"workflow_id":"regime_analysis","name":"Market Regime Analysis","description":"Full market regime intelligence pipeline: current regime classification, historical regime sequence for context, and probabilistic forward forecast.","tags":["agent","research","regime"],"supported_rails":["subscription","x402","mpp"],"step_count":3,"pricing_rule_ids":["market_regime_latest","market_regime_history","market_regime_forecast"],"best_for":"Market context before symbol selection, screening, or portfolio construction.","analytical_role":"market_context_workflow","research_goal":"Set portfolio bias from current and recent market regime data before any symbol selection, screening, or portfolio construction.","agent_goal_examples":["Decide whether a portfolio agent should use bullish, bearish, or mixed candidate filters.","Summarize current regime and recent regime direction before selecting symbols."],"symbol_selection_guidance":"This workflow does not select symbols directly; use its regime result to choose bias filters for /v1/agent/screener/top or /v1/portfolio/construct.","interpretation_guidance":null,"required_interpretation_steps":[],"next_step_guidance":["Use /v1/agent/screener/top to discover candidates.","Use /v1/decision/evaluate-symbol for a known symbol.","Use /v1/portfolio/construct when the goal is an allocation proposal."],"note":"Use GET /v1/workflows for live per-step STC costs."},{"workflow_id":"symbol_decision","name":"Regime-Aware Symbol Decision","description":"Classify the current market regime then evaluate a single symbol for a directional research bias in that regime context.","tags":["agent","research","decision"],"supported_rails":["subscription","x402","mpp"],"step_count":2,"pricing_rule_ids":["market_regime_latest","evaluate_symbol"],"best_for":"Evaluating a known symbol in current market-regime context.","analytical_role":"symbol_evaluation_workflow","research_goal":"Evaluate a single resolved symbol with deterministic Stock Trends signal and regime context before deeper history or portfolio calls.","agent_goal_examples":["Evaluate IBM-N after resolving it from /v1/instruments/resolve.","Score a symbol carried forward from a screener, STWR report, or portfolio position."],"symbol_selection_guidance":"Provide symbol_exchange directly when available. If only a ticker is known, first call /v1/instruments/lookup or /v1/instruments/resolve and reuse the returned symbol_exchange.","interpretation_guidance":null,"required_interpretation_steps":[],"next_step_guidance":["Use /v1/indicators/latest or /v1/stim/latest for deeper single-symbol context.","Use /v1/portfolio/evaluate when comparing the symbol inside an allocation."],"note":"Use GET /v1/workflows for live per-step STC costs."},{"workflow_id":"stim_forecast_review","name":"ST-IM Forecast Review","description":"Review ST-IM forward-return expectations for one symbol across the 4, 13, and 40 week horizons, with indicator and price context.","tags":["agent","research","stim","forecast"],"supported_rails":["subscription","x402","mpp"],"step_count":8,"pricing_rule_ids":["stim_latest_paid","indicators_latest_paid","prices_latest_paid","stim_history_paid","indicators_history_paid","prices_history_paid"],"best_for":"Single-symbol probabilistic forward-return review.","analytical_role":"probabilistic_forecast_workflow","research_goal":"Interpret ST-IM forward return distributions for a resolved symbol relative to base-period means, using /v1/meta/inference as the provider-agnostic contract and /v1/meta/stim as the ST-IM provider profile.","agent_goal_examples":["Review IBM-N ST-IM expectations across 4, 13, and 40 week horizons.","Estimate whether a symbol's ST-IM mean returns exceed base-period means with adequate probability."],"symbol_selection_guidance":"Use symbol_exchange directly when known. If only a ticker is known, first call /v1/instruments/lookup or /v1/instruments/resolve and reuse the returned symbol_exchange.","interpretation_guidance":"/v1/meta/inference and /v1/meta/stim must be consulted before interpreting ST-IM results. Raw x4wk/x13wk/x40wk means are not sufficient alone; compare them to base_period_mean_returns_pct and use x4wksd/x13wksd/x40wksd to estimate the probability of exceeding base means. Preserve provider identity, forecast horizon, distribution, confidence, evidence, uncertainty, explanation, signal source, and auditability. STIM Select-style logic should emphasize 13-week probability of exceeding the base mean >= 55% and lower confidence bounds relative to base-period means where applicable.","required_interpretation_steps":["Call GET /v1/meta/inference before interpreting provider-specific inference outputs.","Call GET /v1/meta/stim before interpreting ST-IM results.","Compare x4wk, x13wk, and x40wk to base_period_mean_returns_pct.","Use x4wksd, x13wksd, and x40wksd to estimate probability of exceeding base means.","Interpret ST-IM probabilities as conditional historical tendencies, not guarantees or buy/sell commands.","Disclose stale or fallback data when is_stale=true or missing_reason is present."],"next_step_guidance":["Use /v1/decision/evaluate-symbol after interpreting ST-IM probability context.","Use /v1/portfolio/evaluate when reviewing the symbol inside an existing allocation."],"note":"Use GET /v1/workflows for live per-step STC costs."},{"workflow_id":"portfolio_build","name":"Screener → Portfolio Build","description":"Screen for qualifying tickers, construct a portfolio from candidates, then evaluate the constructed portfolio's risk and return profile.","tags":["agent","portfolio","research"],"supported_rails":["subscription","x402","mpp"],"step_count":3,"pricing_rule_ids":["agent_screener_top","portfolio_construct","portfolio_evaluate"],"best_for":"First portfolio workflow for agents that need to discover symbols and build an allocation.","analytical_role":"portfolio_construction_workflow","research_goal":"Discover candidates via screener and produce a scored equal-weight portfolio proposal that can be evaluated and compared against an existing allocation.","agent_goal_examples":["Build a 5-stock equal-weight candidate portfolio from fresh Stock Trends signals.","Use screener output symbols as the candidate context for a portfolio construction run."],"symbol_selection_guidance":"Start with /v1/agent/screener/top. Reuse results[].symbol_exchange from the screener when calling /v1/decision/evaluate-symbol, /v1/stim/latest, /v1/portfolio/evaluate, or /v1/portfolio/compare. Skip duplicate paid symbol calls for repeated symbol_exchange values.","interpretation_guidance":null,"required_interpretation_steps":[],"next_step_guidance":["Use /v1/portfolio/compare to compare the constructed portfolio against an existing allocation.","Use /v1/stim/latest for selected symbols when forward-return distributions are needed."],"note":"Use GET /v1/workflows for live per-step STC costs."},{"workflow_id":"portfolio_compare_review","name":"Portfolio Compare Review","description":"Evaluate an existing portfolio, construct a proposed alternative, then compare the two portfolios to quantify the difference.","tags":["agent","portfolio"],"supported_rails":["subscription","x402","mpp"],"step_count":3,"pricing_rule_ids":["portfolio_evaluate","portfolio_construct","portfolio_compare"],"best_for":"Comparing a current allocation against a proposed Stock Trends-informed alternative.","analytical_role":"portfolio_comparison_workflow","research_goal":"Quantify whether a proposed portfolio improves Stock Trends decision score and regime alignment versus a baseline allocation.","agent_goal_examples":["Evaluate a user portfolio, construct a proposed alternative, then compare score and alignment.","Review whether a newly constructed portfolio improves regime alignment versus a baseline."],"symbol_selection_guidance":"The compare endpoint expects left and right as direct arrays of positions, not wrapper objects. Reuse portfolio arrays returned by /v1/portfolio/construct or positions supplied to /v1/portfolio/evaluate.","interpretation_guidance":null,"required_interpretation_steps":[],"next_step_guidance":["Use comparison.winner, score_delta, and alignment_advantage to summarize differences.","Reuse any symbol_exchange values in losing positions for deeper /v1/decision/evaluate-symbol review."],"note":"Use GET /v1/workflows for live per-step STC costs."}],"pricing":{"unit":"STC","unit_description":"Stock Trends Credits. 1 STC ≈ $1 USD (reference value, not a fixed peg).","model":"All endpoints price in STC. Payment rails translate STC into subscription debit, x402 amount, or MPP session debit.","metadata_endpoint":"/v1/pricing","catalog_endpoint":"/v1/pricing/catalog","workflow_registry_endpoint":"/v1/workflows","cost_estimate_endpoint":"/v1/cost-estimate","x402_preview_location":"HTTP 402 response body field stocktrends_preview","note":"STC costs are dynamic and resolved from the pricing catalog. Do not hardcode costs — always fetch /v1/pricing/catalog at agent startup."},"auth":{"modes":[{"mode":"subscription","description":"API key with active subscription. Provides monthly STC allocation.","headers":{"primary":"X-API-Key: YOUR_API_KEY","alternative":"Authorization: Bearer YOUR_API_KEY"}},{"mode":"x402","description":"Per-request agent payment via HTTP 402 challenge/verify flow.","headers":{"X-StockTrends-Payment-Method":"x402","X-StockTrends-Payment-Network":"base","X-StockTrends-Payment-Token":"USDC","X-StockTrends-Payment-Reference":"<reference>","X-StockTrends-Payment-Amount":"<amount>"}},{"mode":"mpp","description":"Session-based payments. STC consumed within an active payment session.","headers":{"X-StockTrends-Payment-Method":"mpp","X-StockTrends-Session-Id":"<session_id>"}}],"agent_identity_headers":{"X-StockTrends-Agent-Id":"Stable external agent identifier (required for agent attribution).","X-StockTrends-Agent-Type":"Agent category, e.g. 'editorial'.","X-StockTrends-Agent-Vendor":"Vendor or platform operating the agent.","X-StockTrends-Agent-Version":"Agent software version.","X-StockTrends-Request-Purpose":"Optional statement of request purpose.","X-StockTrends-Session-Id":"Optional session/workflow correlation ID."}},"agent_conversion_path":{"proof_endpoint":"/v1/ai/proof/market-edge","proof_description":"Free, non-metered. Demonstrates signal structure and value proposition without requiring payment or authentication.","conversion_steps":[{"step":1,"call":"GET /v1/ai/proof/market-edge","note":"No auth needed. See signal structure and value proposition."},{"step":2,"call":"GET /v1/workflows","note":"Choose a strategy and endpoint sequence for the research task."},{"step":3,"call":"GET /v1/pricing/catalog","note":"Resolve live STC costs for target endpoints."},{"step":4,"call":"GET /v1/pricing","note":"Inspect payment rails, identity headers, and accepted payment method guidance."},{"step":5,"call":"GET /v1/agent/screener/top","note":"First premium call. Supports subscription, x402, mpp."}],"payment_methods_supported":["subscription","x402","mpp"],"on_payment_required":"Selected agent-pay endpoints may return HTTP 402 with an x402 challenge when no payment has been presented. The response body contains accepted_payment_methods, pricing, payment_required, and stocktrends_preview fields. Use stocktrends_preview to confirm endpoint purpose, required inputs, safe example request, response shape, related endpoints, pricing_rule_id, STC cost, and supported rails before paying. Subscription callers receive 401/403 on auth failure, not 402. MPP uses session authorization rather than the x402 challenge flow."},"notes":["Start with /v1/ai/tools as the primary machine-readable entry point for agents.","Use /v1/workflows to choose a strategy, then /v1/pricing/catalog to budget each endpoint.","Use /v1/instruments/lookup and /v1/instruments/resolve to produce symbol_exchange values before paid symbol workflows.","Use /v1/stwr/reports/catalog and /v1/meta/* endpoints as planning helpers, not side documentation.","Use /v1/pricing to understand payment rails, agent identity headers, and accepted payment headers.","All paid endpoints price in STC. Fetch /v1/pricing/catalog at agent startup.","For x402, inspect the 402 stocktrends_preview before paying.","Use /v1/cost-estimate to plan STC spend before executing a workflow.","Use /v1/ai/context as the secondary explanatory endpoint for dataset and endpoint overview.","Use data_provenance for historical coverage, observation count, semantic continuity, and limitations.","See /v1/docs and /v1/openapi.json for exact request/response contracts."]}