{"uid":"cap_7BDyZOmxfR2BgvvpnLj1r","slug":"blockrun-uso-real-time-stock-price-e17dfeb5","name":"BlockRun USO Real-Time Stock Price","description":"US Stock realtime price for USO","url":"https://blockrun-web-vbsbhh7lea-uc.a.run.app/api/v1/stocks/us/price/USO","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":"USO"},"query":{"session":"on"}}},"response":{"price":128.94633,"feedId":"0xd00bd77d97dc5769de77f96d0e1a79cbf1364e14d0dbf046e221bce2e89710dd","source":"pyth","symbol":"USO","category":"stocks/us","assetType":"equity","timestamp":"2026-05-29T20:00:21.000Z","confidence":0.19915,"publishTime":1780084821}},"exampleRequest":{"input":{"path":{"symbol":"USO"},"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_Qq_wgfmZNXHIRZLOyGUIT","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 for USO (United States Oil Fund ETF) sourced from Pyth Network oracle","exampleAgentPrompt":"What is the current real-time price of USO — the US oil ETF — right now during regular market hours, and how confident is the Pyth oracle feed in that price?","exampleUseCases":null,"resultDescription":"Returns a JSON object containing the USO ticker symbol, current price (e.g. 73.45), a confidence value indicating price uncertainty from the Pyth oracle, a Unix publishTime timestamp, an ISO-8601 UTC timestamp, the Pyth Hermes feed ID (0x-prefixed hex), the asset type ('equity'), and the source identifier ('pyth').","failureModes":["Symbol not found or unsupported ticker — 404 or error response","Market closed outside session — may return stale or unavailable data","Payment failure (x402 protocol) — 402 Payment Required if USDC not provided","Pyth oracle feed temporarily unavailable — no price data returned","Invalid session enum value — 400 Bad Request"],"whenToPreferThis":"Use this endpoint when you need a real-time, oracle-verified price for USO (United States Oil Fund ETF) with a confidence interval from the Pyth Network. Prefer this over traditional market data APIs when operating in a crypto-native or x402 payment environment, or when you need on-chain-compatible price data with provenance. Especially useful for agents needing oil/energy sector ETF pricing with cryptographic confidence scores.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:43:27.280Z","isFirstParty":false}