{"uid":"cap_d8TZxsmsoIupmmOPyLKSg","slug":"alpha-vantage-top-gainers-losers-via-locus-x402-3842474f","name":"Alpha Vantage Top Gainers & Losers via Locus x402","description":"Financial market data — stock prices, forex, crypto, commodities, economic indicators, technical analysis, and news sentiment.","url":"https://alphavantage.x402.paywithlocus.com/alphavantage/top-gainers-losers","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","properties":{},"additionalProperties":true},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false}}},"responseSchema":{"type":"json","example":{"data":{},"payment":{"scheme":"exact","settledUsdc":"0.001000","authorizedMaxUsdc":"0.001000"},"request":{"id":"00000000-0000-4000-8000-000000000000","statusUrl":"/requests/00000000-0000-4000-8000-000000000000"},"success":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.008","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.008/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Xaa5R9dee5qZDYgAHfzN8","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.008","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the top gaining and losing stocks in the US market for the current trading session via Alpha Vantage, paid per-call with USDC.","exampleAgentPrompt":"Pull up today's top gaining and losing stocks from Alpha Vantage so I can see which equities are moving the most in the current trading session.","exampleUseCases":[{"title":"Daily market momentum briefing","prompt":"Give me a quick rundown of which US stocks are gaining and losing the most today — I want to see the top movers before the market closes."},{"title":"Volatility screening for day traders","prompt":"Pull the biggest gainers and losers right now from Alpha Vantage so I can scan for potential day-trade setups based on today's price action."},{"title":"Portfolio risk alert check","prompt":"Check today's top losers list and let me know if any of the worst-performing stocks are ones I should be concerned about as a market signal."}],"resultDescription":"Returns a structured JSON object containing lists of top gaining and top losing stocks for the current US market session, including ticker symbols, price changes, percentage changes, and trading volumes. Also includes payment settlement confirmation (USDC amount settled) and a request ID for tracking.","failureModes":["Market closed or outside trading hours — data may reflect previous session","Alpha Vantage API rate limit or outage causing empty or error data response","Payment failure — USDC transaction not authorized or insufficient balance","Malformed request body causing 400-level error","Data latency — real-time data may be delayed by 15-20 minutes depending on plan"],"whenToPreferThis":"Use this endpoint when you need a quick, ranked snapshot of the US equity market's top movers (gainers and losers) for the current session, especially in agentic workflows that require pay-per-call access without a standing Alpha Vantage subscription. Prefer this over direct Alpha Vantage API access when using the x402 micropayment protocol for on-demand, cost-efficient queries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:41:07.392Z","isFirstParty":false}