{"uid":"cap_ABdA4pJtY8ijaxoPnRJ_b","slug":"massive-x402-api-us-stocks-snapshot-by-direction-ff3e33de","name":"Massive x402 API – US Stocks Snapshot by Direction","description":"US stock market data, sold per request over x402. Every path here answers 402 with the payment terms in the PAYMENT-REQUIRED header, and answers with the data once the payment settles. No account, no API key, no subscription.","url":"https://agent.massive.com/v2/snapshot/locale/us/markets/stocks/%7Bdirection%7D","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"status":"OK","tickers":[{"day":{"c":14.2284,"h":15.09,"l":14.2,"o":14.33,"v":133963,"dv":"133963.0","vw":14.5311},"min":{"c":14.2284,"h":14.325,"l":14.2,"n":5,"o":14.28,"t":1684428600000,"v":6108,"av":133963,"dv":"6108.0","vw":14.2426,"dav":"133963.0"},"ticker":"PDS","prevDay":{"c":0.73,"h":0.799,"l":0.73,"o":0.75,"v":1568097,"vw":0.7721},"updated":1605195848258266000,"lastQuote":{"P":14.44,"S":11,"p":14.2,"s":25,"t":1605195929997325600},"lastTrade":{"c":[63],"i":"79372124707124","p":14.2284,"s":536,"t":1605195848258266000,"x":4,"ds":"536.0"},"todaysChange":13.498,"todaysChangePerc":1849.096}]}},"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_mVcskjh-xxrI6UEUE9wUD","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 a real-time snapshot of US stock market tickers filtered by direction (gainers or losers), purchased per-request via x402 micropayment with no API key or subscription required.","exampleAgentPrompt":"What are the top gaining US stocks right now? Pull me the latest snapshot of today's biggest movers — I want to see price, volume, and how much they've changed.","exampleUseCases":[{"title":"Real-time top gainers dashboard","prompt":"Show me the top gaining US stocks right now with their current price, volume, and how much they've moved today — I want a live snapshot for my trading dashboard."},{"title":"Market losers alert for risk monitoring","prompt":"Pull the latest snapshot of the biggest losing US stocks today — I need ticker, price change percentage, and volume so I can flag unusual moves for our risk team."},{"title":"Pre-market movers briefing","prompt":"Give me a quick rundown of which US stocks are up the most so far today, including their last trade price and today's percentage change — I'm putting together a morning market brief."}],"resultDescription":"A JSON object with status 'OK' and an array of ticker snapshots, each containing: intraday OHLCV bar (open, high, low, close, volume, dollar volume, VWAP), latest minute bar with timestamp, previous day OHLC and VWAP, last quote (bid/ask prices and sizes), last trade (price, size, exchange, conditions), today's absolute change, and today's percentage change.","failureModes":["402 Payment Required — returned when no valid x402 payment header is supplied; response includes payment terms in PAYMENT-REQUIRED header","Invalid direction parameter — unsupported path segment returns error or empty result","Payment settlement failure — if USDC payment does not settle, data is not returned","Rate or network timeout — real-time data endpoint may time out under high load","Empty tickers array — returned if no stocks match the direction filter at the requested moment"],"whenToPreferThis":"Choose this endpoint when you need live US stock market snapshot data (gainers or losers) without committing to a subscription or managing API keys — ideal for pay-per-use agent workflows, one-off queries, or low-frequency polling where a $0.01/call micropayment model is more cost-effective than a monthly plan. Prefer it when your agent already supports the x402 payment protocol and you need structured OHLCV, quote, trade, and change data in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T13:01:18.882Z","isFirstParty":false}