{"uid":"cap_NIvyiL5uU-9icLckMbh76","slug":"x402stock-top-market-gainers-0e33eb1d","name":"x402stock Top Market Gainers","description":"The day's biggest percentage gainers across US equities, with current and previous-day OHLCV per ticker.","url":"https://agents.x402stock.xyz/api/v1/gainers?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"integer","maximum":100,"exclusiveMinimum":0}}},"responseSchema":{"type":"object","required":["source","as_of","direction","count","tickers"],"properties":{"as_of":{"type":"string"},"count":{"type":"number"},"source":{"type":"string","const":"x402stock"},"tickers":{"type":"array","items":{"type":"object","required":["ticker","change","change_percent","updated"],"properties":{"day":{"type":"object","required":["open","high","low","close","volume","vwap"],"properties":{"low":{"type":"number"},"high":{"type":"number"},"open":{"type":"number"},"vwap":{"type":"number"},"close":{"type":"number"},"volume":{"type":"number"}},"additionalProperties":false},"change":{"type":"number"},"ticker":{"type":"string"},"updated":{"anyOf":[{"type":"string"},{"type":"null"}]},"previous_day":{"type":"object","required":["open","high","low","close","volume","vwap"],"properties":{"low":{"type":"number"},"high":{"type":"number"},"open":{"type":"number"},"vwap":{"type":"number"},"close":{"type":"number"},"volume":{"type":"number"}},"additionalProperties":false},"change_percent":{"type":"number"}},"additionalProperties":false}},"direction":{"enum":["gainers","losers"],"type":"string"}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USD","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_OTGRy9w__w7a7LMHX6ojs","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_MCcE-gI0eTqr2UTQ3_Kkz","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the top gaining US stocks, ETFs, or related instruments for the current trading session, paid per request in USDC via x402.","exampleAgentPrompt":"What are the top gaining stocks in the US market right now? Give me today's biggest winners with their percentage moves and volume.","exampleUseCases":[{"title":"Daily market movers briefing","prompt":"Pull today's top stock gainers for me — I want to see which tickers are up the most right now, with their percentage gains and volume."},{"title":"Momentum trading screening","prompt":"Show me the biggest percentage gainers in the US stock market today so I can look for momentum trading setups."},{"title":"Morning market recap","prompt":"I'm putting together a morning market summary — what are the top gainers in the stock market so far today?"}],"resultDescription":"A ranked list of the top gaining US stocks or ETFs for the current session, including ticker symbols, company names, price change, percentage gain, volume, and potentially market cap or other ranking signals.","failureModes":["Market closed or pre-market hours may return empty or limited results","Payment failure if insufficient USDC balance via x402","Rate limiting if quota exceeded","Malformed or missing properties parameter may yield default or error response","Network timeout from upstream data provider"],"whenToPreferThis":"Use this endpoint when you need real-time or intraday data on the top performing US equities by percentage gain. Prefer this over general quote or screener endpoints when the specific goal is to rank today's winners quickly in a single call, especially in agentic workflows where pay-per-use with no API key setup is desirable.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T07:00:44.790Z","isFirstParty":false,"canonicalSlug":"x402stock-top-market-gainers-0e33eb1d"}