{"provider":"stocktrends","version":"v1","service_description":"Autonomous portfolio intelligence API for AI agents. Agent-native probabilistic market intelligence infrastructure for stock analytics, pre-trade research context, and trend screening: 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":"/.well-known/x402","x402_payment_resources":"/.well-known/x402","task_and_tool_discovery":"/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"},"acquisition_evaluation_guidance":{"guidance":"When deciding whether additional Stock Trends information is worth acquiring for a task, first inspect the relevant public resources: capabilities (/.well-known/x402, /v1/ai/tools, /v1/workflows), interpretation semantics (/v1/meta/inference, /v1/meta/stim, /v1/meta/indicators), available evidence (/v1/selections/stim-select/outcomes/summary, /v1/stocktrends/portfolios), and cost (/v1/pricing/catalog, /v1/cost-estimate). Treat those as separate categories, do not infer usefulness from availability, and decide from what was actually inspected.","canonical_source":"/v1/ai/context","inspect_before_deciding":{"what_is_offered":["/.well-known/x402","/v1/ai/tools","/v1/workflows"],"how_to_interpret_it":["/v1/meta/inference","/v1/meta/stim","/v1/meta/indicators"],"what_evidence_exists":["/v1/selections/stim-select/outcomes/summary","/v1/stocktrends/portfolios"],"what_it_costs":["/v1/pricing/catalog","/v1/cost-estimate"]},"illustrative_capability_example":{"endpoint":"/v1/ai/proof/market-edge","shows":"response structure and how context layers compose","is_not":"not empirical evidence, not realized outcomes, not predictive performance, and not investment performance"},"category_separation":"A service description is not methodology, and methodology is not evidence. Read each from its own source.","availability_is_not_evidence":"The existence of an endpoint says nothing about whether its output is useful for a given task.","scope_rule":"Inspect only the resources relevant to the task.","no_payment_required_to_evaluate":"Every resource named here is public and non-metered.","evidence_families_source":"/v1/ai/context"},"augmentation_role":"Stock Trends supplies independently derived market context intended to be combined with the consumer's own strategy, research process, forecasting model, or agent objective. It is designed to augment an existing analytical process rather than to replace it, and it does not supply the consumer's objective, constraints, or decision rule. Whether the added context is useful for a given task is for the consumer to determine from the methodology and evidence resources.","recommended_first_call":{"endpoint":"/v1/agent/screener/top","method":"GET","reason":"A common first paid call once a task has been chosen: it returns ranked Stock Trends signal candidates that downstream symbol, decision and portfolio steps consume. Whether it suits a given task is for the caller to determine from the resources named in acquisition_evaluation_guidance.","read_first":["/.well-known/x402","/v1/ai/tools","/v1/workflows","/v1/pricing/catalog"],"auth_required":true,"supported_rails":["subscription","x402","mpp"],"expected_flow":["fetch /.well-known/x402 to discover payable resources and safe requests","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","construct the published serviceable request","if using anonymous x402: an eligible fixed-price resource returns the 402 payment contract even for a bare probe; availability-gated and parameterized resources resolve availability or path parameters first","pay and retry with PAYMENT-SIGNATURE or X-Payment proof"]},"quickstart":[{"step":1,"action":"fetch","path":"/.well-known/x402","note":"Discover payable resources, runtime rails, request schemas, and canonical safe examples."},{"step":2,"action":"fetch","path":"/v1/ai/tools","note":"Choose a task-level API tool."},{"step":3,"action":"fetch","path":"/v1/openapi.json","note":"Confirm the exact request contract and access alternatives."},{"step":4,"action":"fetch","path":"/v1/workflows","note":"Choose a strategy and endpoint sequence for the task."},{"step":5,"action":"fetch","path":"/v1/pricing/catalog","note":"Resolve the current STC cost from the pricing source of truth."},{"step":6,"action":"call","path":"/v1/agent/screener/top","note":"Submit the published serviceable request. Anonymous x402 callers receive the challenge; on an eligible fixed-price resource a bare probe already returns it, and each tool's access.challenge_lifecycle states which class it is."}],"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":[],"stock_trends_supplies":[],"researcher_supplied_steps":[],"not_provided_by_this_api":[],"success_condition":null,"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":[],"stock_trends_supplies":[],"researcher_supplied_steps":[],"not_provided_by_this_api":[],"success_condition":null,"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":[],"stock_trends_supplies":[],"researcher_supplied_steps":[],"not_provided_by_this_api":[],"success_condition":null,"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.","Use /.well-known/x402 for payment-resource discovery and /v1/ai/tools for task/tool discovery.","Before deciding whether paid Stock Trends information is worth acquiring for a task, follow acquisition_evaluation_guidance: inspect the relevant capability, interpretation, evidence, and pricing resources, keep those categories separate, and decide from what was actually inspected. /v1/ai/context carries the full statement and the separated evidence families.","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, construct a serviceable request from /.well-known/x402 and /v1/openapi.json before paying; an unpaid probe of an eligible recognized fixed-price resource returns its 402 payment contract whether or not the request is complete, while availability-gated and parameterized resources resolve availability or path identity first. Each resource publishes its own challenge_lifecycle. The 402 stocktrends_preview is a final confirmation, not the schema-discovery mechanism.","Once a payment proof is presented, deterministically invalid input is rejected before any payment challenge or settlement: a malformed symbol_exchange, a missing required parameter combination, an unsupported sort/exchange/trend value, or a semantically incomplete body returns a 400 or 422 input error and nothing is verified or settled. An unpaid probe of an eligible recognized fixed-price resource is answered with the 402 challenge instead, so its payment and input contract is readable at the canonical resource URL; availability-gated and parameterized resources are documented exceptions. Pricing context headers remain on the input error, so the price is still discoverable once the request is corrected."],"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":"Market Context - Static Schema Illustration","description":"Free synthetic-only schema reference. Shows Stock Trends signal fields, trend codes, RSI baseline semantics, and how the context layers compose in a response, without exposing paid market data. It measures nothing: not empirical evidence, not realized outcomes, and not predictive or investment performance.","endpoint":"/v1/ai/proof/market-edge","method":"GET","category":"discovery","classification":"illustrative_capability_example","input_schema":{"type":"object","properties":{},"required":[],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"output_summary":"Synthetic response-structure example and access-mechanics reference.","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","historical_signal_validation"],"example":"portfolio_build","examples":["regime_analysis","symbol_decision","stim_forecast_review","portfolio_build","portfolio_compare_review","historical_signal_validation"],"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","historical_signal_validation"],"example":"portfolio_build","examples":["regime_analysis","symbol_decision","stim_forecast_review","portfolio_build","portfolio_compare_review","historical_signal_validation"],"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,"challenge_lifecycle":{"challenge_class":"fixed_price","serviceable_request_required_before_challenge":false,"serviceable_request_required_before_settlement":true,"bare_canonical_probe_returns_challenge":true,"availability_gate_precedes_challenge":false,"parameterized_resource":false},"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 directional Stock Trends trend codes for canonical CS+UN equities across A/N/Q/T. regime_score = bullish_pct - bearish_pct, range -1.0 to +1.0. Bullish codes: {^+, ^-, v^}. Bearish codes: {v-, v+, ^v}. Neutral and unclassified observations are excluded from the directional denominator. Also returns avg_rsi and avg_mt_cnt, which can be null when no valid observations contribute.","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 (classified_count compatibility field), classified_count, observed_count, neutral_count, unclassified_count, population, 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 directional classified canonical CS+UN equities on A/N/Q/T.","Bullish states are ^+, ^-, and v^; bearish states are v-, v+, and ^v. Neutral and unclassified observations are excluded from the directional denominator.","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,"challenge_lifecycle":{"challenge_class":"fixed_price","serviceable_request_required_before_challenge":false,"serviceable_request_required_before_settlement":true,"bare_canonical_probe_returns_challenge":true,"availability_gate_precedes_challenge":false,"parameterized_resource":false},"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":"Review recent market regime transitions. Helps agents understand whether current regime context is stable or changing. Fetch /v1/pricing/catalog for current STC cost.","endpoint":"/v1/market/regime/history","method":"GET","category":"market","access_type":"paid","requires_payment":true,"input_location":"query","parameter_source":"query","input_schema":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":52,"description":"Maximum number of rows returned. This endpoint applies no default date window. The applied_bounds block on the response reports the limit that was actually used.","example":12,"default":12,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"start_date":{"type":"string","format":"date","description":"Optional earliest weekdate to include, in YYYY-MM-DD format. This filters which weeks are eligible; the endpoint still returns at most `limit` weeks and returns the most recent eligible weeks, so it does not select an arbitrary historical window.","example":"2025-01-03","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"}},"required":[],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"output_summary":"Recent weekly market regime sequence.","workflow_role":"Historical market context.","investment_agent_value":"Helps agents understand whether current regime context is stable or changing.","required_inputs":{},"optional_inputs":{"limit":{"type":"integer","required":false,"safe_default":12,"minimum":1,"maximum":52,"example":12,"description":"Maximum number of rows returned. This endpoint applies no default date window. The applied_bounds block on the response reports the limit that was actually used.","input_location":"query","parameter_source":"query"},"start_date":{"type":"string","required":false,"format":"date","example":"2025-01-03","description":"Optional earliest weekdate to include, in YYYY-MM-DD format. This filters which weeks are eligible; the endpoint still returns at most `limit` weeks and returns the most recent eligible weeks, so it does not select an arbitrary historical window.","input_location":"query","parameter_source":"query"}},"safe_example_request":{"method":"GET","path":"/v1/market/regime/history","query":{"limit":12}},"related_endpoints":["/v1/market/regime/latest","/v1/market/regime/forecast"],"next_recommended_calls":["/v1/market/regime/forecast"],"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 directional classified canonical CS+UN equities on A/N/Q/T.","Bullish states are ^+, ^-, and v^; bearish states are v-, v+, and ^v. Neutral and unclassified observations are excluded from the directional denominator.","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"]},"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":52,"description":"Maximum number of rows returned. This endpoint applies no default date window. The applied_bounds block on the response reports the limit that was actually used.","example":12,"default":12,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Maximum number of rows returned. This endpoint applies no default date window. The applied_bounds block on the response reports the limit that was actually used.","example":12,"style":"form","explode":true},{"name":"start_date","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","format":"date","description":"Optional earliest weekdate to include, in YYYY-MM-DD format. This filters which weeks are eligible; the endpoint still returns at most `limit` weeks and returns the most recent eligible weeks, so it does not select an arbitrary historical window.","example":"2025-01-03","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Optional earliest weekdate to include, in YYYY-MM-DD format. This filters which weeks are eligible; the endpoint still returns at most `limit` weeks and returns the most recent eligible weeks, so it does not select an arbitrary historical window.","example":"2025-01-03","style":"form","explode":true}],"auth_required":true,"metered":true,"pricing_rule_id":"market_regime_history","supported_rails":["subscription","x402","mpp"],"challenge_lifecycle":{"challenge_class":"fixed_price","serviceable_request_required_before_challenge":false,"serviceable_request_required_before_settlement":true,"bare_canonical_probe_returns_challenge":true,"availability_gate_precedes_challenge":false,"parameterized_resource":false},"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,"challenge_lifecycle":{"challenge_class":"fixed_price","serviceable_request_required_before_challenge":false,"serviceable_request_required_before_settlement":true,"bare_canonical_probe_returns_challenge":true,"availability_gate_precedes_challenge":false,"parameterized_resource":false},"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 candidate discovery 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 candidate discovery 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"],"challenge_lifecycle":{"challenge_class":"fixed_price","serviceable_request_required_before_challenge":false,"serviceable_request_required_before_settlement":true,"bare_canonical_probe_returns_challenge":true,"availability_gate_precedes_challenge":false,"parameterized_resource":false},"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"],"challenge_lifecycle":{"challenge_class":"fixed_price","serviceable_request_required_before_challenge":false,"serviceable_request_required_before_settlement":true,"bare_canonical_probe_returns_challenge":true,"availability_gate_precedes_challenge":false,"parameterized_resource":false},"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"],"challenge_lifecycle":{"challenge_class":"fixed_price","serviceable_request_required_before_challenge":false,"serviceable_request_required_before_settlement":true,"bare_canonical_probe_returns_challenge":true,"availability_gate_precedes_challenge":false,"parameterized_resource":false},"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"],"challenge_lifecycle":{"challenge_class":"fixed_price","serviceable_request_required_before_challenge":false,"serviceable_request_required_before_settlement":true,"bare_canonical_probe_returns_challenge":true,"availability_gate_precedes_challenge":false,"parameterized_resource":false},"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"],"challenge_lifecycle":{"challenge_class":"fixed_price","serviceable_request_required_before_challenge":false,"serviceable_request_required_before_settlement":true,"bare_canonical_probe_returns_challenge":true,"availability_gate_precedes_challenge":false,"parameterized_resource":false},"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. This endpoint applies no default date window. The applied_bounds block on the response reports the limit that was actually used.","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. This endpoint applies no default date window. The applied_bounds block on the response reports the limit that was actually used.","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. This endpoint applies no default date window. The applied_bounds block on the response reports the limit that was actually used.","example":260,"default":260,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Maximum number of rows returned. This endpoint applies no default date window. The applied_bounds block on the response reports the limit that was actually used.","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"],"challenge_lifecycle":{"challenge_class":"fixed_price","serviceable_request_required_before_challenge":false,"serviceable_request_required_before_settlement":true,"bare_canonical_probe_returns_challenge":true,"availability_gate_precedes_challenge":false,"parameterized_resource":false},"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,"challenge_lifecycle":{"challenge_class":"fixed_price","serviceable_request_required_before_challenge":false,"serviceable_request_required_before_settlement":true,"bare_canonical_probe_returns_challenge":true,"availability_gate_precedes_challenge":false,"parameterized_resource":false},"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,"challenge_lifecycle":{"challenge_class":"fixed_price","serviceable_request_required_before_challenge":false,"serviceable_request_required_before_settlement":true,"bare_canonical_probe_returns_challenge":true,"availability_gate_precedes_challenge":false,"parameterized_resource":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, 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,"challenge_lifecycle":{"challenge_class":"fixed_price","serviceable_request_required_before_challenge":false,"serviceable_request_required_before_settlement":true,"bare_canonical_probe_returns_challenge":true,"availability_gate_precedes_challenge":false,"parameterized_resource":false},"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,"challenge_lifecycle":{"challenge_class":"fixed_price","serviceable_request_required_before_challenge":false,"serviceable_request_required_before_settlement":true,"bare_canonical_probe_returns_challenge":true,"availability_gate_precedes_challenge":false,"parameterized_resource":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":"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"],"challenge_lifecycle":{"challenge_class":"fixed_price","serviceable_request_required_before_challenge":false,"serviceable_request_required_before_settlement":true,"bare_canonical_probe_returns_challenge":true,"availability_gate_precedes_challenge":false,"parameterized_resource":false},"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. This endpoint applies no default date window. The applied_bounds block on the response reports the limit that was actually used.","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. This endpoint applies no default date window. The applied_bounds block on the response reports the limit that was actually used.","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. This endpoint applies no default date window. The applied_bounds block on the response reports the limit that was actually used.","example":260,"default":260,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Maximum number of rows returned. This endpoint applies no default date window. The applied_bounds block on the response reports the limit that was actually used.","example":260,"style":"form","explode":true}],"auth_required":true,"metered":true,"pricing_rule_id":"indicators_history_paid","supported_rails":["subscription","x402","mpp"],"challenge_lifecycle":{"challenge_class":"fixed_price","serviceable_request_required_before_challenge":false,"serviceable_request_required_before_settlement":true,"bare_canonical_probe_returns_challenge":true,"availability_gate_precedes_challenge":false,"parameterized_resource":false},"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"],"challenge_lifecycle":{"challenge_class":"fixed_price","serviceable_request_required_before_challenge":false,"serviceable_request_required_before_settlement":true,"bare_canonical_probe_returns_challenge":true,"availability_gate_precedes_challenge":false,"parameterized_resource":false},"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. This endpoint applies no default date window. The applied_bounds block on the response reports the limit that was actually used.","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. This endpoint applies no default date window. The applied_bounds block on the response reports the limit that was actually used.","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. This endpoint applies no default date window. The applied_bounds block on the response reports the limit that was actually used.","example":260,"default":260,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Maximum number of rows returned. This endpoint applies no default date window. The applied_bounds block on the response reports the limit that was actually used.","example":260,"style":"form","explode":true}],"auth_required":true,"metered":true,"pricing_rule_id":"prices_history_paid","supported_rails":["subscription","x402","mpp"],"challenge_lifecycle":{"challenge_class":"fixed_price","serviceable_request_required_before_challenge":false,"serviceable_request_required_before_settlement":true,"bare_canonical_probe_returns_challenge":true,"availability_gate_precedes_challenge":false,"parameterized_resource":false},"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":"market_epoch_latest","title":"Market Epoch Latest","description":"Retrieve the current persisted contextual market Epoch state. Provides frozen, auditable market-state context alongside independent market context products. Fetch /v1/pricing/catalog for current STC cost.","endpoint":"/v1/market/epoch/latest","method":"GET","category":"market","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":"Latest frozen persisted Market Epoch state and provenance.","workflow_role":"Persisted market Epoch context.","investment_agent_value":"Provides frozen, auditable market-state context alongside independent market context products.","required_inputs":{},"optional_inputs":{},"safe_example_request":{"method":"GET","path":"/v1/market/epoch/latest","query":{}},"related_endpoints":["/v1/market/epoch/history","/v1/market/regime/latest"],"next_recommended_calls":["/v1/market/epoch/history"],"analytical_role":"market_epoch_classifier","interpretation_guidance":{"model":"Frozen unsupervised K=3 market-state classifier based on six aggregate weekly Stock Trends features.","states":["BROAD_BULLISH","BEARISH_MATURITY","BULLISH_MATURITY"],"interpretation_rules":["An Epoch state is contextual market state, not a trade signal or forward-return forecast.","changed_this_week is a persisted 0/1 flag indicating whether the assigned Epoch differs from the immediately previous official weekly Epoch.","weeks_in_epoch is consecutive weekly persistence of the current assigned Epoch.","assigned_distance is distance to the assigned frozen centroid in standardized feature space.","second_nearest_distance is distance to the second-nearest frozen centroid.","separation_margin = second_nearest_distance - assigned_distance; it is not a probability or forecast confidence.","The descriptive word Maturity does not imply that a reversal must follow."]},"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":true,"metered":true,"pricing_rule_id":"market_epoch_latest","supported_rails":["subscription","x402","mpp"],"challenge_lifecycle":{"challenge_class":"fixed_price","serviceable_request_required_before_challenge":false,"serviceable_request_required_before_settlement":true,"bare_canonical_probe_returns_challenge":true,"availability_gate_precedes_challenge":false,"parameterized_resource":false},"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_epoch_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_epoch_history","title":"Market Epoch History","description":"Review persisted historical contextual Market Epoch states. Provides bounded, auditable context for reviewing Epoch persistence and changes. Fetch /v1/pricing/catalog for current STC cost.","endpoint":"/v1/market/epoch/history","method":"GET","category":"market","access_type":"paid","requires_payment":true,"input_location":"query","parameter_source":"query","input_schema":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":2600,"description":"Maximum number of rows returned. This endpoint applies no default date window. The applied_bounds block on the response reports the limit that was actually used.","example":52,"default":52,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"start_date":{"type":"string","format":"date","description":"Optional inclusive earliest weekdate in YYYY-MM-DD format.","example":"2025-01-03","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"end_date":{"type":"string","format":"date","description":"Optional inclusive latest weekdate in YYYY-MM-DD format.","example":"2025-12-26","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"}},"required":[],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"output_summary":"Bounded persisted Market Epoch history, newest first.","workflow_role":"Historical persisted market Epoch context.","investment_agent_value":"Provides bounded, auditable context for reviewing Epoch persistence and changes.","required_inputs":{},"optional_inputs":{"limit":{"type":"integer","required":false,"safe_default":52,"minimum":1,"maximum":2600,"example":52,"description":"Maximum number of rows returned. This endpoint applies no default date window. The applied_bounds block on the response reports the limit that was actually used.","input_location":"query","parameter_source":"query"},"start_date":{"type":"string","required":false,"format":"date","example":"2025-01-03","description":"Optional inclusive earliest weekdate in YYYY-MM-DD format.","input_location":"query","parameter_source":"query"},"end_date":{"type":"string","required":false,"format":"date","example":"2025-12-26","description":"Optional inclusive latest weekdate in YYYY-MM-DD format.","input_location":"query","parameter_source":"query"}},"safe_example_request":{"method":"GET","path":"/v1/market/epoch/history","query":{"limit":52}},"related_endpoints":["/v1/market/epoch/latest","/v1/market/regime/history"],"next_recommended_calls":["/v1/market/epoch/latest"],"analytical_role":"market_epoch_classifier","interpretation_guidance":{"model":"Frozen unsupervised K=3 market-state classifier based on six aggregate weekly Stock Trends features.","states":["BROAD_BULLISH","BEARISH_MATURITY","BULLISH_MATURITY"],"interpretation_rules":["An Epoch state is contextual market state, not a trade signal or forward-return forecast.","changed_this_week is a persisted 0/1 flag indicating whether the assigned Epoch differs from the immediately previous official weekly Epoch.","weeks_in_epoch is consecutive weekly persistence of the current assigned Epoch.","assigned_distance is distance to the assigned frozen centroid in standardized feature space.","second_nearest_distance is distance to the second-nearest frozen centroid.","separation_margin = second_nearest_distance - assigned_distance; it is not a probability or forecast confidence.","The descriptive word Maturity does not imply that a reversal must follow."]},"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":2600,"description":"Maximum number of rows returned. This endpoint applies no default date window. The applied_bounds block on the response reports the limit that was actually used.","example":52,"default":52,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Maximum number of rows returned. This endpoint applies no default date window. The applied_bounds block on the response reports the limit that was actually used.","example":52,"style":"form","explode":true},{"name":"start_date","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","format":"date","description":"Optional inclusive earliest weekdate in YYYY-MM-DD format.","example":"2025-01-03","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Optional inclusive earliest weekdate in YYYY-MM-DD format.","example":"2025-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":"Optional inclusive latest weekdate in YYYY-MM-DD format.","example":"2025-12-26","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Optional inclusive latest weekdate in YYYY-MM-DD format.","example":"2025-12-26","style":"form","explode":true}],"auth_required":true,"metered":true,"pricing_rule_id":"market_epoch_history","supported_rails":["subscription","x402","mpp"],"challenge_lifecycle":{"challenge_class":"fixed_price","serviceable_request_required_before_challenge":false,"serviceable_request_required_before_settlement":true,"bare_canonical_probe_returns_challenge":true,"availability_gate_precedes_challenge":false,"parameterized_resource":false},"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":"market_epoch_history","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":"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"],"challenge_lifecycle":{"challenge_class":"fixed_price","serviceable_request_required_before_challenge":false,"serviceable_request_required_before_settlement":true,"bare_canonical_probe_returns_challenge":true,"availability_gate_precedes_challenge":false,"parameterized_resource":false},"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,"description":"Maximum number of rows returned. When start and end are both omitted, a trailing 104-week window ending at the latest available weekdate is applied as well. The applied_bounds block on the response reports the window and limit that were actually used.","example":500,"default":500,"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":500,"minimum":1,"maximum":500000,"example":500,"description":"Maximum number of rows returned. When start and end are both omitted, a trailing 104-week window ending at the latest available weekdate is applied as well. The applied_bounds block on the response reports the window and limit that were actually used.","input_location":"query","parameter_source":"query"}},"safe_example_request":{"method":"GET","path":"/v1/stwr/reports/history","query":{"rpt":"bullcross","exchange":"N"}},"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,"description":"Maximum number of rows returned. When start and end are both omitted, a trailing 104-week window ending at the latest available weekdate is applied as well. The applied_bounds block on the response reports the window and limit that were actually used.","example":500,"default":500,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Maximum number of rows returned. When start and end are both omitted, a trailing 104-week window ending at the latest available weekdate is applied as well. The applied_bounds block on the response reports the window and limit that were actually used.","example":500,"style":"form","explode":true}],"auth_required":true,"metered":true,"pricing_rule_id":"stwr_reports_history_paid","supported_rails":["subscription","x402","mpp"],"challenge_lifecycle":{"challenge_class":"fixed_price","serviceable_request_required_before_challenge":false,"serviceable_request_required_before_settlement":true,"bare_canonical_probe_returns_challenge":true,"availability_gate_precedes_challenge":false,"parameterized_resource":false},"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"},"population":{"type":"string","enum":["equities","cs","all"],"description":"equities is canonical CS+UN; cs is CS only; all is the legacy unrestricted population.","default":"equities","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"cs_only":{"type":"boolean","description":"Legacy alias: omitted=equities, true=cs, false=all. Supplying a conflicting population is rejected.","example":null,"default":null,"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"},"population":{"type":"string","required":false,"enum":["equities","cs","all"],"safe_default":"equities","description":"equities is canonical CS+UN; cs is CS only; all is the legacy unrestricted population.","input_location":"query","parameter_source":"query"},"cs_only":{"type":"boolean","required":false,"safe_default":null,"example":null,"description":"Legacy alias: omitted=equities, true=cs, false=all. Supplying a conflicting population is rejected.","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":"population","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","enum":["equities","cs","all"],"description":"equities is canonical CS+UN; cs is CS only; all is the legacy unrestricted population.","default":"equities","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"equities is canonical CS+UN; cs is CS only; all is the legacy unrestricted population.","style":"form","explode":true},{"name":"cs_only","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"boolean","description":"Legacy alias: omitted=equities, true=cs, false=all. Supplying a conflicting population is rejected.","example":null,"default":null,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Legacy alias: omitted=equities, true=cs, false=all. Supplying a conflicting population is rejected.","example":null,"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"],"challenge_lifecycle":{"challenge_class":"fixed_price","serviceable_request_required_before_challenge":false,"serviceable_request_required_before_settlement":true,"bare_canonical_probe_returns_challenge":true,"availability_gate_precedes_challenge":false,"parameterized_resource":false},"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"},"population":{"type":"string","enum":["equities","cs","all"],"description":"equities is canonical CS+UN; cs is CS only; all is the legacy unrestricted population.","default":"equities","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"cs_only":{"type":"boolean","description":"Legacy alias: omitted=equities, true=cs, false=all. Supplying a conflicting population is rejected.","example":null,"default":null,"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,"description":"Maximum number of rows returned. When start and end are both omitted, a trailing 104-week window ending at the latest available weekdate is applied as well. The applied_bounds block on the response reports the window and limit that were actually used.","example":5000,"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":"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"},"population":{"type":"string","required":false,"enum":["equities","cs","all"],"safe_default":"equities","description":"equities is canonical CS+UN; cs is CS only; all is the legacy unrestricted population.","input_location":"query","parameter_source":"query"},"cs_only":{"type":"boolean","required":false,"safe_default":null,"example":null,"description":"Legacy alias: omitted=equities, true=cs, false=all. Supplying a conflicting population is rejected.","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":5000,"minimum":1,"maximum":500000,"example":5000,"description":"Maximum number of rows returned. When start and end are both omitted, a trailing 104-week window ending at the latest available weekdate is applied as well. The applied_bounds block on the response reports the window and limit that were actually used.","input_location":"query","parameter_source":"query"}},"safe_example_request":{"method":"GET","path":"/v1/breadth/sector/history","query":{"group_level":"sector","group_by_week":true}},"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":"population","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"string","enum":["equities","cs","all"],"description":"equities is canonical CS+UN; cs is CS only; all is the legacy unrestricted population.","default":"equities","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"equities is canonical CS+UN; cs is CS only; all is the legacy unrestricted population.","style":"form","explode":true},{"name":"cs_only","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"boolean","description":"Legacy alias: omitted=equities, true=cs, false=all. Supplying a conflicting population is rejected.","example":null,"default":null,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Legacy alias: omitted=equities, true=cs, false=all. Supplying a conflicting population is rejected.","example":null,"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,"description":"Maximum number of rows returned. When start and end are both omitted, a trailing 104-week window ending at the latest available weekdate is applied as well. The applied_bounds block on the response reports the window and limit that were actually used.","example":5000,"default":5000,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Maximum number of rows returned. When start and end are both omitted, a trailing 104-week window ending at the latest available weekdate is applied as well. The applied_bounds block on the response reports the window and limit that were actually used.","example":5000,"style":"form","explode":true}],"auth_required":true,"metered":true,"pricing_rule_id":"breadth_sector_history_paid","supported_rails":["subscription","x402","mpp"],"challenge_lifecycle":{"challenge_class":"fixed_price","serviceable_request_required_before_challenge":false,"serviceable_request_required_before_settlement":true,"bare_canonical_probe_returns_challenge":true,"availability_gate_precedes_challenge":false,"parameterized_resource":false},"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; EQ is not supported on this CS-compatible summary endpoint.","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; EQ is not supported on this CS-compatible summary endpoint.","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; EQ is not supported on this CS-compatible summary endpoint.","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; EQ is not supported on this CS-compatible summary endpoint.","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"],"challenge_lifecycle":{"challenge_class":"fixed_price","serviceable_request_required_before_challenge":false,"serviceable_request_required_before_settlement":true,"bare_canonical_probe_returns_challenge":true,"availability_gate_precedes_challenge":false,"parameterized_resource":false},"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, or * for the canonical A/N/Q/T aggregate.","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":"Canonical rotation population. EQ (CS+UN) is the default; CS remains available for compatibility.","example":"EQ","default":"EQ","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"},"limit":{"type":"integer","minimum":1,"maximum":50000,"description":"Maximum number of rows returned. When start and end are both omitted, a trailing 104-week window ending at the latest available weekdate is applied as well. The applied_bounds block on the response reports the window and limit that were actually used.","example":2000,"default":2000,"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, or * for the canonical A/N/Q/T aggregate.","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":"EQ","example":"EQ","description":"Canonical rotation population. EQ (CS+UN) is the default; CS remains available for compatibility.","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"},"limit":{"type":"integer","required":false,"safe_default":2000,"minimum":1,"maximum":50000,"example":2000,"description":"Maximum number of rows returned. When start and end are both omitted, a trailing 104-week window ending at the latest available weekdate is applied as well. The applied_bounds block on the response reports the window and limit that were actually used.","input_location":"query","parameter_source":"query"}},"safe_example_request":{"method":"GET","path":"/v1/leadership/rotation/history","query":{"exchange":"N","type":"EQ","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, or * for the canonical A/N/Q/T aggregate.","example":"N","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Stock Trends exchange suffix, or * for the canonical A/N/Q/T aggregate.","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":"Canonical rotation population. EQ (CS+UN) is the default; CS remains available for compatibility.","example":"EQ","default":"EQ","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Canonical rotation population. EQ (CS+UN) is the default; CS remains available for compatibility.","example":"EQ","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},{"name":"limit","in":"query","input_location":"query","parameter_source":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50000,"description":"Maximum number of rows returned. When start and end are both omitted, a trailing 104-week window ending at the latest available weekdate is applied as well. The applied_bounds block on the response reports the window and limit that were actually used.","example":2000,"default":2000,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"description":"Maximum number of rows returned. When start and end are both omitted, a trailing 104-week window ending at the latest available weekdate is applied as well. The applied_bounds block on the response reports the window and limit that were actually used.","example":2000,"style":"form","explode":true}],"auth_required":true,"metered":true,"pricing_rule_id":"leadership_rotation_history_paid","supported_rails":["subscription","x402","mpp"],"challenge_lifecycle":{"challenge_class":"fixed_price","serviceable_request_required_before_challenge":false,"serviceable_request_required_before_settlement":true,"bare_canonical_probe_returns_challenge":true,"availability_gate_precedes_challenge":false,"parameterized_resource":false},"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"],"challenge_lifecycle":{"challenge_class":"availability_gated","serviceable_request_required_before_challenge":true,"serviceable_request_required_before_settlement":true,"bare_canonical_probe_returns_challenge":false,"availability_gate_precedes_challenge":true,"parameterized_resource":false},"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"],"challenge_lifecycle":{"challenge_class":"availability_gated","serviceable_request_required_before_challenge":true,"serviceable_request_required_before_settlement":true,"bare_canonical_probe_returns_challenge":false,"availability_gate_precedes_challenge":true,"parameterized_resource":true},"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"],"challenge_lifecycle":{"challenge_class":"availability_gated","serviceable_request_required_before_challenge":true,"serviceable_request_required_before_settlement":true,"bare_canonical_probe_returns_challenge":false,"availability_gate_precedes_challenge":true,"parameterized_resource":false},"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"],"challenge_lifecycle":{"challenge_class":"availability_gated","serviceable_request_required_before_challenge":true,"serviceable_request_required_before_settlement":true,"bare_canonical_probe_returns_challenge":false,"availability_gate_precedes_challenge":true,"parameterized_resource":true},"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":[],"stock_trends_supplies":[],"researcher_supplied_steps":[],"not_provided_by_this_api":[],"success_condition":null,"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":[],"stock_trends_supplies":[],"researcher_supplied_steps":[],"not_provided_by_this_api":[],"success_condition":null,"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."],"stock_trends_supplies":[],"researcher_supplied_steps":[],"not_provided_by_this_api":[],"success_condition":null,"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":[],"stock_trends_supplies":[],"researcher_supplied_steps":[],"not_provided_by_this_api":[],"success_condition":null,"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":[],"stock_trends_supplies":[],"researcher_supplied_steps":[],"not_provided_by_this_api":[],"success_condition":null,"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."},{"workflow_id":"historical_signal_validation","name":"Historical Signal Validation and Model Integration Review","description":"Retrieve bounded historical Stock Trends observations across the instrument, cross-sectional, market-regime and inference layers so an external research system, forecasting model, portfolio system or agent can evaluate whether Stock Trends context adds information beyond its own existing baseline.","tags":["agent","research","historical","validation","integration"],"supported_rails":["subscription","x402","mpp"],"step_count":10,"pricing_rule_ids":["indicators_history_paid","market_regime_history","breadth_sector_history_paid","leadership_rotation_history_paid","prices_history_paid","stim_history_paid"],"best_for":"Evaluating Stock Trends as a candidate contextual feature or data layer for an external model or research process.","analytical_role":"research_validation_workflow","research_goal":"Assemble the Stock Trends side of a historical evaluation: point-in-time observations, the semantics needed to interpret them, and the published evidence describing what has already been measured.","agent_goal_examples":["Assemble a historical Stock Trends feature set aligned on weekdate for a researcher-defined forward-return target.","Compare Stock Trends classification, breadth, leadership and regime context against an existing baseline feature set over a defined historical period.","Check whether a measured contribution holds across different market regimes before deciding on recurring integration."],"symbol_selection_guidance":"Instrument-level steps take symbol_exchange. Resolve tickers through /v1/instruments/lookup or /v1/instruments/resolve first and reuse the returned symbol_exchange. The cross-sectional, regime and evidence steps are market-level and take no symbol.","interpretation_guidance":"Stock Trends observations are weekly classification states keyed on weekdate; weekdate is the alignment key for any join the caller performs. Read /v1/meta/indicators for indicator semantics and /v1/meta/inference for the provider-agnostic inference contract before treating any field as a feature. ST-IM is one inference provider over the classification framework rather than the framework itself, so the instrument, breadth, leadership and regime layers are evaluated on their own terms and not only through ST-IM. Historical depth supports comparability across market environments; it does not establish that any measured relationship will persist.","required_interpretation_steps":["Call GET /v1/meta/indicators before treating trend, trend_cnt, mt_cnt, rsi, rsi_updn or vol_tag as features.","Call GET /v1/meta/inference before interpreting any provider-specific inference output.","Call GET /v1/meta/stim before interpreting ST-IM fields, if ST-IM history is used.","Treat weekdate as the point-in-time key; each row describes the week it is keyed on.","Read applied_bounds on every history response to confirm the date bounds and row limit that were actually applied, and whether the result was truncated.","GET /v1/market/regime/history returns at most 52 recent weekly observations and start_date only raises the earliest eligible week; it does not page backwards. Do not assume it covers the chosen research period.","If ST-IM Select outcome evidence is used, interpret it as an aggregate measurement of one stated signal rule over a stated population, not as a portfolio result, a forecast, or evidence about the broader classification layers."],"stock_trends_supplies":["Point-in-time weekly historical observations for the instrument, cross-sectional, market-regime and inference layers, each bounded and each reporting its applied_bounds.","Interpretation semantics and field definitions for those observations.","Published evidence families, each carrying its own methodology and limitations, mapped at /v1/ai/context.","weekdate as a consistent alignment key across all layers.","Explicit applied_bounds describing the window and row limit each response was produced under."],"researcher_supplied_steps":["Define the historical research period appropriate to the question.","Define the target, outcome definition and forecast horizon being predicted.","Perform the join between Stock Trends observations and that target.","Enforce point-in-time discipline and avoid look-ahead leakage in that join.","Define the existing baseline or feature set the comparison is against.","Measure any incremental contribution over that baseline.","Examine stability across market regimes or other relevant contexts, supplying the researcher's own regime segmentation for any period the 52-week regime endpoint does not cover.","Separate in-sample exploration from out-of-sample validation.","Decide whether the measured contribution justifies recurring integration."],"not_provided_by_this_api":["bulk dataset download","model training or fitting","automatic feature engineering","joins to external targets or datasets","backtesting or portfolio simulation","statistical significance testing","causal validation"],"success_condition":"The caller can state, from the material actually retrieved, whether a measured incremental contribution was stable enough to justify recurring use. A completed evaluation is the success condition; a positive result is not asserted, implied, or required.","next_step_guidance":["Use /v1/cost-estimate to bound the STC cost of the paid steps before executing them.","Use /v1/instruments/resolve to produce symbol_exchange values for the instrument-level steps.","Use the regime_analysis or portfolio_build workflows instead if the goal turns out to be current market context rather than historical evaluation."],"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":{"content_type":"access_and_discovery_mechanics","proof_endpoint":"/v1/ai/proof/market-edge","schema_illustration_endpoint":"/v1/ai/proof/market-edge","schema_illustration_description":"Free, non-metered. Returns a static synthetic body illustrating response structure and field semantics. It is an illustration, not evidence: it measures no outcome and demonstrates no usefulness.","conversion_steps":[{"step":1,"call":"GET /.well-known/x402","note":"Canonical payable-resource discovery. Public, non-metered."},{"step":2,"call":"GET /v1/ai/proof/market-edge","note":"No auth needed. Inspect response structure and confirm field schemas."},{"step":3,"call":"GET /v1/workflows","note":"Choose a strategy and endpoint sequence for the research task."},{"step":4,"call":"GET /v1/pricing/catalog","note":"Resolve live STC costs for target endpoints."},{"step":5,"call":"GET /v1/pricing","note":"Inspect payment rails, identity headers, and accepted payment method guidance."},{"step":6,"call":"GET /v1/agent/screener/top","note":"A paid call, once a task has been chosen. 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 /.well-known/x402 for payable-resource discovery, then use /v1/ai/tools for task and tool discovery.","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; it is the final pre-payment surface, not an input-schema reference — use /v1/ai/tools or /v1/openapi.json to make the request serviceable before paying, which is not a precondition for receiving the challenge.","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."]}