{"uid":"cap_UH5sL_qV3QSa_rF8YsGlM","slug":"blockrun-aapl-us-stock-realtime-price-087c7779","name":"BlockRun AAPL US Stock Realtime Price","description":"US Stock realtime price for AAPL","url":"https://blockrun-web-vbsbhh7lea-uc.a.run.app/api/v1/stocks/us/price/AAPL","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":"AAPL"},"query":{"session":"on"}}},"response":{"price":312.087,"feedId":"0x49f6b65cb1de6b10eaf75e7c03ca029c306d0357e91b5311b175084a5ad55688","source":"pyth","symbol":"AAPL","category":"stocks/us","assetType":"equity","timestamp":"2026-05-29T20:00:19.000Z","confidence":0.31294,"publishTime":1780084819}},"exampleRequest":{"input":{"path":{"symbol":"AAPL"},"query":{"session":"on"}}},"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.67","reviews":0,"stars":null,"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_j8VZQSqEaED3gzfc68AXB","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 Apple Inc. (AAPL) stock sourced from Pyth Network, with optional pre/post/on-session filtering.","exampleAgentPrompt":"What's the real-time price of AAPL right now during the regular session? I need the Pyth-sourced price along with the confidence interval.","exampleUseCases":null,"resultDescription":"Returns a JSON object with the current AAPL stock price (e.g. 270.74), a confidence margin (e.g. 0.153), the Pyth Hermes feed ID (0x-prefixed hex), asset type ('equity'), ISO-8601 timestamp, and Unix publish time.","failureModes":["Invalid or unsupported ticker symbol returns an error — only supported tickers (AAPL, TSLA, NVDA, etc.) are valid","Invalid session enum value (not 'pre', 'post', or 'on') returns a validation error","Payment failure (missing or insufficient x402 USDC payment) returns 402 Payment Required","Pyth feed temporarily unavailable causes stale or missing data response","Network timeout on the upstream Pyth Hermes feed"],"whenToPreferThis":"Use this endpoint when you need a real-time, oracle-sourced (Pyth Network) price for AAPL specifically, with a confidence score and Pyth feed ID — especially in contexts where on-chain verifiability or micropayment-per-call (x402 protocol) is required, rather than a traditional REST API key subscription.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":15,"lastUsedAt":"2026-07-18T00:28:46.290Z","lastSuccessfullyRanAt":"2026-06-26T20:25:31.929Z","lastHealthCheckAt":"2026-09-15T13:25:49.596Z","isFirstParty":false}