{"uid":"cap_2wxV7EYuMR9wBR3dfT3-Q","slug":"api-stocktrends-com-a8a8ef54","name":"Stock Trends Inference Model (ST-IM) Latest Outputs","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.","url":"https://api.stocktrends.com/v1/stim/latest","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["symbol_exchange"],"properties":{"symbol":{"type":"string"},"exchange":{"enum":["N","Q","A","B","T","I"],"type":"string"},"symbol_exchange":{"type":"string","pattern":"^[A-Z0-9.]+-[A-Z]$"}},"additionalProperties":false}},"additionalProperties":false},"title":{"type":"string"},"family":{"type":"string"},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"json"},"format":{"type":"string"},"example":{}},"description":"ST-IM forward return expectations and statistical distributions across 4, 13, and 40 weeks.","additionalProperties":true},"category":{"type":"string"},"schemaUrl":{"type":"string"},"description":{"type":"string"},"metadataUrl":{"type":"string"},"tools_manifest":{"type":"string"},"pricing_catalog":{"type":"string"}},"additionalProperties":true},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"symbol_exchange":"AAPL-Q"}},"title":"Stock Trends Forward Return Expectations","family":"market_data","output":{"type":"json","format":"application/json","example":{}},"category":"financial_analysis","description":"Retrieve ST-IM forward return expectations and statistical distributions for a stock symbol"},"response":{"x4wk":1.76436464088398,"x13wk":3.46675977653631,"x40wk":8.77398843930636,"x4wk1":0.950637925339449,"x4wk2":2.57809135642851,"symbol":"AAPL","x13wk1":1.7629021612591,"x13wk2":5.17061739181352,"x40wk1":5.91296064982623,"x40wk2":11.6350162287865,"x4wksd":9.38835889792544,"x13wksd":19.5487555899886,"x40wksd":32.2674856852085,"exchange":"Q","is_stale":false,"weekdate":"2026-05-29","request_id":"e6d328e4-b3d0-4647-b773-a374c383342e","missing_reason":null,"symbol_exchange":"AAPL-Q","missing_weekdate":null,"latest_data_weekdate":"2026-05-29"}},"exampleRequest":{"symbol_exchange":"AAPL-Q"},"tags":["x402"],"displayCostAmount":"0.0025","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.0025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_KDT9ihaqzlfNLy-imhbL_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the latest ST-IM forward return expectations and statistical distributions for a stock symbol across 4-week, 13-week, and 40-week horizons.","exampleAgentPrompt":"What are the Stock Trends Inference Model forward return expectations for AAPL listed on NASDAQ — give me the 4-week, 13-week, and 40-week statistical distributions.","exampleUseCases":[{"title":"Compare short-term return probabilities across tech stocks","prompt":"I'm building a tech portfolio — can you pull the 4-week forward return expectations from the Stock Trends model for AAPL, MSFT, and NVDA? I want to see which one has the best probability of positive returns in the next month."},{"title":"Evaluate medium-term growth potential for sector rotation","prompt":"We're considering rotating from energy into semiconductors. Show me the Stock Trends Inference Model's 13-week return distributions for XLE versus SMH — I need the statistical outlook to justify the allocation shift to our committee."},{"title":"Assess downside risk across investment horizons","prompt":"Can you get me the ST-IM statistical distributions for TSLA across all three timeframes — 4-week, 13-week, and 40-week? I need to understand the full range of expected outcomes and tail risks before I increase my position."}],"resultDescription":"A JSON object containing the latest ST-IM outputs for the requested symbol: forward return expectations and statistical distributions across 4-week, 13-week, and 40-week horizons, reflecting the model's probabilistic view of the symbol's future performance.","failureModes":["Invalid or unrecognized symbol_exchange format (must match ^[A-Z0-9.]+-[A-Z]$) — returns validation error","Symbol not covered by Stock Trends database — returns 404 or empty result","Invalid exchange code (must be one of N, Q, A, B, T, I) — returns schema validation error","Payment failure or insufficient USDC balance for x402 micropayment — returns 402 Payment Required","ST-IM model outputs not yet available for the current period — returns stale or missing data notice"],"whenToPreferThis":"Use this endpoint when you need probabilistic, multi-horizon forward return expectations for a specific stock symbol derived from the Stock Trends Inference Model (ST-IM). It is the right choice when you want statistical distributions rather than deterministic signals, and when you need outlook across all three horizons (4-week, 13-week, 40-week) simultaneously. Prefer this over the regime or signal endpoints when the question is specifically about expected forward returns for a single symbol, not about market regime or trend classification.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:39:41.368Z","isFirstParty":false}