{"uid":"cap_cN6rUwqV7UfOxNUU66ER7","slug":"blockrun-spy-real-time-price-f8d2401e","name":"BlockRun SPY Real-Time Price","description":"US Stock realtime price for SPY","url":"https://blockrun-web-vbsbhh7lea-uc.a.run.app/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":{"request":{"input":{"path":{"symbol":"SPY"},"query":{"session":"pre"}}},"response":{"price":756.62771,"feedId":"0x19e09bb805456ada3979a7d1cbb4b6d63babc3a0f8e8a9509f68afa5c4c11cd5","source":"pyth","symbol":"SPY","category":"stocks/us","assetType":"equity","timestamp":"2026-05-29T20:00:21.000Z","confidence":0.10504,"publishTime":1780084821}},"exampleRequest":{"input":{"path":{"symbol":"SPY"},"query":{"session":"pre"}}},"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":1,"rating":{"score":"0.92","successRate":"1.00","reviews":1,"stars":"4.7","state":"rated"},"availabilityStatus":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/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_uk9vwda5XRF5GnEacbXfl","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 current real-time price of the SPY ETF (S&P 500 index fund) sourced from Pyth Network","exampleAgentPrompt":"What's the current real-time price of SPY right now, including confidence — and can you check the pre-market session specifically?","exampleUseCases":[{"title":"Portfolio rebalancing with live ETF prices","prompt":"I need to rebalance my portfolio today. Can you check what SPY is trading at right now so I can figure out my target allocations?"},{"title":"Market opening alarm for index traders","prompt":"It's almost market open tomorrow. Pull the latest SPY price for me so I can see where we're starting from and plan my trades accordingly."},{"title":"After-hours monitoring for evening trades","prompt":"The market just closed. What's SPY trading at in after-hours right now? I want to see if there's any significant movement before tomorrow."}],"resultDescription":"Returns a JSON object with the SPY ETF's current price (number), a confidence interval, the UTC timestamp and Unix publish time, the Pyth Network Hermes feed ID (0x-prefixed hex), asset type classified as 'equity', and the source identifier 'pyth'.","failureModes":["Invalid or unsupported ticker symbol returns an error","Market closed with no session parameter may return stale or unavailable data","Invalid session enum value (not 'pre', 'post', or 'on') causes a validation error","Payment failure (insufficient USDC) results in HTTP 402","Network timeout or Pyth feed unavailability causes service error"],"whenToPreferThis":"Use this endpoint when you need a real-time, high-confidence price for the SPY ETF specifically, with Pyth Network provenance and optional pre/post market session support. Prefer over aggregator APIs when you need a cryptographically-sourced price feed ID alongside the quote.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-06-10T03:35:03.972Z","lastSuccessfullyRanAt":"2026-06-10T03:35:03.972Z","lastHealthCheckAt":"2026-09-15T12:25:58.791Z","isFirstParty":false}