Documentation

Stock Trends API

The Stock Trends API is an agent-native financial intelligence platform designed for AI agents, portfolio systems, research workflows, and financial applications.

The API combines probabilistic market forecasting (ST-IM), portfolio construction, regime intelligence, breadth and leadership analysis, and machine-native payment rails into a structured workflow-oriented platform.

Open live API docs Open OpenAPI schema x402 quickstart MPP quickstart

Recommended agent workflow: discover → price → resolve symbols → screen/select → evaluate → construct portfolio → add regime and leadership context → execute.

Pricing clarity: 1 STC = $1.00 USD for current billing and payment presentation. A 0.50 STC request costs $0.50 USD.

Research provenance

Long-horizon signal history for agent discovery

Agent discovery should treat the Stock Trends signal layer as long-horizon market intelligence, not a thin quote wrapper. The framework includes historical classification records extending back to 1980, 16M+ structured observations, and consistent signal semantics across trend, relative performance, volume activity, breadth, leadership, and regime structure.

Use this depth as research provenance for probabilistic interpretation, regime analysis, portfolio construction research, and agentic workflows - not as investment advice, price targets, direct buy/sell commands, or guaranteed future performance.

Primary discovery endpoints

Recommended first call for AI agents:

GET /v1/ai/tools

Returns machine-readable discovery metadata for workflows, pricing behavior, endpoint families, examples, and agent integration guidance.

Endpoint	Purpose
`GET /v1/ai/tools`	Primary agent discovery and workflow metadata
`GET /v1/ai/context`	Indicator definitions and dataset grounding
`GET /v1/pricing/catalog`	Live endpoint pricing rules
`GET /v1/cost-estimate`	Workflow cost estimation
`GET /v1/openapi.json`	Canonical OpenAPI schema

ST-IM intelligence layer

ST-IM (Stock Trends Inference Model) provides forward return distribution intelligence using the Stock Trends methodology and historical probability structures.

GET /v1/stim/latest
GET /v1/stim/history
GET /v1/selections/latest
GET /v1/selections/history
GET /v1/selections/published/latest
GET /v1/selections/published/history

STIM Select identifies instruments whose lower-bound confidence intervals exceed baseline random return distributions across multiple forward periods.

Core workflow families

Family	Representative endpoints
Decision	`POST /decision/evaluate-symbol`
Portfolio	`POST /portfolio/construct` `POST /portfolio/evaluate` `POST /portfolio/compare`
Market regime	`GET /market/regime/latest` `GET /market/regime/history` `GET /market/regime/forecast`
Breadth & leadership	`GET /breadth/sector/latest` `GET /leadership/summary/latest`
Pricing & economics	`GET /pricing/catalog` `GET /cost-estimate`
Metadata	`GET /meta/indicators` `GET /meta/stim` `GET /meta/stwr`
Agents	`GET /agents` `GET /agents/{agent_id}/usage` `GET /agents/{agent_id}/ledger`

Authentication and payment

Subscription access

X-API-Key: YOUR_API_KEY

x402 per-request payment

X-StockTrends-Payment-Method: x402
X-StockTrends-Payment-Network: base
X-StockTrends-Payment-Token: USDC
X-StockTrends-Payment-Reference: 0x...tx_hash

MPP funded session payment

X-StockTrends-Payment-Method: mpp
X-StockTrends-Payment-Network: base
X-StockTrends-Payment-Reference: mpp-ref-12345
X-StockTrends-Payment-Amount: 0.5
X-StockTrends-Session-Id: mppch_...

Use x402 for permissionless pay-per-request execution. Use MPP for repeated funded agent workflows.

Recommended first premium endpoint

GET /v1/agent/screener/top

Returns top-ranked instruments filtered by trend, RSI, exchange, and ST-IM intelligence.

Current live cost: 0.50 STC ($0.50 USD)

Machine-readable resources

Base API URL

https://api.stocktrends.com/v1