Access plans

Stock Trends API plans

Choose a self-serve subscription plan for Stock Trends API access, or contact us for enterprise and agent-oriented deployments.

Monthly subscriptions include protected API access, quota limits, and rate limits appropriate to each plan.

Access modes

Subscription plans cover API key access to the full endpoint set. Two additional access modes are available:

  • API reference — The interactive docs at /v1/docs and OpenAPI schema at /v1/openapi.json are publicly accessible. Use these to explore endpoints before subscribing. The live pricing catalog is available at GET /v1/pricing/catalog.
  • Agent pay via x402 — AI agents can pay per request on-chain without a subscription. Call a premium endpoint, receive HTTP 402 with payment instructions, submit payment, and retry with proof headers. No plan required.
  • Machine Payment Protocol (MPP) — Funded session-based payment for repeated agent workflows.

The live pricing catalog and API response headers are authoritative.

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.

No hidden conversion math: current USD cost = STC price × $1.00. Always check GET /v1/pricing/catalog and the payment-required response before running paid workflows.

Endpoints by use case

Market context and screening

  • GET /v1/market/regime/latest — Current regime classification
  • GET /v1/agent/screener/top — Top-ranked instruments
  • GET /v1/breadth/sector/latest — Sector breadth snapshot
  • GET /v1/stim/latest — Return distribution stats per symbol

Decision and portfolio workflows

  • POST /v1/decision/evaluate-symbol — Symbol-level evaluation
  • POST /v1/portfolio/evaluate — Evaluate a supplied portfolio
  • POST /v1/portfolio/compare — Compare two portfolios
  • POST /v1/portfolio/construct — Build a scored portfolio

Pricing and cost discovery

  • GET /v1/pricing/catalog — Live endpoint pricing rules (public)
  • GET /v1/cost-estimate — Estimate workflow cost before execution

Agent lifecycle and metering

  • GET /v1/agents/{agent_id}/usage — Usage summary
  • GET /v1/agents/{agent_id}/ledger — Economics ledger
  • POST /v1/agents/{agent_id}/disable — Disable an agent

Full documentation ?

Loading plans

Fetching the current live subscription plans from the control plane.

Need enterprise or agent-scale access?

For custom usage envelopes, internal workflows, partner integrations, or agent-scale deployments, contact Stock Trends directly.