← Protocol index
Resource / 151
healthyStock Trends Market Intelligence.
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.
Payment requirements / accepts[]
1 options
| State | Network | Scheme | Atomic amount | Asset | payTo / untrusted |
|---|---|---|---|---|---|
| active | eip155:8453 | exact | 2500 | 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 | 0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab |
All advertised payment options are stored. Base (`eip155:8453`) is the operational network for ranking and canaries; non-Base options remain visible for transparency.
Probe evidence
1 recent
healthy 2026-08-12 21:30:03 UTC GET · HTTP 402 · 381ms · accepts 1 · base 1 ok
Accepts snapshot
[
{
"amount": "2500",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"assetTransferMethod": null,
"extra": {
"name": "USD Coin",
"resource": {
"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.",
"iconUrl": "https://developer.stocktrends.com/images/stmi-icon.png",
"mimeType": "application/json",
"serviceName": "Stock Trends Market Intelligence",
"tags": [
"finance",
"market-intelligence",
"equities",
"quantitative-finance",
"agentic"
],
"url": "https://api.stocktrends.com/v1/stim/latest"
},
"version": "2"
},
"maxTimeoutSeconds": 300,
"network": "eip155:8453",
"payTo": "0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab",
"paymentFlow": null,
"raw": {
"amount": "2500",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"resource": {
"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.",
"iconUrl": "https://developer.stocktrends.com/images/stmi-icon.png",
"mimeType": "application/json",
"serviceName": "Stock Trends Market Intelligence",
"tags": [
"finance",
"market-intelligence",
"equities",
"quantitative-finance",
"agentic"
],
"url": "https://api.stocktrends.com/v1/stim/latest"
},
"version": "2"
},
"maxTimeoutSeconds": 300,
"max_timeout_seconds": 300,
"network": "eip155:8453",
"payTo": "0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab",
"pay_to": "0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab",
"scheme": "exact"
},
"scheme": "exact"
}
]
PaymentRequired raw
{
"accepts": [
{
"amount": "2500",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"resource": {
"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.",
"iconUrl": "https://developer.stocktrends.com/images/stmi-icon.png",
"mimeType": "application/json",
"serviceName": "Stock Trends Market Intelligence",
"tags": [
"finance",
"market-intelligence",
"equities",
"quantitative-finance",
"agentic"
],
"url": "https://api.stocktrends.com/v1/stim/latest"
},
"version": "2"
},
"maxTimeoutSeconds": 300,
"network": "eip155:8453",
"payTo": "0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab",
"scheme": "exact"
}
],
"extensions": {
"bazaar": {
"info": {
"category": "stim",
"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.",
"family": "stim",
"inference_contract": "/v1/meta/inference",
"input": {
"method": "GET",
"queryParams": {
"symbol_exchange": "IBM-N"
},
"type": "http"
},
"metadataUrl": "https://api.stocktrends.com/v1/ai/context",
"output": {
"example": {
"request_id": "req_demo"
},
"format": "application/json",
"type": "json"
},
"pricing_catalog": "https://api.stocktrends.com/v1/pricing/catalog",
"provider": {
"future_causal_ai_compatible": true,
"not_final_intelligence_layer": true,
"provider_id": "stim",
"provider_name": "Stock Trends Inference Model",
"provider_profile_endpoint": "/v1/meta/stim",
"provider_role": "current_baseline_inference_provider"
},
"role": "probabilistic_forward_inference",
"schemaUrl": "https://api.stocktrends.com/v1/ai/tools",
"title": "STIM Latest",
"tools_manifest": "https://api.stocktrends.com/v1/ai/tools"
},
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": true,
"properties": {
"category": {
"type": "string"
},
"description": {
"type": "string"
},
"family": {
"type": "string"
},
"input": {
"additionalProperties": false,
"properties": {
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"additionalProperties": false,
"properties": {
"exchange": {
"enum": [
"N",
"Q",
"A",
"B",
"T",
"I"
],
"type": "string"
},
"symbol": {
"type": "string"
},
"symbol_exchange": {
"pattern": "^[A-Z0-9.]+-[A-Z]$",
"type": "string"
}
},
"required": [
"symbol_exchange"
],
"type": "object"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method"
],
"type": "object"
},
"metadataUrl": {
"type": "string"
},
"output": {
"additionalProperties": true,
"description": "ST-IM forward return expectations and statistical distributions across 4, 13, and 40 weeks.",
"properties": {
"example": {},
"format": {
"type": "string"
},
"type": {
"const": "json",
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
},
"pricing_catalog": {
"type": "string"
},
"schemaUrl": {
"type": "string"
},
"title": {
"type": "string"
},
"tools_manifest": {
"type": "string"
}
},
"required": [
"input"
],
"type": "object"
}
}
},
"resource": {
"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.",
"iconUrl": "https://developer.stocktrends.com/images/stmi-icon.png",
"mimeType": "application/json",
"serviceName": "Stock Trends Market Intelligence",
"tags": [
"finance",
"market-intelligence",
"equities",
"quantitative-finance",
"agentic"
],
"url": "https://api.stocktrends.com/v1/stim/latest"
},
"x402Version": 2
}
Response headers
{
"cache-control": "no-store, private",
"connection": "keep-alive",
"content-length": "11343",
"content-type": "application/json",
"date": "Wed, 12 Aug 2026 21:30:03 GMT",
"payment-required": "eyJ4NDAyVmVyc2lvbiI6MiwicmVzb3VyY2UiOnsidXJsIjoiaHR0cHM6Ly9hcGkuc3RvY2t0cmVuZHMuY29tL3YxL3N0aW0vbGF0ZXN0IiwiZGVzY3JpcHRpb24iOiJMYXRlc3QgU3RvY2sgVHJlbmRzIEluZmVyZW5jZSBNb2RlbCAoU1QtSU0pIG91dHB1dHMgZm9yIGEgc3ltYm9sOiBmb3J3YXJkIHJldHVybiBleHBlY3RhdGlvbnMgYW5kIHN0YXRpc3RpY2FsIGRpc3RyaWJ1dGlvbnMgYWNyb3NzIDQtd2VlaywgMTMtd2VlaywgYW5kIDQwLXdlZWsgaG9yaXpvbnMuIFVzZSAvdjEvbWV0YS9zdGltIGZvciBTVC1JTSBwcm92ZW5hbmNlLCBiYXNlLXBlcmlvZCBjb250ZXh0LCBhbmQgaW50ZXJwcmV0YXRpb24gbGltaXRzLiIsIm1pbWVUeXBlIjoiYXBwbGljYXRpb24vanNvbiIsInNlcnZpY2VOYW1lIjoiU3RvY2sgVHJlbmRzIE1hcmtldCBJbnRlbGxpZ2VuY2UiLCJ0YWdzIjpbImZpbmFuY2UiLCJtYXJrZXQtaW50ZWxsaWdlbmNlIiwiZXF1aXRpZXMiLCJxdWFudGl0YXRpdmUtZmluYW5jZSIsImFnZW50aWMiXSwiaWNvblVybCI6Imh0dHBzOi8vZGV2ZWxvcGVyLnN0b2NrdHJlbmRzLmNvbS9pbWFnZXMvc3RtaS1pY29uLnBuZyJ9LCJhY2NlcHRzIjpbeyJzY2hlbWUiOiJleGFjdCIsIm5ldHdvcmsiOiJlaXAxNTU6ODQ1MyIsImFtb3VudCI6IjI1MDAiLCJhc3NldCI6IjB4ODMzNTg5ZkNENmVEYjZFMDhmNGM3QzMyRDRmNzFiNTRiZEEwMjkxMyIsInBheVRvIjoiMHhBRWViOEVhQmRDMDU1MzJhMjYxMjMwNDVmOTlEMjA4RUIxY0MwMGFiIiwibWF4VGltZW91dFNlY29uZHMiOjMwMCwiZXh0cmEiOnsibmFtZSI6IlVTRCBDb2luIiwidmVyc2lvbiI6IjIiLCJyZXNvdXJjZSI6eyJ1cmwiOiJodHRwczovL2FwaS5zdG9ja3RyZW5kcy5jb20vdjEvc3RpbS9sYXRlc3QiLCJkZXNjcmlwdGlvbiI6IkxhdGVzdCBTdG9jayBUcmVuZHMgSW5mZXJlbmNlIE1vZGVsIChTVC1JTSkgb3V0cHV0cyBmb3IgYSBzeW1ib2w6IGZvcndhcmQgcmV0dXJuIGV4cGVjdGF0aW9ucyBhbmQgc3RhdGlzdGljYWwgZGlzdHJpYnV0aW9ucyBhY3Jvc3MgNC13ZWVrLCAxMy13ZWVrLCBhbmQgNDAtd2VlayBob3Jpem9ucy4gVXNlIC92MS9tZXRhL3N0aW0gZm9yIFNULUlNIHByb3ZlbmFuY2UsIGJhc2UtcGVyaW9kIGNvbnRleHQsIGFuZCBpbnRlcnByZXRhdGlvbiBsaW1pdHMuIiwibWltZVR5cGUiOiJhcHBsaWNhdGlvbi9qc29uIiwic2VydmljZU5hbWUiOiJTdG9jayBUcmVuZHMgTWFya2V0IEludGVsbGlnZW5jZSIsInRhZ3MiOlsiZmluYW5jZSIsIm1hcmtldC1pbnRlbGxpZ2VuY2UiLCJlcXVpdGllcyIsInF1YW50aXRhdGl2ZS1maW5hbmNlIiwiYWdlbnRpYyJdLCJpY29uVXJsIjoiaHR0cHM6Ly9kZXZlbG9wZXIuc3RvY2t0cmVuZHMuY29tL2ltYWdlcy9zdG1pLWljb24ucG5nIn19fV0sImV4dGVuc2lvbnMiOnsiYmF6YWFyIjp7ImluZm8iOnsidGl0bGUiOiJTVElNIExhdGVzdCIsImRlc2NyaXB0aW9uIjoiTGF0ZXN0IFN0b2NrIFRyZW5kcyBJbmZlcmVuY2UgTW9kZWwgKFNULUlNKSBvdXRwdXRzIGZvciBhIHN5bWJvbDogZm9yd2FyZCByZXR1cm4gZXhwZWN0YXRpb25zIGFuZCBzdGF0aXN0aWNhbCBkaXN0cmlidXRpb25zIGFjcm9zcyA0LXdlZWssIDEzLXdlZWssIGFuZCA0MC13ZWVrIGhvcml6b25zLiBVc2UgL3YxL21ldGEvc3RpbSBmb3IgU1QtSU0gcHJvdmVuYW5jZSwgYmFzZS1wZXJpb2QgY29udGV4dCwgYW5kIGludGVycHJldGF0aW9uIGxpbWl0cy4iLCJjYXRlZ29yeSI6InN0aW0iLCJmYW1pbHkiOiJzdGltIiwidG9vbHNfbWFuaWZlc3QiOiJodHRwczovL2FwaS5zdG9ja3RyZW5kcy5jb20vdjEvYWkvdG9vbHMiLCJtZXRhZGF0YVVybCI6Imh0dHBzOi8vYXBpLnN0b2NrdHJlbmRzLmNvbS92MS9haS9jb250ZXh0Iiwic2NoZW1hVXJsIjoiaHR0cHM6Ly9hcGkuc3RvY2t0cmVuZHMuY29tL3YxL2FpL3Rvb2xzIiwicHJpY2luZ19jYXRhbG9nIjoiaHR0cHM6Ly9hcGkuc3RvY2t0cmVuZHMuY29tL3YxL3ByaWNpbmcvY2F0YWxvZyIsImlucHV0Ijp7InR5cGUiOiJodHRwIiwibWV0aG9kIjoiR0VUIiwicXVlcnlQYXJhbXMiOnsic3ltYm9sX2V4Y2hhbmdlIjoiSUJNLU4ifX0sIm91dHB1dCI6eyJ0eXBlIjoianNvbiIsImZvcm1hdCI6ImFwcGxpY2F0aW9uL2pzb24iLCJleGFtcGxlIjp7InJlcXVlc3RfaWQiOiJyZXFfZGVtbyJ9fSwicm9sZSI6InByb2JhYmlsaXN0aWNfZm9yd2FyZF9pbmZlcmVuY2UiLCJwcm92aWRlciI6eyJwcm92aWRlcl9pZCI6InN0aW0iLCJwcm92aWRlcl9uYW1lIjoiU3RvY2sgVHJlbmRzIEluZmVyZW5jZSBNb2RlbCIsInByb3ZpZGVyX3JvbGUiOiJjdXJyZW50X2Jhc2VsaW5lX2luZmVyZW5jZV9wcm92aWRlciIsInByb3ZpZGVyX3Byb2ZpbGVfZW5kcG9pbnQiOiIvdjEvbWV0YS9zdGltIiwibm90X2ZpbmFsX2ludGVsbGlnZW5jZV9sYXllciI6dHJ1ZSwiZnV0dXJlX2NhdXNhbF9haV9jb21wYXRpYmxlIjp0cnVlfSwiaW5mZXJlbmNlX2NvbnRyYWN0IjoiL3YxL21ldGEvaW5mZXJlbmNlIn0sInNjaGVtYSI6eyIkc2NoZW1hIjoiaHR0cHM6Ly9qc29uLXNjaGVtYS5vcmcvZHJhZnQvMjAyMC0xMi9zY2hlbWEiLCJ0eXBlIjoib2JqZWN0IiwicHJvcGVydGllcyI6eyJpbnB1dCI6eyJ0eXBlIjoib2JqZWN0IiwicHJvcGVydGllcyI6eyJ0eXBlIjp7InR5cGUiOiJzdHJpbmciLCJjb25zdCI6Imh0dHAifSwibWV0aG9kIjp7InR5cGUiOiJzdHJpbmciLCJlbnVtIjpbIkdFVCJdfSwicXVlcnlQYXJhbXMiOnsidHlwZSI6Im9iamVjdCIsInByb3BlcnRpZXMiOnsic3ltYm9sX2V4Y2hhbmdlIjp7InR5cGUiOiJzdHJpbmciLCJwYXR0ZXJuIjoiXltBLVowLTkuXSstW0EtWl0kIn0sInN5bWJvbCI6eyJ0eXBlIjoic3RyaW5nIn0sImV4Y2hhbmdlIjp7InR5cGUiOiJzdHJpbmciLCJlbnVtIjpbIk4iLCJRIiwiQSIsIkIiLCJUIiwiSSJdfX0sInJlcXVpcmVkIjpbInN5bWJvbF9leGNoYW5nZSJdLCJhZGRpdGlvbmFsUHJvcGVydGllcyI6ZmFsc2V9fSwicmVxdWlyZWQiOlsidHlwZSIsIm1ldGhvZCJdLCJhZGRpdGlvbmFsUHJvcGVydGllcyI6ZmFsc2V9LCJvdXRwdXQiOnsidHlwZSI6Im9iamVjdCIsImRlc2NyaXB0aW9uIjoiU1QtSU0gZm9yd2FyZCByZXR1cm4gZXhwZWN0YXRpb25zIGFuZCBzdGF0aXN0aWNhbCBkaXN0cmlidXRpb25zIGFjcm9zcyA0LCAxMywgYW5kIDQwIHdlZWtzLiIsInByb3BlcnRpZXMiOnsidHlwZSI6eyJ0eXBlIjoic3RyaW5nIiwiY29uc3QiOiJqc29uIn0sImZvcm1hdCI6eyJ0eXBlIjoic3RyaW5nIn0sImV4YW1wbGUiOnt9fSwicmVxdWlyZWQiOlsidHlwZSJdLCJhZGRpdGlvbmFsUHJvcGVydGllcyI6dHJ1ZX0sInRpdGxlIjp7InR5cGUiOiJzdHJpbmcifSwiZGVzY3JpcHRpb24iOnsidHlwZSI6InN0cmluZyJ9LCJjYXRlZ29yeSI6eyJ0eXBlIjoic3RyaW5nIn0sImZhbWlseSI6eyJ0eXBlIjoic3RyaW5nIn0sInRvb2xzX21hbmlmZXN0Ijp7InR5cGUiOiJzdHJpbmcifSwibWV0YWRhdGFVcmwiOnsidHlwZSI6InN0cmluZyJ9LCJzY2hlbWFVcmwiOnsidHlwZSI6InN0cmluZyJ9LCJwcmljaW5nX2NhdGFsb2ciOnsidHlwZSI6InN0cmluZyJ9fSwicmVxdWlyZWQiOlsiaW5wdXQiXSwiYWRkaXRpb25hbFByb3BlcnRpZXMiOnRydWV9fX19",
"server": "uvicorn",
"x-request-id": "c532b21a-b988-4930-ba7c-74c41506d19e",
"x-stocktrends-accepted-payment-methods": "subscription,x402,mpp",
"x-stocktrends-payment-required": "true",
"x-stocktrends-pricing-rule": "stim_latest_paid"
}
Response body
{
"accepted_payment_methods": [
"subscription",
"x402",
"mpp"
],
"detail": "Payment is required to access this endpoint.",
"error": "payment_required",
"payment_required": {
"accepts": [
{
"amount": "2500",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"resource": {
"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.",
"iconUrl": "https://developer.stocktrends.com/images/stmi-icon.png",
"mimeType": "application/json",
"serviceName": "Stock Trends Market Intelligence",
"tags": [
"finance",
"market-intelligence",
"equities",
"quantitative-finance",
"agentic"
],
"url": "https://api.stocktrends.com/v1/stim/latest"
},
"version": "2"
},
"maxTimeoutSeconds": 300,
"network": "eip155:8453",
"payTo": "0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab",
"scheme": "exact"
}
],
"extensions": {
"bazaar": {
"info": {
"category": "stim",
"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.",
"family": "stim",
"inference_contract": "/v1/meta/inference",
"input": {
"method": "GET",
"queryParams": {
"symbol_exchange": "IBM-N"
},
"type": "http"
},
"metadataUrl": "https://api.stocktrends.com/v1/ai/context",
"output": {
"example": {
"request_id": "req_demo"
},
"format": "application/json",
"type": "json"
},
"pricing_catalog": "https://api.stocktrends.com/v1/pricing/catalog",
"provider": {
"future_causal_ai_compatible": true,
"not_final_intelligence_layer": true,
"provider_id": "stim",
"provider_name": "Stock Trends Inference Model",
"provider_profile_endpoint": "/v1/meta/stim",
"provider_role": "current_baseline_inference_provider"
},
"role": "probabilistic_forward_inference",
"schemaUrl": "https://api.stocktrends.com/v1/ai/tools",
"title": "STIM Latest",
"tools_manifest": "https://api.stocktrends.com/v1/ai/tools"
},
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": true,
"properties": {
"category": {
"type": "string"
},
"description": {
"type": "string"
},
"family": {
"type": "string"
},
"input": {
"additionalProperties": false,
"properties": {
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"additionalProperties": false,
"properties": {
"exchange": {
"enum": [
"N",
"Q",
"A",
"B",
"T",
"I"
],
"type": "string"
},
"symbol": {
"type": "string"
},
"symbol_exchange": {
"pattern": "^[A-Z0-9.]+-[A-Z]$",
"type": "string"
}
},
"required": [
"symbol_exchange"
],
"type": "object"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method"
],
"type": "object"
},
"metadataUrl": {
"type": "string"
},
"output": {
"additionalProperties": true,
"description": "ST-IM forward return expectations and statistical distributions across 4, 13, and 40 weeks.",
"properties": {
"example": {},
"format": {
"type": "string"
},
"type": {
"const": "json",
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
},
"pricing_catalog": {
"type": "string"
},
"schemaUrl": {
"type": "string"
},
"title": {
"type": "string"
},
"tools_manifest": {
"type": "string"
}
},
"required": [
"input"
],
"type": "object"
}
}
},
"resource": {
"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.",
"iconUrl": "https://developer.stocktrends.com/images/stmi-icon.png",
"mimeType": "application/json",
"serviceName": "Stock Trends Market Intelligence",
"tags": [
"finance",
"market-intelligence",
"equities",
"quantitative-finance",
"agentic"
],
"url": "https://api.stocktrends.com/v1/stim/latest"
},
"x402Version": 2
},
"pricing": {
"amount_usd": "0.002500",
"network": "eip155:8453",
"scheme": "exact",
"token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"unit": "request"
},
"protocol": "x402",
"resource": "https://api.stocktrends.com/v1/stim/latest",
"stocktrends_preview": {
"analytical_role": "probabilistic_forward_inference",
"cognition_architecture": "docs/STOCK_TRENDS_COGNITION_ARCHITECTURE.md",
"endpoint": {
"access_type": "paid",
"category": "stim",
"method": "GET",
"path": "/v1/stim/latest",
"purpose": "Retrieve latest ST-IM forward return distribution outputs for one instrument.",
"requires_payment": true,
"workflow_role": "Forward distribution enrichment."
},
"example_object": {
"request_id": "req_demo",
"symbol_exchange": "SAMPLE-N",
"weekdate": "YYYY-MM-DD",
"x13wk": 0.0,
"x13wksd": 1.0
},
"inference_contract": {
"core_concepts": [
"inference_provider",
"forecast_horizon",
"probability_distribution",
"confidence_measure",
"evidence",
"uncertainty",
"explanation",
"signal_source",
"reasoning_interpretation"
],
"endpoint": "/v1/meta/inference",
"provider_agnostic": true
},
"inference_provider": {
"future_causal_ai_compatible": true,
"not_final_intelligence_layer": true,
"provider_id": "stim",
"provider_name": "Stock Trends Inference Model",
"provider_profile_endpoint": "/v1/meta/stim",
"provider_role": "current_baseline_inference_provider"
},
"input_location": "query",
"input_rule": "Provide symbol_exchange, or provide both symbol and exchange.",
"interpretation_dependency": {
"cognition_architecture": "docs/STOCK_TRENDS_COGNITION_ARCHITECTURE.md",
"endpoint": "/v1/meta/stim",
"inference_contract_endpoint": "/v1/meta/inference",
"method": "GET",
"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.",
"required_before_interpretation": true
},
"interpretation_guidance": {
"base_period_mean_returns_pct": {
"x13wk": "13-week baseline from /v1/meta/stim",
"x40wk": "40-week baseline from /v1/meta/stim",
"x4wk": "4-week baseline from /v1/meta/stim"
},
"calculation": {
"delta_vs_base": "stim_mean - base_mean",
"probability_outperform": "1 - normal_cdf(z)",
"z": "(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.",
"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)"
},
"inference_contract_endpoint": "/v1/meta/inference",
"inference_provider": {
"not_final_intelligence_layer": true,
"profile_endpoint": "/v1/meta/stim",
"provider_id": "stim",
"provider_role": "current_baseline_inference_provider"
},
"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."
],
"limitations": [
"regime_shifts",
"non_stationarity",
"sample_size_weakness",
"tail_events",
"liquidity_shocks",
"news_shocks",
"uncertainty_in_individual_stock_outcomes"
],
"mean_return_fields": [
"x4wk",
"x13wk",
"x40wk"
],
"portfolio_applications": [
"ranking",
"screening",
"allocation_review",
"regime-aware interpretation",
"market-structure analysis",
"repeated decision-making under uncertainty"
],
"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."
],
"standard_deviation_fields": [
"x4wksd",
"x13wksd",
"x40wksd"
],
"stim_select_style_logic": {
"lower_confidence_bounds": "Emphasize lower confidence bounds relative to base-period means where applicable.",
"prob13wk_minimum": 0.55,
"prob13wk_minimum_description": "13-week probability of exceeding the base-period mean should be at least 55%."
}
},
"investment_agent_value": "Provides probabilistic forward return context for ranking and decision workflows.",
"next_recommended_calls": [
"/v1/meta/inference",
"/v1/meta/stim",
"/v1/decision/evaluate-symbol",
"/v1/portfolio/construct"
],
"notes": [
"ST-IM is Stock Trends Inference Model; it is a probabilistic forward-looking model.",
"xNwk1 is the lower bound, xNwk is expected return, xNwk2 is the upper bound, and xNwksd is standard deviation.",
"Call /v1/meta/stim before interpreting ST-IM means or probabilities.",
"Compare ST-IM means to base_period_mean_returns_pct; positive raw means alone are not sufficient.",
"If is_stale=true or missing_reason is present, disclose that the ST-IM result is a historical fallback."
],
"optional_inputs": {
"exchange": {
"description": "Stock Trends exchange suffix. Common examples: N=NYSE, Q=NASDAQ, A=AMEX, T=TSX.",
"enum": [
"N",
"Q",
"A",
"B",
"T",
"I"
],
"example": "N",
"input_location": "query",
"parameter_source": "query",
"required": false,
"type": "string"
},
"symbol": {
"description": "Ticker symbol. Use with exchange when symbol_exchange is not supplied.",
"example": "IBM",
"input_location": "query",
"parameter_source": "query",
"required": false,
"type": "string"
}
},
"output_summary": "ST-IM forward return expectations and statistical distributions across 4, 13, and 40 weeks.",
"parameter_source": "query",
"pricing": {
"cost_source": "/v1/pricing/catalog",
"effective_price_usd": "0.002500",
"pricing_rule_id": "stim_latest_paid",
"stc_cost": "0.002500",
"unit": "request"
},
"related_endpoints": [
"/v1/meta/inference",
"/v1/meta/stim",
"/v1/indicators/latest",
"/v1/stim/history",
"/v1/selections/published/latest"
],
"required_inputs": {
"symbol_exchange": {
"description": "Stock Trends symbol plus exchange suffix.",
"example": "IBM-N",
"input_location": "query",
"parameter_source": "query",
"pattern": "^[A-Z0-9.]+-[A-Z]$",
"required": true,
"safe_default_for_demo": "IBM-N",
"type": "string"
}
},
"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."
],
"response_shape": [
"request_id",
"symbol_exchange",
"weekdate",
"exchange",
"symbol",
"x4wk1",
"x4wk2",
"x4wk",
"x4wksd",
"x13wk1",
"x13wk2",
"x13wk",
"x13wksd",
"x40wk1",
"x40wk2",
"x40wk",
"x40wksd",
"latest_data_weekdate",
"is_stale",
"missing_reason",
"missing_weekdate"
],
"safe_example_request": {
"method": "GET",
"path": "/v1/stim/latest",
"query": {
"symbol_exchange": "IBM-N"
}
},
"supported_rails": [
"subscription",
"x402",
"mpp"
]
}
}
Request headers
{
"accept": "*/*",
"user-agent": "Fetch402Bot/0.1 (+https://fetch402.com/crawler; contact: crawler@fetch402.com)"
}
Machine contract
Schemas.
InputJSON
{
"method": "GET",
"queryParams": {
"symbol_exchange": "IBM-N"
},
"type": "http"
}
OutputJSON
{
"example": {
"request_id": "req_demo"
},
"format": "application/json",
"type": "json"
}