{"uid":"cap_s3PP6eT0KoWFobFaA8iO2","slug":"blockrun-ai-us-stock-realtime-price-spy-a131e86e","name":"BlockRun.AI US Stock Realtime Price – SPY","description":"US Stock realtime price for SPY","url":"https://blockrun.ai/api/v1/stocks/us/price/SPY","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"input":{"type":"object","properties":{"path":{"type":"object","required":["symbol"],"properties":{"symbol":{"type":"string","example":"AAPL","description":"NYSE/Nasdaq/AMEX ticker (AAPL, TSLA, NVDA, CRCL, SPY, …)."}}},"query":{"type":"object","properties":{"session":{"enum":["pre","post","on"],"type":"string","description":"Optional US market session. Omit for regular hours."}}}}},"output":{"type":"object","required":["symbol","price","confidence","publishTime","source"],"properties":{"price":{"type":"number","example":273.1},"feedId":{"type":"string","description":"Pyth Hermes feed ID (0x-prefixed hex)"},"source":{"type":"string","const":"pyth"},"symbol":{"type":"string","example":"AAPL"},"assetType":{"enum":["equity","crypto","fx","metal"],"type":"string"},"timestamp":{"type":"string","description":"ISO-8601 UTC"},"confidence":{"type":"number","example":0.15},"publishTime":{"type":"integer","description":"Unix seconds"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0pIwYjJw1CJkcX7L8LWSL","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the real-time price of the SPY ETF (S&P 500) from Pyth Network for US equity markets, with optional pre/post-market session support.","exampleAgentPrompt":"What's the current real-time price of SPY right now, including the confidence interval? Use regular trading hours session.","exampleUseCases":[{"title":"Live SPY price for trading dashboard","prompt":"Pull the latest real-time price of SPY for my trading dashboard — I need the current price and confidence interval during regular market hours."},{"title":"Pre-market SPY price check","prompt":"What is SPY trading at in the pre-market session right now? I want the latest quote with its publish timestamp."},{"title":"Automated portfolio valuation","prompt":"Fetch the current live price of SPY so I can update the value of my S&P 500 ETF holdings in my portfolio tracker."}],"resultDescription":"Returns a JSON object containing the SPY ticker symbol, real-time price (e.g. 273.1), a confidence interval, ISO-8601 UTC timestamp, Unix publish time, Pyth Hermes feed ID (0x-prefixed hex), asset type ('equity'), and source identifier ('pyth').","failureModes":["Invalid or unsupported ticker symbol returns error","Market closed outside of requested session hours may return stale or no data","Network latency from Pyth oracle may cause brief delays","Incorrect session enum value (not 'pre', 'post', or 'on') returns validation error","Payment failure (insufficient USDC) blocks the request via x402"],"whenToPreferThis":"Prefer this endpoint when you need a real-time, oracle-backed price for SPY with a confidence score, especially in automated trading, portfolio valuation, or DeFi-adjacent workflows that already use Pyth Network data. It supports pre- and post-market sessions, making it suitable beyond regular trading hours. Choose it over general financial APIs when you need Pyth-sourced data with a feed ID for on-chain or crypto-native integrations.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:43:48.162Z","isFirstParty":false}