{"uid":"cap_PXg2K51OoYYR_Swmjbmkn","slug":"api-stocktrends-com-9489a109","name":"Stock Trends ST-IM Historical Forward Return Distribution Series","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.","url":"https://api.stocktrends.com/v1/stim/history","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":{"end":{"type":"string","format":"date"},"limit":{"type":"integer","default":260,"maximum":2600,"minimum":1},"start":{"type":"string","format":"date"},"symbol":{"type":"string"},"exchange":{"enum":["N","Q","A","B","T","I"],"type":"string"},"include_gaps":{"type":"boolean","default":false},"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":"Historical ST-IM distributions across 4, 13, and 40 week horizons.","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":{"end":"2023-12-31","limit":260,"start":"2023-01-01","include_gaps":false,"symbol_exchange":"AAPL-Q"}}},"response":{"_truncated":true,"_originalSize":19806}},"exampleRequest":{"end":"2023-12-31","limit":260,"start":"2023-01-01","include_gaps":false,"symbol_exchange":"AAPL-Q"},"tags":["x402"],"displayCostAmount":"0.0075","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.0075/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0075","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0075","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_64QEIdPngYUQyFPH4t7Ze","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0075","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns historical ST-IM (Stock Trends Inference Model) forward return distribution series for a given symbol across 4, 13, and 40 week horizons","exampleAgentPrompt":"Pull the Stock Trends ST-IM historical forward return distribution series for AAPL-Q (Apple on NASDAQ) from 2022-01-01 to 2024-12-31, up to 260 records, so I can review how the 4, 13, and 40 week forward return expectations have evolved over time.","exampleUseCases":null,"resultDescription":"A time-series of historical ST-IM forward return distribution records for the requested symbol, covering 4-week, 13-week, and 40-week forward return horizons. Each entry reflects the model's forward return probability distribution at a given point in time, allowing longitudinal analysis of how expectations have shifted across market history.","failureModes":["Invalid symbol_exchange format (must match ^[A-Z0-9.]+-[A-Z]$) returns a 400 error","Unknown or unlisted symbol/exchange combination returns empty results or 404","Date range with no available data returns empty series","limit exceeding 2600 returns a validation error","Invalid date format for start/end returns a 400 error","Payment failure or insufficient USDC balance returns a 402 error"],"whenToPreferThis":"Use this endpoint when you need historical time-series data of ST-IM forward return distributions for backtesting, longitudinal research, or analyzing how the model's forward expectations have evolved for a specific symbol. Prefer this over the latest ST-IM endpoint when you need historical context rather than current outputs. Complement with /v1/meta/stim for provenance and interpretation guidance.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:48:43.363Z","isFirstParty":false}