{"schema":"stocktrends.x402-discovery.v1","complete":true,"membership":"all_endpoint_payment_policies_with_effective_remaining_rails","canonical_url":"https://api.stocktrends.com/.well-known/x402","compatibility_aliases":["https://api.stocktrends.com/.well-known/x402","https://api.stocktrends.com/.well-known/x402.json","https://api.stocktrends.com/.well-known/x402-discovery","https://api.stocktrends.com/.well-known/x402-services.json"],"service":{"name":"Stock Trends Market Intelligence","api_base_url":"https://api.stocktrends.com/v1","openapi_url":"https://api.stocktrends.com/v1/openapi.json","x402_discovery_url":"https://api.stocktrends.com/.well-known/x402","ai_tools_url":"https://api.stocktrends.com/v1/ai/tools","workflows_url":"https://api.stocktrends.com/v1/workflows","pricing_catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","ai_context_url":"https://api.stocktrends.com/v1/ai/context"},"acquisition_evaluation":{"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":["https://api.stocktrends.com/.well-known/x402","https://api.stocktrends.com/v1/ai/tools","https://api.stocktrends.com/v1/workflows"],"how_to_interpret_it":["https://api.stocktrends.com/v1/meta/inference","https://api.stocktrends.com/v1/meta/stim","https://api.stocktrends.com/v1/meta/indicators"],"what_evidence_exists":["https://api.stocktrends.com/v1/selections/stim-select/outcomes/summary","https://api.stocktrends.com/v1/stocktrends/portfolios"],"what_it_costs":["https://api.stocktrends.com/v1/pricing/catalog","https://api.stocktrends.com/v1/cost-estimate"]},"category_separation":"A service description is not methodology, and methodology is not evidence. Read each from its own source.","availability_is_not_evidence":"Listing a resource here 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. Reading them does not execute paid work.","decision_is_the_callers":"This describes how to evaluate. It states no conclusion and recommends acquiring nothing.","illustrative_capability_example":{"endpoint":"https://api.stocktrends.com/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"}},"x402":{"versions_supported":[2],"payment":{"version":2,"scheme":"exact","network":"eip155:8453","asset":{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","name":"USD Coin","version":"2","decimals":6,"transfer_method":"eip3009"},"proof_headers":["PAYMENT-SIGNATURE","X-Payment"],"pay_to":"0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab"}},"request_lifecycle":{"serviceable_request_required_before_challenge_scope":"eligible recognized fixed-price resources only","serviceable_request_required_before_challenge_for_fixed_price":false,"serviceable_request_required_before_settlement":true,"per_resource_precondition_field":"resources[].challenge_lifecycle","statement":"A 402 challenge quotes a price and describes a resource; it moves no money. For an eligible recognized fixed-price payable resource presented with no payment proof, it is issued before application-input validation. Availability-gated resources resolve artifact availability first and may answer 404 or 503 instead; parameterized resources have no bare canonical URL to probe. Routing, parsing, schema validation, and request-only semantic validation all run before any payment verification or settlement, on every resource and every rail.","discovery_is_execution_free":true},"payment_architecture":{"pricing_unit":"STC","pricing_source":"https://api.stocktrends.com/v1/pricing/catalog","rails_are_transport_not_pricing":true,"runtime_supported_rails":["mpp","subscription","x402"],"mpp_is_session_based_not_x402_challenge_based":true},"resources":[{"method":"GET","path":"/v1/agent/screener/top","url":"https://api.stocktrends.com/v1/agent/screener/top","name":"screener_top","title":"Agent Screener Top","description":"Stock screener for finding and ranking stronger or persistent trend equity candidates using Stock Trends trend state, trend persistence, trend maturity, relative performance, and volume signal fields.","analytical_role":"market_intelligence_filter","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"},"safe_example_request":{"method":"GET","path":"/v1/agent/screener/top","query":{"limit":10,"min_rsi":40}},"pricing_rule_id":"agent_screener_top","supported_rails":["subscription","x402","mpp"],"anonymous_x402_challenge_supported":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},"pricing_catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","pricing":{"source":"stc_pricing_catalog","pricing_rule_id":"agent_screener_top","catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","live_cost_included":false},"availability":{"classification":"immediately_discoverable","serviceable_example_outcome":"402_without_payment_proof","possible_unpaid_statuses":[402]},"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."},"x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","name":"USD Coin","version":"2","decimals":6,"transfer_method":"eip3009"},"proof_headers":["PAYMENT-SIGNATURE","X-Payment"],"pay_to":"0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab"}},{"method":"GET","path":"/v1/breadth/sector/history","url":"https://api.stocktrends.com/v1/breadth/sector/history","name":"breadth_sector_history","title":"Sector Breadth History","description":"Historical sector, industry-group, or industry breadth series. Default canonical equity history is CS+UN across A/N/Q/T.","analytical_role":"market_breadth_context","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"},"safe_example_request":{"method":"GET","path":"/v1/breadth/sector/history","query":{"group_level":"sector","group_by_week":true}},"pricing_rule_id":"breadth_sector_history_paid","supported_rails":["subscription","x402","mpp"],"anonymous_x402_challenge_supported":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},"pricing_catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","pricing":{"source":"stc_pricing_catalog","pricing_rule_id":"breadth_sector_history_paid","catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","live_cost_included":false},"availability":{"classification":"immediately_discoverable","serviceable_example_outcome":"402_without_payment_proof","possible_unpaid_statuses":[402]},"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."},"x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","name":"USD Coin","version":"2","decimals":6,"transfer_method":"eip3009"},"proof_headers":["PAYMENT-SIGNATURE","X-Payment"],"pay_to":"0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab"}},{"method":"GET","path":"/v1/breadth/sector/latest","url":"https://api.stocktrends.com/v1/breadth/sector/latest","name":"breadth_sector_latest","title":"Sector Breadth Latest","description":"Latest sector, industry-group, or industry breadth snapshot. The default canonical population is CS+UN equities across A/N/Q/T.","analytical_role":"market_breadth_context","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"},"safe_example_request":{"method":"GET","path":"/v1/breadth/sector/latest","query":{"group_level":"sector","limit":5000}},"pricing_rule_id":"breadth_sector_latest_paid","supported_rails":["subscription","x402","mpp"],"anonymous_x402_challenge_supported":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},"pricing_catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","pricing":{"source":"stc_pricing_catalog","pricing_rule_id":"breadth_sector_latest_paid","catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","live_cost_included":false},"availability":{"classification":"immediately_discoverable","serviceable_example_outcome":"402_without_payment_proof","possible_unpaid_statuses":[402]},"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."},"x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","name":"USD Coin","version":"2","decimals":6,"transfer_method":"eip3009"},"proof_headers":["PAYMENT-SIGNATURE","X-Payment"],"pay_to":"0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab"}},{"method":"POST","path":"/v1/decision/evaluate-symbol","url":"https://api.stocktrends.com/v1/decision/evaluate-symbol","name":"evaluate_symbol","title":"Symbol Decision Evaluation","description":"Deterministic pre-trade stock analysis and equity evaluation combining Stock Trends signal context with market regime context for investment research and decision support.","analytical_role":"symbol_decision_engine","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":"body","x-stocktrends-parameter-source":"body"},"symbol":{"type":"string","description":"Ticker symbol. Use with exchange when symbol_exchange is not supplied.","example":"IBM","x-stocktrends-input-location":"body","x-stocktrends-parameter-source":"body"},"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":"body","x-stocktrends-parameter-source":"body"}},"required":["symbol_exchange"],"x-stocktrends-input-location":"body","x-stocktrends-parameter-source":"body","description":"POST body may provide symbol_exchange, or symbol plus exchange."},"safe_example_request":{"method":"POST","path":"/v1/decision/evaluate-symbol","json":{"symbol_exchange":"IBM-N"}},"pricing_rule_id":"evaluate_symbol","supported_rails":["subscription","x402","mpp"],"anonymous_x402_challenge_supported":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},"pricing_catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","pricing":{"source":"stc_pricing_catalog","pricing_rule_id":"evaluate_symbol","catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","live_cost_included":false},"availability":{"classification":"immediately_discoverable","serviceable_example_outcome":"402_without_payment_proof","possible_unpaid_statuses":[402]},"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."},"x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","name":"USD Coin","version":"2","decimals":6,"transfer_method":"eip3009"},"proof_headers":["PAYMENT-SIGNATURE","X-Payment"],"pay_to":"0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab"}},{"method":"GET","path":"/v1/indicators/history","url":"https://api.stocktrends.com/v1/indicators/history","name":"indicators_history","title":"Indicators History","description":"Historical weekly Stock Trends indicator series for a symbol. Stock Trends indicators are part of a multi-decade classification framework with records extending back to 1980. Their value comes from consistent semantics across market history: trend state, trend persistence, relative performance, relative performance direction, and volume activity are encoded in a stable doctrine designed for longitudinal research.","analytical_role":"symbol_signal_intelligence","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."},"safe_example_request":{"method":"GET","path":"/v1/indicators/history","query":{"symbol_exchange":"IBM-N","limit":52,"cs_only":true}},"pricing_rule_id":"indicators_history_paid","supported_rails":["subscription","x402","mpp"],"anonymous_x402_challenge_supported":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},"pricing_catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","pricing":{"source":"stc_pricing_catalog","pricing_rule_id":"indicators_history_paid","catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","live_cost_included":false},"availability":{"classification":"immediately_discoverable","serviceable_example_outcome":"402_without_payment_proof","possible_unpaid_statuses":[402]},"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."},"x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","name":"USD Coin","version":"2","decimals":6,"transfer_method":"eip3009"},"proof_headers":["PAYMENT-SIGNATURE","X-Payment"],"pay_to":"0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab"}},{"method":"GET","path":"/v1/indicators/latest","url":"https://api.stocktrends.com/v1/indicators/latest","name":"indicators_latest","title":"Indicators Latest","description":"Current weekly stock analytics for equity research and pre-trade analysis. Returns the latest Stock Trends indicator snapshot for a symbol. Stock Trends indicators are part of a multi-decade classification framework with records extending back to 1980. Their value comes from consistent semantics across market history: trend state, trend persistence, relative performance, relative performance direction, and volume activity are encoded in a stable doctrine designed for longitudinal research.","analytical_role":"symbol_signal_intelligence","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."},"safe_example_request":{"method":"GET","path":"/v1/indicators/latest","query":{"symbol_exchange":"IBM-N","cs_only":true}},"pricing_rule_id":"indicators_latest_paid","supported_rails":["subscription","x402","mpp"],"anonymous_x402_challenge_supported":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},"pricing_catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","pricing":{"source":"stc_pricing_catalog","pricing_rule_id":"indicators_latest_paid","catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","live_cost_included":false},"availability":{"classification":"immediately_discoverable","serviceable_example_outcome":"402_without_payment_proof","possible_unpaid_statuses":[402]},"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."},"x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","name":"USD Coin","version":"2","decimals":6,"transfer_method":"eip3009"},"proof_headers":["PAYMENT-SIGNATURE","X-Payment"],"pay_to":"0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab"}},{"method":"GET","path":"/v1/intelligence/guidance/latest","url":"https://api.stocktrends.com/v1/intelligence/guidance/latest","name":"intelligence_guidance_latest","title":"Intelligence Guidance Latest","description":"Latest paid Stock Trends market guidance artifact served from exported PublicArtifactEnvelope.v1 files. The API validates schema, content hash, and publication status before serving and does not call Agent internals.","analytical_role":"published_intelligence_artifact","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."},"safe_example_request":{"method":"GET","path":"/v1/intelligence/guidance/latest","query":{}},"pricing_rule_id":"intelligence_guidance_latest","supported_rails":["subscription","x402","mpp"],"anonymous_x402_challenge_supported":true,"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},"pricing_catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","pricing":{"source":"stc_pricing_catalog","pricing_rule_id":"intelligence_guidance_latest","catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","live_cost_included":false},"availability":{"classification":"pre_payment_availability_gated","serviceable_example_outcome":"402_when_available_otherwise_404_or_503","reason":"A matching validated and serveable published artifact must exist before the payment gate is reached.","possible_unpaid_statuses":[402,404,503]},"x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","name":"USD Coin","version":"2","decimals":6,"transfer_method":"eip3009"},"proof_headers":["PAYMENT-SIGNATURE","X-Payment"],"pay_to":"0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab"}},{"method":"GET","path":"/v1/intelligence/guidance/{artifact_id}","url":"https://api.stocktrends.com/v1/intelligence/guidance/{artifact_id}","name":"intelligence_guidance_by_id","title":"Intelligence Guidance By ID","description":"Paid Stock Trends market guidance artifact lookup by manifest artifact_id. Only same-type, serveable, hash-verified PublicArtifactEnvelope.v1 exports are returned.","analytical_role":"published_intelligence_artifact","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."},"safe_example_request":{"method":"GET","path":"/v1/intelligence/guidance/market_guidance:N:YYYY-MM-DD:guidance:example","query":{}},"pricing_rule_id":"intelligence_guidance_by_id","supported_rails":["subscription","x402","mpp"],"anonymous_x402_challenge_supported":true,"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},"pricing_catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","pricing":{"source":"stc_pricing_catalog","pricing_rule_id":"intelligence_guidance_by_id","catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","live_cost_included":false},"availability":{"classification":"pre_payment_availability_gated","serviceable_example_outcome":"402_when_available_otherwise_404_or_503","reason":"A matching validated and serveable published artifact must exist before the payment gate is reached.","possible_unpaid_statuses":[402,404,503]},"x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","name":"USD Coin","version":"2","decimals":6,"transfer_method":"eip3009"},"proof_headers":["PAYMENT-SIGNATURE","X-Payment"],"pay_to":"0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab"}},{"method":"GET","path":"/v1/intelligence/research/latest","url":"https://api.stocktrends.com/v1/intelligence/research/latest","name":"intelligence_research_latest","title":"Intelligence Research Latest","description":"Latest paid Stock Trends market research artifact served from exported PublicArtifactEnvelope.v1 files. The API validates schema, content hash, and publication status before serving and does not call Agent internals.","analytical_role":"published_intelligence_artifact","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."},"safe_example_request":{"method":"GET","path":"/v1/intelligence/research/latest","query":{}},"pricing_rule_id":"intelligence_research_latest","supported_rails":["subscription","x402","mpp"],"anonymous_x402_challenge_supported":true,"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},"pricing_catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","pricing":{"source":"stc_pricing_catalog","pricing_rule_id":"intelligence_research_latest","catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","live_cost_included":false},"availability":{"classification":"pre_payment_availability_gated","serviceable_example_outcome":"402_when_available_otherwise_404_or_503","reason":"A matching validated and serveable published artifact must exist before the payment gate is reached.","possible_unpaid_statuses":[402,404,503]},"x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","name":"USD Coin","version":"2","decimals":6,"transfer_method":"eip3009"},"proof_headers":["PAYMENT-SIGNATURE","X-Payment"],"pay_to":"0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab"}},{"method":"GET","path":"/v1/intelligence/research/{artifact_id}","url":"https://api.stocktrends.com/v1/intelligence/research/{artifact_id}","name":"intelligence_research_by_id","title":"Intelligence Research By ID","description":"Paid Stock Trends market research artifact lookup by manifest artifact_id. Only same-type, serveable, hash-verified PublicArtifactEnvelope.v1 exports are returned.","analytical_role":"published_intelligence_artifact","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."},"safe_example_request":{"method":"GET","path":"/v1/intelligence/research/market_research_report:N:YYYY-MM-DD:research:example","query":{}},"pricing_rule_id":"intelligence_research_by_id","supported_rails":["subscription","x402","mpp"],"anonymous_x402_challenge_supported":true,"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},"pricing_catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","pricing":{"source":"stc_pricing_catalog","pricing_rule_id":"intelligence_research_by_id","catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","live_cost_included":false},"availability":{"classification":"pre_payment_availability_gated","serviceable_example_outcome":"402_when_available_otherwise_404_or_503","reason":"A matching validated and serveable published artifact must exist before the payment gate is reached.","possible_unpaid_statuses":[402,404,503]},"x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","name":"USD Coin","version":"2","decimals":6,"transfer_method":"eip3009"},"proof_headers":["PAYMENT-SIGNATURE","X-Payment"],"pay_to":"0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab"}},{"method":"GET","path":"/v1/leadership/rotation/history","url":"https://api.stocktrends.com/v1/leadership/rotation/history","name":"leadership_rotation_history","title":"Leadership Rotation History","description":"Historical sector leadership rotation derived from Stock Trends trend distribution, relative performance, and trend maturity measures.","analytical_role":"leadership_intelligence","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"},"safe_example_request":{"method":"GET","path":"/v1/leadership/rotation/history","query":{"exchange":"N","type":"EQ","top_k":5,"group_by_week":true}},"pricing_rule_id":"leadership_rotation_history_paid","supported_rails":["subscription","x402","mpp"],"anonymous_x402_challenge_supported":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},"pricing_catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","pricing":{"source":"stc_pricing_catalog","pricing_rule_id":"leadership_rotation_history_paid","catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","live_cost_included":false},"availability":{"classification":"immediately_discoverable","serviceable_example_outcome":"402_without_payment_proof","possible_unpaid_statuses":[402]},"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."},"x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","name":"USD Coin","version":"2","decimals":6,"transfer_method":"eip3009"},"proof_headers":["PAYMENT-SIGNATURE","X-Payment"],"pay_to":"0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab"}},{"method":"GET","path":"/v1/leadership/summary/latest","url":"https://api.stocktrends.com/v1/leadership/summary/latest","name":"leadership_summary_latest","title":"Leadership Summary Latest","description":"Latest Stock Trends leadership summary identifying overall, sector, and industry-group leaders using relative performance and trend-alignment filters.","analytical_role":"leadership_intelligence","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"},"safe_example_request":{"method":"GET","path":"/v1/leadership/summary/latest","query":{"exchange":"N","type":"CS","min_rsi":40,"min_mt_cnt":4}},"pricing_rule_id":"leadership_summary_latest_paid","supported_rails":["subscription","x402","mpp"],"anonymous_x402_challenge_supported":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},"pricing_catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","pricing":{"source":"stc_pricing_catalog","pricing_rule_id":"leadership_summary_latest_paid","catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","live_cost_included":false},"availability":{"classification":"immediately_discoverable","serviceable_example_outcome":"402_without_payment_proof","possible_unpaid_statuses":[402]},"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."},"x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","name":"USD Coin","version":"2","decimals":6,"transfer_method":"eip3009"},"proof_headers":["PAYMENT-SIGNATURE","X-Payment"],"pay_to":"0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab"}},{"method":"GET","path":"/v1/market/epoch/history","url":"https://api.stocktrends.com/v1/market/epoch/history","name":"market_epoch_history","title":"Market Epoch History","description":"Newest-first persisted Market Epoch v1 history from a frozen unsupervised K=3 market-state classifier based on six aggregate weekly Stock Trends features.","analytical_role":"market_epoch_classifier","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"},"safe_example_request":{"method":"GET","path":"/v1/market/epoch/history","query":{"limit":52}},"pricing_rule_id":"market_epoch_history","supported_rails":["subscription","x402","mpp"],"anonymous_x402_challenge_supported":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},"pricing_catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","pricing":{"source":"stc_pricing_catalog","pricing_rule_id":"market_epoch_history","catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","live_cost_included":false},"availability":{"classification":"immediately_discoverable","serviceable_example_outcome":"402_without_payment_proof","possible_unpaid_statuses":[402]},"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."},"x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","name":"USD Coin","version":"2","decimals":6,"transfer_method":"eip3009"},"proof_headers":["PAYMENT-SIGNATURE","X-Payment"],"pay_to":"0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab"}},{"method":"GET","path":"/v1/market/epoch/latest","url":"https://api.stocktrends.com/v1/market/epoch/latest","name":"market_epoch_latest","title":"Market Epoch Latest","description":"Latest persisted Market Epoch v1 snapshot from a frozen unsupervised K=3 market-state classifier based on six aggregate weekly Stock Trends features.","analytical_role":"market_epoch_classifier","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."},"safe_example_request":{"method":"GET","path":"/v1/market/epoch/latest","query":{}},"pricing_rule_id":"market_epoch_latest","supported_rails":["subscription","x402","mpp"],"anonymous_x402_challenge_supported":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},"pricing_catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","pricing":{"source":"stc_pricing_catalog","pricing_rule_id":"market_epoch_latest","catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","live_cost_included":false},"availability":{"classification":"immediately_discoverable","serviceable_example_outcome":"402_without_payment_proof","possible_unpaid_statuses":[402]},"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."},"x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","name":"USD Coin","version":"2","decimals":6,"transfer_method":"eip3009"},"proof_headers":["PAYMENT-SIGNATURE","X-Payment"],"pay_to":"0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab"}},{"method":"GET","path":"/v1/market/regime/forecast","url":"https://api.stocktrends.com/v1/market/regime/forecast","name":"market_regime_forecast","title":"Market Regime Forecast","description":"Deterministic forward regime outlook derived from recent weekly regime score direction and consistency.","analytical_role":"market_regime_classifier","input_schema":{"type":"object","properties":{"lookback":{"type":"integer","minimum":2,"maximum":13,"default":5,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"}},"required":[],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"safe_example_request":{"method":"GET","path":"/v1/market/regime/forecast","query":{"lookback":5}},"pricing_rule_id":"market_regime_forecast","supported_rails":["subscription","x402","mpp"],"anonymous_x402_challenge_supported":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},"pricing_catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","pricing":{"source":"stc_pricing_catalog","pricing_rule_id":"market_regime_forecast","catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","live_cost_included":false},"availability":{"classification":"immediately_discoverable","serviceable_example_outcome":"402_without_payment_proof","possible_unpaid_statuses":[402]},"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."},"x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","name":"USD Coin","version":"2","decimals":6,"transfer_method":"eip3009"},"proof_headers":["PAYMENT-SIGNATURE","X-Payment"],"pay_to":"0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab"}},{"method":"GET","path":"/v1/market/regime/history","url":"https://api.stocktrends.com/v1/market/regime/history","name":"market_regime_history","title":"Market Regime History","description":"Historical sequence of weekly market regime classifications for canonical CS+UN equities across A/N/Q/T.","analytical_role":"market_regime_classifier","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"},"safe_example_request":{"method":"GET","path":"/v1/market/regime/history","query":{"limit":12}},"pricing_rule_id":"market_regime_history","supported_rails":["subscription","x402","mpp"],"anonymous_x402_challenge_supported":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},"pricing_catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","pricing":{"source":"stc_pricing_catalog","pricing_rule_id":"market_regime_history","catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","live_cost_included":false},"availability":{"classification":"immediately_discoverable","serviceable_example_outcome":"402_without_payment_proof","possible_unpaid_statuses":[402]},"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."},"x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","name":"USD Coin","version":"2","decimals":6,"transfer_method":"eip3009"},"proof_headers":["PAYMENT-SIGNATURE","X-Payment"],"pay_to":"0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab"}},{"method":"GET","path":"/v1/market/regime/latest","url":"https://api.stocktrends.com/v1/market/regime/latest","name":"market_regime_latest","title":"Market Regime Latest","description":"Current market regime classification from directional Stock Trends trend states for canonical CS+UN equities across A/N/Q/T.","analytical_role":"market_regime_classifier","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."},"safe_example_request":{"method":"GET","path":"/v1/market/regime/latest","query":{}},"pricing_rule_id":"market_regime_latest","supported_rails":["subscription","x402","mpp"],"anonymous_x402_challenge_supported":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},"pricing_catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","pricing":{"source":"stc_pricing_catalog","pricing_rule_id":"market_regime_latest","catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","live_cost_included":false},"availability":{"classification":"immediately_discoverable","serviceable_example_outcome":"402_without_payment_proof","possible_unpaid_statuses":[402]},"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."},"x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","name":"USD Coin","version":"2","decimals":6,"transfer_method":"eip3009"},"proof_headers":["PAYMENT-SIGNATURE","X-Payment"],"pay_to":"0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab"}},{"method":"POST","path":"/v1/portfolio/compare","url":"https://api.stocktrends.com/v1/portfolio/compare","name":"portfolio_compare","title":"Portfolio Compare","description":"Compares two user-supplied portfolios using Stock Trends decision scoring, alignment, and regime context.","analytical_role":"portfolio_evaluation_engine","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"},"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}]}},"pricing_rule_id":"portfolio_compare","supported_rails":["subscription","x402","mpp"],"anonymous_x402_challenge_supported":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},"pricing_catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","pricing":{"source":"stc_pricing_catalog","pricing_rule_id":"portfolio_compare","catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","live_cost_included":false},"availability":{"classification":"immediately_discoverable","serviceable_example_outcome":"402_without_payment_proof","possible_unpaid_statuses":[402]},"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."},"x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","name":"USD Coin","version":"2","decimals":6,"transfer_method":"eip3009"},"proof_headers":["PAYMENT-SIGNATURE","X-Payment"],"pay_to":"0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab"}},{"method":"POST","path":"/v1/portfolio/construct","url":"https://api.stocktrends.com/v1/portfolio/construct","name":"portfolio_construct","title":"Portfolio Construct","description":"Constructs a deterministic equal-weight portfolio from eligible Stock Trends signal candidates.","analytical_role":"portfolio_construction_engine","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"},"safe_example_request":{"method":"POST","path":"/v1/portfolio/construct","json":{"universe":"top","count":5,"bias":"auto"}},"pricing_rule_id":"portfolio_construct","supported_rails":["subscription","x402","mpp"],"anonymous_x402_challenge_supported":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},"pricing_catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","pricing":{"source":"stc_pricing_catalog","pricing_rule_id":"portfolio_construct","catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","live_cost_included":false},"availability":{"classification":"immediately_discoverable","serviceable_example_outcome":"402_without_payment_proof","possible_unpaid_statuses":[402]},"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."},"x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","name":"USD Coin","version":"2","decimals":6,"transfer_method":"eip3009"},"proof_headers":["PAYMENT-SIGNATURE","X-Payment"],"pay_to":"0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab"}},{"method":"POST","path":"/v1/portfolio/evaluate","url":"https://api.stocktrends.com/v1/portfolio/evaluate","name":"portfolio_evaluate","title":"Portfolio Evaluate","description":"Evaluates a user-supplied portfolio against Stock Trends signal and market regime context.","analytical_role":"portfolio_evaluation_engine","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"},"safe_example_request":{"method":"POST","path":"/v1/portfolio/evaluate","json":{"positions":[{"symbol_exchange":"IBM-N","weight":1.0}]}},"pricing_rule_id":"portfolio_evaluate","supported_rails":["subscription","x402","mpp"],"anonymous_x402_challenge_supported":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},"pricing_catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","pricing":{"source":"stc_pricing_catalog","pricing_rule_id":"portfolio_evaluate","catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","live_cost_included":false},"availability":{"classification":"immediately_discoverable","serviceable_example_outcome":"402_without_payment_proof","possible_unpaid_statuses":[402]},"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."},"x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","name":"USD Coin","version":"2","decimals":6,"transfer_method":"eip3009"},"proof_headers":["PAYMENT-SIGNATURE","X-Payment"],"pay_to":"0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab"}},{"method":"GET","path":"/v1/prices/history","url":"https://api.stocktrends.com/v1/prices/history","name":"prices_history","title":"Prices History","description":"Historical weekly price series for a Stock Trends symbol.","analytical_role":"price_context","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."},"safe_example_request":{"method":"GET","path":"/v1/prices/history","query":{"symbol_exchange":"IBM-N","limit":52,"cs_only":true}},"pricing_rule_id":"prices_history_paid","supported_rails":["subscription","x402","mpp"],"anonymous_x402_challenge_supported":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},"pricing_catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","pricing":{"source":"stc_pricing_catalog","pricing_rule_id":"prices_history_paid","catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","live_cost_included":false},"availability":{"classification":"immediately_discoverable","serviceable_example_outcome":"402_without_payment_proof","possible_unpaid_statuses":[402]},"x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","name":"USD Coin","version":"2","decimals":6,"transfer_method":"eip3009"},"proof_headers":["PAYMENT-SIGNATURE","X-Payment"],"pay_to":"0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab"}},{"method":"GET","path":"/v1/prices/latest","url":"https://api.stocktrends.com/v1/prices/latest","name":"prices_latest","title":"Prices Latest","description":"Latest weekly price row for a Stock Trends symbol, including adjusted close, weekly high/low, volume (actual shares traded), trades, and price change.","analytical_role":"price_context","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."},"safe_example_request":{"method":"GET","path":"/v1/prices/latest","query":{"symbol_exchange":"IBM-N","cs_only":true}},"pricing_rule_id":"prices_latest_paid","supported_rails":["subscription","x402","mpp"],"anonymous_x402_challenge_supported":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},"pricing_catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","pricing":{"source":"stc_pricing_catalog","pricing_rule_id":"prices_latest_paid","catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","live_cost_included":false},"availability":{"classification":"immediately_discoverable","serviceable_example_outcome":"402_without_payment_proof","possible_unpaid_statuses":[402]},"x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","name":"USD Coin","version":"2","decimals":6,"transfer_method":"eip3009"},"proof_headers":["PAYMENT-SIGNATURE","X-Payment"],"pay_to":"0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab"}},{"method":"GET","path":"/v1/selections/history","url":"https://api.stocktrends.com/v1/selections/history","name":"selections_history","title":"Selections History","description":"Historical base ST-IM selection records for a symbol, exchange, or date range.","analytical_role":"probabilistic_selection_universe","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"},"min_prob13wk":{"type":"number","x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"limit":{"type":"integer","minimum":1,"maximum":5200,"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":520,"default":520,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"include_data":{"type":"boolean","default":false,"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"},"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"},"safe_example_request":{"method":"GET","path":"/v1/selections/history","query":{"symbol_exchange":"IBM-N","limit":52}},"pricing_rule_id":"selections_history_paid","supported_rails":["subscription","x402","mpp"],"anonymous_x402_challenge_supported":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},"pricing_catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","pricing":{"source":"stc_pricing_catalog","pricing_rule_id":"selections_history_paid","catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","live_cost_included":false},"availability":{"classification":"immediately_discoverable","serviceable_example_outcome":"402_without_payment_proof","possible_unpaid_statuses":[402]},"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."},"x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","name":"USD Coin","version":"2","decimals":6,"transfer_method":"eip3009"},"proof_headers":["PAYMENT-SIGNATURE","X-Payment"],"pay_to":"0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab"}},{"method":"GET","path":"/v1/selections/latest","url":"https://api.stocktrends.com/v1/selections/latest","name":"selections_latest","title":"Selections Latest","description":"Latest base ST-IM selection universe ranked by prob13wk descending, without the published STIM Select threshold filter.","analytical_role":"probabilistic_selection_universe","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"},"min_prob13wk":{"type":"number","description":"Optional probability threshold.","example":0.55,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"limit":{"type":"integer","minimum":1,"maximum":20000,"default":2000,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"include_data":{"type":"boolean","default":false,"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"},"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":[],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"safe_example_request":{"method":"GET","path":"/v1/selections/latest","query":{"limit":25,"include_data":false}},"pricing_rule_id":"selections_latest_paid","supported_rails":["subscription","x402","mpp"],"anonymous_x402_challenge_supported":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},"pricing_catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","pricing":{"source":"stc_pricing_catalog","pricing_rule_id":"selections_latest_paid","catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","live_cost_included":false},"availability":{"classification":"immediately_discoverable","serviceable_example_outcome":"402_without_payment_proof","possible_unpaid_statuses":[402]},"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."},"x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","name":"USD Coin","version":"2","decimals":6,"transfer_method":"eip3009"},"proof_headers":["PAYMENT-SIGNATURE","X-Payment"],"pay_to":"0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab"}},{"method":"GET","path":"/v1/selections/published/history","url":"https://api.stocktrends.com/v1/selections/published/history","name":"selections_published_history","title":"Published STIM Select History","description":"Historical published STIM Select records using the documented three-horizon ST-IM criteria.","analytical_role":"probabilistic_selection_list","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"},"min_prob13wk":{"type":"number","default":0.55,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"min_x4wk1":{"type":"number","default":0.0,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"min_x13wk1":{"type":"number","default":2.19,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"min_x40wk1":{"type":"number","default":6.45,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"limit":{"type":"integer","minimum":1,"maximum":50000,"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":5200,"default":5200,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"include_data":{"type":"boolean","default":false,"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"},"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"},"safe_example_request":{"method":"GET","path":"/v1/selections/published/history","query":{"symbol_exchange":"IBM-N","limit":52}},"pricing_rule_id":"selections_published_history_paid","supported_rails":["subscription","x402","mpp"],"anonymous_x402_challenge_supported":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},"pricing_catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","pricing":{"source":"stc_pricing_catalog","pricing_rule_id":"selections_published_history_paid","catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","live_cost_included":false},"availability":{"classification":"immediately_discoverable","serviceable_example_outcome":"402_without_payment_proof","possible_unpaid_statuses":[402]},"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},"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"},"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."},"x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","name":"USD Coin","version":"2","decimals":6,"transfer_method":"eip3009"},"proof_headers":["PAYMENT-SIGNATURE","X-Payment"],"pay_to":"0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab"}},{"method":"GET","path":"/v1/selections/published/latest","url":"https://api.stocktrends.com/v1/selections/published/latest","name":"selections_published_latest","title":"Published STIM Select Latest","description":"Latest published STIM Select list using the documented three-horizon ST-IM lower-bound criteria and prob13wk publication threshold.","analytical_role":"probabilistic_selection_list","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"},"min_prob13wk":{"type":"number","default":0.55,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"min_x4wk1":{"type":"number","default":0.0,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"min_x13wk1":{"type":"number","default":2.19,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"min_x40wk1":{"type":"number","default":6.45,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"limit":{"type":"integer","minimum":1,"maximum":20000,"default":2000,"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"include_data":{"type":"boolean","default":false,"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"},"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":[],"x-stocktrends-input-location":"query","x-stocktrends-parameter-source":"query"},"safe_example_request":{"method":"GET","path":"/v1/selections/published/latest","query":{"limit":25}},"pricing_rule_id":"selections_published_latest_paid","supported_rails":["subscription","x402","mpp"],"anonymous_x402_challenge_supported":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},"pricing_catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","pricing":{"source":"stc_pricing_catalog","pricing_rule_id":"selections_published_latest_paid","catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","live_cost_included":false},"availability":{"classification":"immediately_discoverable","serviceable_example_outcome":"402_without_payment_proof","possible_unpaid_statuses":[402]},"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},"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"},"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."},"x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","name":"USD Coin","version":"2","decimals":6,"transfer_method":"eip3009"},"proof_headers":["PAYMENT-SIGNATURE","X-Payment"],"pay_to":"0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab"}},{"method":"GET","path":"/v1/stim/history","url":"https://api.stocktrends.com/v1/stim/history","name":"stim_history","title":"STIM History","description":"Historical ST-IM forward return distribution series for a symbol. Use /v1/meta/stim for ST-IM provenance, base-period context, and interpretation limits.","analytical_role":"probabilistic_forward_inference","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."},"safe_example_request":{"method":"GET","path":"/v1/stim/history","query":{"symbol_exchange":"IBM-N","limit":52}},"pricing_rule_id":"stim_history_paid","supported_rails":["subscription","x402","mpp"],"anonymous_x402_challenge_supported":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},"pricing_catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","pricing":{"source":"stc_pricing_catalog","pricing_rule_id":"stim_history_paid","catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","live_cost_included":false},"availability":{"classification":"immediately_discoverable","serviceable_example_outcome":"402_without_payment_proof","possible_unpaid_statuses":[402]},"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},"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."],"cognition_architecture":"docs/STOCK_TRENDS_COGNITION_ARCHITECTURE.md","x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","name":"USD Coin","version":"2","decimals":6,"transfer_method":"eip3009"},"proof_headers":["PAYMENT-SIGNATURE","X-Payment"],"pay_to":"0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab"}},{"method":"GET","path":"/v1/stim/latest","url":"https://api.stocktrends.com/v1/stim/latest","name":"stim_latest","title":"STIM Latest","description":"Latest Stock Trends Inference Model (ST-IM) outputs for a symbol: forward return expectations and statistical distributions across 4-week, 13-week, and 40-week horizons. Use /v1/meta/stim for ST-IM provenance, base-period context, and interpretation limits.","analytical_role":"probabilistic_forward_inference","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."},"safe_example_request":{"method":"GET","path":"/v1/stim/latest","query":{"symbol_exchange":"IBM-N"}},"pricing_rule_id":"stim_latest_paid","supported_rails":["subscription","x402","mpp"],"anonymous_x402_challenge_supported":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},"pricing_catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","pricing":{"source":"stc_pricing_catalog","pricing_rule_id":"stim_latest_paid","catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","live_cost_included":false},"availability":{"classification":"immediately_discoverable","serviceable_example_outcome":"402_without_payment_proof","possible_unpaid_statuses":[402]},"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},"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."],"cognition_architecture":"docs/STOCK_TRENDS_COGNITION_ARCHITECTURE.md","x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","name":"USD Coin","version":"2","decimals":6,"transfer_method":"eip3009"},"proof_headers":["PAYMENT-SIGNATURE","X-Payment"],"pay_to":"0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab"}},{"method":"GET","path":"/v1/stwr/reports/history","url":"https://api.stocktrends.com/v1/stwr/reports/history","name":"stwr_reports_history","title":"STWR Reports History","description":"Historical Stock Trends Weekly Reporter screening report rows for a requested report code and exchange.","analytical_role":"curated_signal_report","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"},"safe_example_request":{"method":"GET","path":"/v1/stwr/reports/history","query":{"rpt":"bullcross","exchange":"N"}},"pricing_rule_id":"stwr_reports_history_paid","supported_rails":["subscription","x402","mpp"],"anonymous_x402_challenge_supported":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},"pricing_catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","pricing":{"source":"stc_pricing_catalog","pricing_rule_id":"stwr_reports_history_paid","catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","live_cost_included":false},"availability":{"classification":"immediately_discoverable","serviceable_example_outcome":"402_without_payment_proof","possible_unpaid_statuses":[402]},"x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","name":"USD Coin","version":"2","decimals":6,"transfer_method":"eip3009"},"proof_headers":["PAYMENT-SIGNATURE","X-Payment"],"pay_to":"0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab"}},{"method":"GET","path":"/v1/stwr/reports/latest","url":"https://api.stocktrends.com/v1/stwr/reports/latest","name":"stwr_reports_latest","title":"STWR Reports Latest","description":"Latest Stock Trends Weekly Reporter screening report for a requested report code and exchange.","analytical_role":"curated_signal_report","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"},"safe_example_request":{"method":"GET","path":"/v1/stwr/reports/latest","query":{"rpt":"bullcross","exchange":"N","limit":25}},"pricing_rule_id":"stwr_reports_latest_paid","supported_rails":["subscription","x402","mpp"],"anonymous_x402_challenge_supported":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},"pricing_catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","pricing":{"source":"stc_pricing_catalog","pricing_rule_id":"stwr_reports_latest_paid","catalog_url":"https://api.stocktrends.com/v1/pricing/catalog","live_cost_included":false},"availability":{"classification":"immediately_discoverable","serviceable_example_outcome":"402_without_payment_proof","possible_unpaid_statuses":[402]},"x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","name":"USD Coin","version":"2","decimals":6,"transfer_method":"eip3009"},"proof_headers":["PAYMENT-SIGNATURE","X-Payment"],"pay_to":"0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab"}}],"discovery_exceptions":[]}