{"version":"2","service_description":"Autonomous portfolio intelligence API for AI agents. Agent-native probabilistic market intelligence infrastructure: multi-decade Stock Trends classification history from 1980 with 16M+ observations, ST-IM (Stock Trends Inference Model) forward-return distributions, provider-agnostic inference metadata, market regime analysis, sector breadth confirmation, leadership rotation analytics, STIM Select probabilistic stock lists, portfolio construction and evaluation, and symbol decision scoring across 4, 13, and 40-week investment horizons. Built for agentic research workflows using x402 and MPP payment rails. Outputs are processed, ranked, and interpretation-ready — not raw price data.","planning_role":{"purpose":"Explain how agents should identify themselves, choose a rail, and inspect costs before paid execution.","recommended_sequence":["GET /v1/ai/tools","GET /v1/workflows","GET /v1/pricing/catalog","GET /v1/pricing","Call paid endpoint; if x402 returns 402, inspect stocktrends_preview before paying."],"related_planning_endpoints":{"pricing_catalog":"/v1/pricing/catalog","workflow_registry":"/v1/workflows","cost_estimate":"/v1/cost-estimate","ai_tools":"/v1/ai/tools"}},"agent_identity":{"supported":true,"purpose":"Agent identity lets Stock Trends attribute usage to a persistent machine actor under a customer account. Identified agents may be auto-registered and can later be managed through dashboard and billing workflows.","identity_resolution":{"agent_identifier_source":"X-StockTrends-Agent-Id","canonical_storage":{"agent_identifier":"normalized external declared identity","agent_id":"internal registered api_agents.id when available"},"notes":["If X-StockTrends-Agent-Id is present, the request is treated as agent-attributed traffic.","Agent identifiers are normalized before lookup and registration.","When a valid customer context exists, first-seen agents may be auto-registered.","Disabled registered agents may be blocked."]},"recommended_headers":[{"name":"X-StockTrends-Agent-Id","required_for_agent_identity":true,"description":"Stable external identifier for the calling agent.","example":"editorial-agent-v1"},{"name":"X-StockTrends-Agent-Type","required_for_agent_identity":false,"description":"High-level agent category.","example":"editorial"},{"name":"X-StockTrends-Agent-Vendor","required_for_agent_identity":false,"description":"Vendor or platform operating the agent.","example":"stocktrends"},{"name":"X-StockTrends-Agent-Version","required_for_agent_identity":false,"description":"Agent software version.","example":"1.0.0"},{"name":"X-StockTrends-Request-Purpose","required_for_agent_identity":false,"description":"Optional statement of request purpose.","example":"weekly-editorial-generation"},{"name":"X-StockTrends-Session-Id","required_for_agent_identity":false,"description":"Optional session/workflow correlation id.","example":"run-2026-03-25-001"}]},"payment_identity":{"supported_methods":["subscription","mpp","x402"],"future_layers":["stok"],"rail_guidance":{"subscription":"Account-based access with monthly STC allocation.","x402":"Per-request HTTP 402 challenge/verify flow. Inspect stocktrends_preview before paying.","mpp":"Session-based payments. STC is consumed from an active payment session and does not use the x402 challenge flow.","stok":"Future incentive or discount layer; STOK does not replace STC pricing."},"payment_headers":[{"name":"X-StockTrends-Payment-Method","description":"Declared payment method for machine-pay capable flows.","example":"mpp"},{"name":"X-StockTrends-Payment-Network","description":"Payment network identifier.","example":"base"},{"name":"X-StockTrends-Payment-Token","description":"Optional payment token or asset identifier.","example":"USDC"},{"name":"X-StockTrends-Payment-Reference","description":"Payment or settlement reference.","example":"invoice_12345"},{"name":"X-StockTrends-Payment-Amount","description":"Native payment amount as declared by the caller.","example":"0.01"}],"response_headers":["X-StockTrends-Pricing-Rule","X-StockTrends-Payment-Required","X-StockTrends-Accepted-Payment-Methods"]},"endpoint_families":{"stim":{"pricing_model":"subscription_or_agent_pay","pricing_rule_default":"default_subscription","agent_pay_supported":true,"payment_required":false,"accepted_payment_methods":["subscription","mpp","x402"],"agent_headers":["X-StockTrends-Agent-Id","X-StockTrends-Agent-Type","X-StockTrends-Agent-Vendor","X-StockTrends-Agent-Version","X-StockTrends-Request-Purpose","X-StockTrends-Session-Id"],"payment_headers":["X-StockTrends-Payment-Method","X-StockTrends-Payment-Network","X-StockTrends-Payment-Reference","X-StockTrends-Payment-Amount","X-StockTrends-Payment-Token","X-StockTrends-Pricing-Rule"],"notes":["STIM endpoints are currently subscription-covered by default for entitled customers.","Identified agents can be attributed and logged even when subscription-backed.","Agent-native payment metadata is supported for discovery and logging.","Payment enforcement may be enabled in the future for selected routes."]},"ai":{"pricing_model":"free_metered","pricing_rule_default":"default_free_metered","payment_required":false,"notes":["Free-metered endpoints are logged but not billed."]},"breadth":{"pricing_model":"mixed","notes":["Breadth endpoints use endpoint-specific STC rules.","/v1/breadth/sector/latest and /v1/breadth/sector/history support subscription, x402, and MPP."]},"intelligence":{"pricing_model":"mixed","notes":["/v1/intelligence/discovery and /v1/intelligence/editorial/latest/preview are public/free.","/v1/intelligence/guidance/* and /v1/intelligence/research/* are paid intelligence products with endpoint-specific STC rules.","Paid intelligence artifact routes support subscription, x402, and MPP."]},"general_protected_api":{"pricing_model":"subscription","pricing_rule_default":"default_subscription","payment_required":false},"public":{"pricing_model":"free","pricing_rule_default":"default_free","payment_required":false}},"examples":{"subscription_with_agent_identity":{"description":"Recommended pattern for subscribed customers that want request attribution to a persistent agent.","headers":{"Authorization":"Bearer <API_KEY>","X-StockTrends-Agent-Id":"editorial-agent-v1","X-StockTrends-Agent-Type":"editorial","X-StockTrends-Agent-Vendor":"stocktrends","X-StockTrends-Agent-Version":"1.0.0","X-StockTrends-Request-Purpose":"weekly-editorial-generation","X-StockTrends-Session-Id":"run-2026-03-25-001"}},"agent_pay_candidate":{"description":"Illustrative machine-pay pattern for endpoints that may support agent-native payment.","headers":{"X-StockTrends-Agent-Id":"research-bot-17","X-StockTrends-Agent-Type":"research","X-StockTrends-Agent-Vendor":"external-lab","X-StockTrends-Agent-Version":"0.9.3","X-StockTrends-Request-Purpose":"factor-screening","X-StockTrends-Session-Id":"job-88421","X-StockTrends-Payment-Method":"mpp","X-StockTrends-Payment-Network":"base","X-StockTrends-Payment-Token":"USDC","X-StockTrends-Payment-Reference":"payment-ref-123","X-StockTrends-Payment-Amount":"0.01"}}}}