{"uid":"cap_QZpgTkgWDCU-2qzRjB13z","slug":"blockrun-us-stock-price-real-time-quote-via-pyth-54fecea0","name":"BlockRun US Stock Price — Real-Time Quote via Pyth","description":"US Stock realtime price for AAPL","url":"https://blockrun.ai/api/v1/usstock/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":295.52006,"feedId":"0x49f6b65cb1de6b10eaf75e7c03ca029c306d0357e91b5311b175084a5ad55688","source":"pyth","symbol":"AAPL","category":"stocks/us","assetType":"equity","timestamp":"2026-06-11T20:00:21.000Z","confidence":0.7839999999999999,"publishTime":1781208021}},"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.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","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_NRpV2-Vaud0BhNp_pEv2J","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 a real-time US stock price quote (with confidence interval and publish timestamp) for a given NYSE/Nasdaq/AMEX ticker, sourced from the Pyth oracle network.","exampleAgentPrompt":"What's the current price of NVDA stock right now, including pre-market session data and the confidence score?","exampleUseCases":[{"title":"Live portfolio valuation check","prompt":"Can you pull the current prices for AAPL, MSFT, and TSLA right now so I can see what my portfolio is worth today?"},{"title":"Real-time trade entry confirmation","prompt":"Before I place this buy order, what is SPY trading at right now and what's the confidence interval on that price?"},{"title":"On-demand earnings day price check","prompt":"NVDA just reported earnings — what's the latest real-time price and when was it last published by the oracle?"}],"resultDescription":"Returns a JSON object containing the ticker symbol, current price (e.g. 273.10), a confidence interval (e.g. 0.15), the Unix publish timestamp, an ISO-8601 UTC timestamp, the Pyth Hermes feed ID (0x-prefixed hex), asset type (equity), and the data source identifier ('pyth').","failureModes":["Unknown or unsupported ticker symbol returns an error or empty result","Invalid session enum value (not pre/post/on) causes a 400 bad request","Payment failure (insufficient USDC balance) returns HTTP 402 Payment Required","Pyth oracle temporarily unavailable causes a 503 or stale data response","Rate limiting or gateway overload may return 429 Too Many Requests"],"whenToPreferThis":"Use this endpoint when you need real-time US equity prices sourced from the Pyth oracle network without managing traditional API keys, and when you want pay-per-call micropayment billing settled in USDC on Base or Solana. Ideal for AI agents that need low-friction, on-demand stock price data with cryptographic provenance (feed ID, publish time, confidence interval) rather than a subscription-based data feed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:52:26.751Z","isFirstParty":false}