{"uid":"cap_mVrTO5hjEjBJlWbfaQaAo","slug":"x402stock-xyz-7a196512","name":"x402stock.xyz US Equity Gainers","description":"The day's biggest percentage gainers across US equities, with current and previous-day OHLCV per ticker. From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.","url":"https://x402stock.xyz/api/v1/gainers","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"limit":{"type":"integer","maximum":100,"exclusiveMinimum":0}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","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}}}}},"responseSchema":{"type":"json","example":{"as_of":"2026-05-29T20:00:00.000Z","count":1,"source":"x402stock","tickers":[{"day":{"low":23.06,"high":26.11,"open":25.94,"vwap":24.3,"close":23.55,"volume":19121},"change":16.1942,"ticker":"CBRX","updated":"2026-05-29T19:58:00.000Z","previous_day":{"low":6.91,"high":7.44,"open":6.97,"vwap":7.17,"close":7.36,"volume":58578},"change_percent":220.03}],"direction":"gainers"}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"limit":10}}},"response":{"as_of":"2026-06-12T03:08:25.324Z","count":10,"source":"x402stock","tickers":[{"day":{"low":1,"high":2.35,"open":1.2,"vwap":1.494,"close":1.88,"volume":2938878},"change":1.63,"ticker":"SPKLW","updated":"2026-06-11T23:52:00.000Z","previous_day":{"low":0.32,"high":0.36,"open":0.32,"vwap":0.3486,"close":0.35,"volume":11540},"change_percent":465.7142857142857},{"day":{"low":5.85,"high":17.49,"open":16.53,"vwap":11.0315,"close":5.98,"volume":65396225},"change":6.109999999999999,"ticker":"EDHL","updated":"2026-06-12T00:00:00.000Z","previous_day":{"low":3.24,"high":3.66,"open":3.33,"vwap":4.3872,"close":3.5,"volume":2080495.858516},"change_percent":174.57142857142856},{"day":{"low":5.15,"high":8.15,"open":7.02,"vwap":6.7448,"close":7.41,"volume":15059607},"change":4.27,"ticker":"QH","updated":"2026-06-12T00:00:00.000Z","previous_day":{"low":3.25,"high":5.89,"open":4.73,"vwap":7.2534,"close":3.25,"volume":17410758.485565},"change_percent":131.38461538461536},{"day":{"low":0.508849,"high":2.01,"open":0.5219,"vwap":1.2316,"close":1.53,"volume":153367417},"change":0.5555000000000001,"ticker":"GELS","updated":"2026-06-12T00:00:00.000Z","previous_day":{"low":0.4872,"high":0.519,"open":0.4872,"vwap":0.5058,"close":0.5145,"volume":13521},"change_percent":107.9689018464529},{"day":{"low":1.025,"high":1.32,"open":1.14,"vwap":2.169,"close":1.05,"volume":27504302},"change":1.1703,"ticker":"BYAH","updated":"2026-06-12T00:00:00.000Z","previous_day":{"low":1.15,"high":1.45,"open":1.45,"vwap":1.2879,"close":1.24,"volume":412017.578505},"change_percent":94.37903225806451},{"day":{"low":2.02,"high":4.79,"open":2.55,"vwap":3.5321,"close":2.08,"volume":113890202},"change":0.774,"ticker":"GLXG","updated":"2026-06-12T00:00:00.000Z","previous_day":{"low":0.9201,"high":1.06,"open":0.96,"vwap":1.012,"close":0.9761,"volume":219743},"change_percent":79.29515418502203},{"day":{"low":28.03,"high":47.06,"open":29.37,"vwap":40.0058,"close":44.7799,"volume":163316},"change":18.229899999999997,"ticker":"VELL","updated":"2026-06-12T00:00:08.490Z","previous_day":{"low":19.57,"high":27.8,"open":21.28,"vwap":24.7394,"close":26.55,"volume":80778.50541},"change_percent":68.66252354048963},{"day":{"low":0.47,"high":1.02,"open":1.015,"vwap":0.9668,"close":0.5201,"volume":135814128},"change":0.22899999999999998,"ticker":"CCHH","updated":"2026-06-12T00:00:00.000Z","previous_day":{"low":0.3005,"high":0.4321,"open":0.325,"vwap":0.7386,"close":0.346,"volume":28237309.445076},"change_percent":66.1849710982659},{"day":{"low":0.0381,"high":0.0495,"open":0.0428,"vwap":0.04658,"close":0.0483,"volume":910160},"change":0.023799999999999995,"ticker":"MNTSW","updated":"2026-06-11T23:51:00.000Z","previous_day":{"low":0.03,"high":0.0459,"open":0.0459,"vwap":0.03946,"close":0.0381,"volume":315358},"change_percent":62.467191601049855},{"day":{"low":0.0159,"high":0.024,"open":0.0182,"vwap":0.02041,"close":0.024,"volume":33617},"change":0.0089,"ticker":"ASBPW","updated":"2026-06-11T19:42:00.000Z","previous_day":{"low":0.0151,"high":0.0152,"open":0.0152,"vwap":0.01513,"close":0.0151,"volume":1736},"change_percent":58.94039735099338}],"direction":"gainers"}},"exampleRequest":{"limit":10},"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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"}]},"paymentMethods":[{"uid":"pm_JDsOIpsjbEepHhJK6mzzY","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the day's biggest percentage gainers across US equities with current and previous-day OHLCV data per ticker.","exampleAgentPrompt":"Pull today's biggest percentage gainers for US stocks — I want to see which tickers are up the most, along with their OHLCV and how they compare to yesterday's close.","exampleUseCases":[{"title":"Morning market briefing for traders","prompt":"Can you check what's rallying hardest in the US stock market right now? I need the top gainers with their open, high, low, close prices and volumes so I can see if there's a trend worth trading."},{"title":"Momentum screen for active investors","prompt":"Show me today's biggest movers by percentage — the stocks that are really gaining. I want the full price action from open to now, plus yesterday's levels so I can spot momentum plays."},{"title":"End-of-day performance review","prompt":"Give me a snapshot of today's winners across US equities. I'm looking for which tickers jumped the most in percentage terms, with their volume and pricing data to understand what moved the market."}],"resultDescription":"A JSON object containing an as_of timestamp, a count, the direction ('gainers'), and an array of ticker objects each with: ticker symbol, absolute change, percentage change, last-updated timestamp, and full OHLCV+VWAP for both the current day and previous day.","failureModes":["Market closed or no data yet for today — may return empty tickers array or stale as_of","Payment failure (402) if USDC payment header is missing or insufficient","Rate limiting or service unavailability returning 429 or 5xx","Outside US market hours may return incomplete intraday data"],"whenToPreferThis":"Choose this endpoint when you need a ranked list of the day's top US equity percentage gainers with full OHLCV context in a single call, rather than screening individual tickers or fetching end-of-day snapshots separately. Ideal for market-open scans, momentum strategies, or daily briefings.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:41:29.658Z","isFirstParty":false}