MPP Quickstart

Use the Stock Trends API with MPP

Machine Payment Protocol (MPP) is the funded session-based payment rail for the Stock Trends API.

Instead of settling each request independently on-chain, agents operate against a funded session balance using repeated premium calls.

MPP is optimized for AI-agent workflows, portfolio automation, financial research systems, and recurring premium intelligence execution.

Open API docs Back to docs x402 quickstart

MPP vs x402

MPP

Best for repeated agent workflows

  • Fund a session once
  • Use repeated premium requests
  • Lower friction than repeated on-chain settlement
  • Budgeted automation and portfolio workflows
x402

Best for permissionless pay-per-request usage

  • No funded session required
  • Per-request settlement
  • Event-driven execution
  • Permissionless machine payment

Recommended MPP workflow

  1. Discover workflows using GET /v1/ai/tools
  2. Inspect live pricing using GET /v1/pricing/catalog
  3. Create or receive a funded MPP session
  4. Store the provided channel_id
  5. Execute repeated premium requests
  6. Monitor economics and usage via agent ledger endpoints

Pricing clarity: STC and USD cost

Stock Trends Credits (STC) are the API pricing unit.

Current billing presentation: 1 STC = $1.00 USD

Endpoint price Current USD cost
0.15 STC $0.15 USD
0.50 STC $0.50 USD
1.25 STC $1.25 USD

The live pricing catalog and response headers remain authoritative.

Recommended first premium endpoint

GET https://api.stocktrends.com/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)

Required MPP headers

Header Example Description
X-StockTrends-Payment-Method mpp Payment rail identifier
X-StockTrends-Payment-Network base Network context
X-StockTrends-Payment-Reference mpp-ref-12345 Unique request reference
X-StockTrends-Payment-Amount 0.5 Presented request amount in STC
X-StockTrends-Payment-Channel-Id mppch_... Funded MPP session identifier

Optional agent identity headers

X-StockTrends-Agent-Id: your-agent-id
X-StockTrends-Agent-Type: autonomous
X-StockTrends-Agent-Vendor: your-vendor
X-StockTrends-Request-Purpose: screening

Example MPP request

curl "https://api.stocktrends.com/v1/agent/screener/top" \
  -H "X-StockTrends-Agent-Id: your-agent-id" \
  -H "X-StockTrends-Payment-Method: mpp" \
  -H "X-StockTrends-Payment-Network: base" \
  -H "X-StockTrends-Payment-Reference: mpp-ref-12345" \
  -H "X-StockTrends-Payment-Amount: 0.5" \
  -H "X-StockTrends-Payment-Channel-Id: mppch_..."

The API authorizes the request against the funded session, serves the premium response, and updates the session balance.

Who MPP is for

  • Repeated premium AI-agent workflows
  • Portfolio automation systems
  • Financial intelligence research pipelines
  • Budgeted recurring API execution
  • Lower-friction premium automation

Next steps

  • Use x402 for permissionless pay-per-request execution
  • Add ST-IM intelligence to portfolio workflows
  • Combine regime, breadth, and leadership intelligence
Open API docs x402 quickstart Back to docs