{"uid":"cap_h87YQwQSLNv9ebfSUubq7","slug":"top-market-movers-b5b308ec","name":"Top Market Movers","description":"The current top 20 gainers or losers of the day, ranked by percentage price change since the previous close. Only includes tickers with volume of 10,000 or more. Can't find what you're looking for? POST feedback to /feedback, no charge.","url":"https://agent.massive.com/v2/snapshot/locale/us/markets/stocks/:direction","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object","required":["direction"],"properties":{"direction":{"enum":["gainers","losers"],"type":"string","description":"The direction of the snapshot results to return."}}},"queryParams":{"type":"object","properties":{"include_otc":{"type":"boolean","description":"Include OTC securities in the response. Default is false (don't include OTC securities)."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_59w43dnxMSeZwXjyglgre","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the current top 20 stock gainers or losers of the day, ranked by percentage price change since the previous close, filtered to tickers with 10,000+ volume.","exampleAgentPrompt":"What are today's top 20 stock gainers — the ones with the biggest percentage gains since yesterday's close, US exchange stocks only, no OTC?","exampleUseCases":[{"title":"Morning trading watchlist scan","prompt":"Pull up today's top 20 biggest stock gainers by percentage since the previous close — US market only, no OTC — so I can build my morning watchlist."},{"title":"Short selling opportunity scan","prompt":"Which US stocks are the biggest losers today by percentage change? Give me the top 20 with the most significant drops since yesterday's close."},{"title":"Market momentum alert with OTC","prompt":"Show me today's top 20 gainers including OTC securities — I want to see everything moving up the most by percentage today across the full US market."}],"resultDescription":"A ranked list of up to 20 stock tickers with their percentage price change since the previous close, current price snapshot data, and volume — filtered to securities with at least 10,000 shares traded. Results are ordered by magnitude of price change (up for gainers, down for losers).","failureModes":["Invalid direction parameter (not 'gainers' or 'losers') returns an error","Market closed or pre-market hours may return stale or empty results","Payment failure (x402) if USDC is not provided or insufficient","No results if market data is unavailable for the day","OTC data missing if include_otc not explicitly set to true"],"whenToPreferThis":"Use this endpoint when you need a real-time ranked snapshot of the day's best or worst performing US stocks by percentage change. Ideal for building trading watchlists, momentum screening, or alerting workflows. Unlike full market data feeds, this is pre-ranked and filtered to liquid movers (10,000+ volume), saving computation. Prefer this over building your own sort from the All Tickers or Daily Market Summary endpoints when you specifically need top movers.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:30:20.456Z","isFirstParty":false}