{"uid":"cap_a5_AVUkIbmFDW13pGFg55","slug":"x402stock-stock-quote-api-8e72729d","name":"x402stock Stock Quote API","description":"Pay-per-call market and economic data API for AI agents: US stocks, ETFs and options, forex, crypto and on-chain perps, energy commodities, US and global macro (Fed, CPI, jobs, GDP, Treasury, World Bank), SEC filings, congressional trades, and market sentiment. No API keys, no accounts. Pay per request in USDC via x402 on Base.","url":"https://x402stock.xyz/api/v1/quote/%7Bticker%7D","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"data":{"day":{"low":309.53,"high":315,"open":311.775,"vwap":311.9766,"close":312.06,"volume":70030122},"price":311.35,"change":-1.16,"timestamp":"2026-05-29T20:00:00.000Z","delayed_by":"15 minutes","is_delayed":true,"change_percent":-0.371,"previous_close":312.51},"as_of":"2026-05-29T20:00:00.000Z","source":"x402stock","ticker":"AAPL"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.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_8OCDPOwAWouQAPLB2bnWK","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 (15-minute delayed) stock quote for a given US ticker symbol, including price, change, OHLCV, and VWAP data, paid per-call in USDC via x402.","exampleAgentPrompt":"What's the current stock price of AAPL, including today's high, low, volume, and how much it's changed from yesterday's close?","exampleUseCases":[{"title":"Compare ETF prices before rebalancing","prompt":"Can you pull up today's quotes for SPY, QQQ, and IWM — I want to see how each is trading, what volume looks like, and how far they've moved from yesterday's close before I decide how to rebalance?"},{"title":"Check NVDA momentum during earnings season","prompt":"What's NVDA trading at right now, and can you show me today's open, high, low, VWAP, and how much it's moved in percentage terms from the previous close?"},{"title":"Monitor portfolio stocks for intraday swings","prompt":"I want a quick snapshot of META, AMZN, and MSFT — give me the current price, today's high and low, and how much each one has changed so far today so I can spot any big intraday moves."}],"resultDescription":"A JSON object containing the ticker symbol, current price, price change (absolute and percent), previous close, day OHLCV (open, high, low, close, volume), VWAP, timestamp, data source, and a flag indicating the data is delayed by 15 minutes.","failureModes":["Invalid or unknown ticker symbol returns an error or empty result","Network timeout if the upstream market data provider is slow","Payment failure if the x402/USDC transaction is rejected or wallet has insufficient funds","Market closed hours may affect data freshness or availability","Rate limiting if too many requests are made in rapid succession"],"whenToPreferThis":"Use this endpoint when an AI agent needs structured, per-call stock quote data for US equities or ETFs without committing to a subscription or API key. It is ideal for lightweight, on-demand price lookups in agent workflows where pay-per-use billing in USDC is acceptable and the 15-minute delay is tolerable.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:30:01.913Z","isFirstParty":false}