Get today's top gaining and losing US stocks via Alpha Vantage, paid per-call with Tempo.
What it does
This endpoint returns the top gaining, losing, and most actively traded US-listed stocks for the current trading day. It is part of a broader Alpha Vantage service suite exposed through the Locus MPP (Micropayment Protocol) gateway, which wraps the Alpha Vantage API behind per-call crypto payments settled on Tempo L2.
The Top Gainers & Losers endpoint accepts a POST request with no required body parameters and returns market movers data. Each call costs 8,000 base units of pathUSD on Tempo (approximately $0.008 per request, assuming pathUSD uses 6 decimals). Payment is handled via the MPP 402 challenge-response flow — agents receive a payment challenge on the first unauthenticated request and settle via Tempo before the data is returned.
The endpoint is one of 26 Alpha Vantage paths available through this gateway, covering stock time series (intraday through monthly), fundamental data (income statements, balance sheets, cash flow, earnings), forex and crypto exchange rates, commodity prices, economic indicators (GDP, CPI, unemployment, etc.), technical indicators (SMA, EMA, MACD, RSI, Bollinger Bands), and news sentiment. All endpoints share the same per-call pricing. The upstream data source is Alpha Vantage (alphavantage.co). Note that the probe only confirmed a 402 challenge via the OpenAPI spec; HEAD and GET probes returned 404, which is expected since this endpoint requires POST.
Capabilities
Use cases
- —Automated daily market summary: an agent fetches top movers to generate a morning briefing
- —Portfolio monitoring: detect when held stocks appear in the top losers list
- —Trading signal generation: combine top gainers data with technical indicators for momentum screening
- —News correlation: pair top movers with the news-sentiment endpoint to understand price drivers
Fit
Best for
- —AI agents needing pay-per-call access to US stock market movers without API key management
- —Automated trading or research pipelines that need daily top gainers/losers snapshots
- —Developers building financial dashboards who want crypto-settled micropayments
Not for
- —Real-time streaming tick data — this is a snapshot endpoint, not a WebSocket feed
- —Non-US equity markets — Alpha Vantage top gainers/losers covers US-listed stocks only
- —High-frequency trading requiring sub-second latency
Quick start
curl -X POST https://alphavantage.mpp.paywithlocus.com/alphavantage/top-gainers-losers \
-H "Content-Type: application/json" \
-d '{}'Example
Request
{}Endpoint
Quality
The OpenAPI spec is well-structured with clear path definitions and payment info, but the specific endpoint has no request body schema and no response schema. The probe returned 404 on HEAD/GET (expected for a POST-only endpoint), so liveness via the 402 challenge was not directly confirmed at runtime. No example response data is available. Price currency decimals are inferred (pathUSD assumed 6 decimals) rather than confirmed.
Warnings
- —HEAD and GET probes returned 404; the endpoint is POST-only so the 402 MPP challenge was not directly captured at probe time
- —No response schema is documented — the structure of the returned JSON is unknown from the spec alone
- —pathUSD decimal precision assumed to be 6 (standard for USD stablecoins) but not explicitly confirmed in the probe data
- —Crawled pages all returned 404 JSON errors; no additional documentation was retrievable from the gateway itself
Citations
- —The endpoint is documented as 'Top Gainers & Losers' with POST method and Tempo payment at amount 8000https://alphavantage.mpp.paywithlocus.com
- —Alpha Vantage provides financial market data including stock prices, forex, crypto, commodities, economic indicators, technical analysis, and news sentimenthttps://www.alphavantage.co/documentation/docs
- —LLM-oriented documentation is available at the Locus skill filehttps://beta.paywithlocus.com/mpp/alphavantage.md