Decision, portfolio, and market intelligence for AI agents and financial applications
Use Stock Trends data and decision workflows to evaluate symbols, construct portfolios, compare strategies, and integrate structured market intelligence into agent-driven systems.
The API combines interpretable weekly market structure, portfolio analytics, pricing discovery, and agent-aware access in a single platform with subscription, x402, and MPP payment paths.
Why this API matters
The Stock Trends API is built for workflows that need more than raw market data. It delivers structured market context, high-value decision endpoints, portfolio intelligence, and pricing-aware access patterns for production systems.
Choose your access mode
The Stock Trends API supports three practical ways to access premium intelligence. Use the one that best matches your workflow.
Pricing clarity: STC and USD cost
Stock Trends Credits (STC) are the API's pricing unit. For current billing and payment presentation, 1 STC = $1.00 USD. This means a request priced at 0.50 STC costs $0.50 USD, a request priced at 0.75 STC costs $0.75 USD, and a request priced at 1.25 STC costs $1.25 USD.
x402 and MPP requests may be settled through machine-payment rails, including USDC on Base where supported, but the user-facing economic cost is still shown from the STC-denominated endpoint price. The live pricing catalog and response headers remain authoritative before execution.
GET /v1/pricing/catalog
and the payment-required response before running paid workflows.
Use with a subscription
Subscribe to a plan and call premium endpoints using your X-API-Key header.
Best for applications, dashboards, and developer-managed production integrations.
Pay per request
AI agents can pay per call via x402 with no subscription required. Call a premium endpoint, receive HTTP 402 with payment details, pay on-chain, and retry with payment proof headers.
Fund a session for repeated agent use
MPP is the session-based payment rail for repeated premium requests. Fund a session once,
keep a channel_id, and let your agent make budgeted, lower-friction calls
against that balance.
Explore the API
Start with the interactive API docs and OpenAPI schema — both are publicly accessible. Explore endpoints, parameters, and response shapes before writing a line of code.
Discover live endpoint cost
Agents and developers can inspect live pricing metadata before making paid requests. Use the pricing catalog and response headers as the authoritative source for current endpoint cost.
First recommended premium endpoint
Start with GET /agent/screener/top. It is a strong first endpoint for agent
integrations and is validated across both x402 and MPP payment flows.
High-value decision endpoints
Evaluate individual symbols with Stock Trends decision logic and integrate outputs directly into research, advisory, or agent workflows.
Portfolio workflows built in
Construct scored portfolios, evaluate user-supplied holdings, and compare competing portfolios using structured portfolio endpoints.
Designed for controlled machine usage
Expose pricing metadata, cost estimation, agent usage controls, and multiple payment paths for production-grade integrations.
Core API capabilities
-
Decision intelligence
POST /decision/evaluate-symbol -
Portfolio workflows
POST /portfolio/construct
POST /portfolio/evaluate
POST /portfolio/compare -
Market regime intelligence
GET /market/regime/latest
GET /market/regime/history
GET /market/regime/forecast -
Pricing discovery
GET /pricing
GET /pricing/catalog
GET /cost-estimate -
Agent-aware operations
GET /agents
GET /agents/{agent_id}
GET /agents/{agent_id}/usage
GET /agents/{agent_id}/ledger
POST /agents/{agent_id}/disable
POST /agents/{agent_id}/enable
Additional market intelligence endpoints
-
Breadth
GET /breadth/sector/latest
GET /breadth/sector/history -
Leadership
GET /leadership/definitions
GET /leadership/summary/latest
GET /leadership/rotation/history -
AI context
GET /ai/context -
Agent screener
GET /agent/screener/top -
Workflow discovery
GET /workflows
For developers
Use subscription access for predictable production usage, standard API key handling, and app-managed integrations.
For AI agents
Use x402 for permissionless per-request payment, or MPP for funded session-based payment across repeated premium calls and budgeted automation.
How to start
The fastest way to evaluate the API is to begin with pricing discovery, then test a high-value decision or portfolio workflow using the access mode that fits your use case.
- Review live endpoint documentation
- Inspect pricing metadata and cost estimation
- Choose subscription, x402, or MPP
- Test a symbol or portfolio decision workflow
- Integrate agent usage and payment controls where applicable
Start using the API
Begin with the live API reference, review plans and access options, and explore decision, portfolio, pricing, and market intelligence endpoints built for modern financial applications and AI agents.
About Stock Trends
The Stock Trends API is built on a proprietary analytical framework developed and published continuously since 1993. It is not a raw market data feed — it is the structured output of decades of market trend analysis, probability modeling, and portfolio research.
The API delivers the same underlying intelligence used in the Stock Trends Weekly Reporter, enabling developers, AI agents, and financial applications to access decision-ready insights derived from long-term market structure, trend classification, and statistical validation.
For full context, methodology, and published research, visit the main Stock Trends site.