{"uid":"cap_no996g1J3GoQwYpweO1hg","slug":"blockrun-us-stock-ohlc-history-uso-b5794f32","name":"Blockrun US Stock OHLC History - USO","description":"US Stock OHLC bars for USO @ D","url":"https://blockrun-web-vbsbhh7lea-uc.a.run.app/api/v1/stocks/us/history/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","required":["from","to"],"properties":{"to":{"type":"integer","description":"Window end (Unix seconds)."},"from":{"type":"integer","description":"Window start (Unix seconds)."},"session":{"enum":["pre","post","on"],"type":"string","description":"Optional US market session."},"resolution":{"enum":["1","5","15","60","240","D","W","M"],"type":"string","default":"D","description":"Bar resolution (TradingView convention): 1/5/15/60/240 min, D day, W week, M month."}}}}},"output":{"type":"object","required":["symbol","resolution","bars","source"],"properties":{"to":{"type":"integer"},"bars":{"type":"array","items":{"type":"object","required":["t","o","h","l","c","v"],"properties":{"c":{"type":"number","description":"Close"},"h":{"type":"number","description":"High"},"l":{"type":"number","description":"Low"},"o":{"type":"number","description":"Open"},"t":{"type":"integer","description":"Bar start (Unix seconds)"},"v":{"type":"number","description":"Volume"}}}},"from":{"type":"integer"},"source":{"type":"string","const":"pyth"},"symbol":{"type":"string","example":"AAPL"},"resolution":{"type":"string","example":"D"}}}}},"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__la3EI_270ECeuTgYKNm7","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 historical OHLC (Open/High/Low/Close/Volume) bar data for USO (United States Oil Fund ETF) at configurable resolutions","exampleAgentPrompt":"Can you pull the daily OHLC bars for USO from January 1, 2024 to March 31, 2024? I want to see the open, high, low, close, and volume for each day.","exampleUseCases":[{"title":"Backtest oil ETF trading strategy","prompt":"I'm building a mean-reversion strategy on USO. Can you fetch the daily OHLC bars for the past six months so I can run my backtest and see how it would have performed?"},{"title":"Chart USO intraday price movements","prompt":"Can you pull hourly OHLC data for USO over the last two weeks? I want to chart the intraday price swings and spot any patterns in the oil ETF."},{"title":"Analyze weekly USO trend","prompt":"What did USO look like on a weekly basis over the past year? Grab the weekly open, high, low, close, and volume so I can identify the broader trend in oil prices."}],"resultDescription":"An array of OHLC bar objects each containing Unix timestamp (t), open (o), high (h), low (l), close (c), and volume (v) for USO at the requested resolution, along with metadata fields: symbol, resolution, from, to, and source (pyth).","failureModes":["Missing required 'from' or 'to' query parameters returns a 400 error","Invalid resolution enum value (not in 1/5/15/60/240/D/W/M) returns a 400 error","Date range with no trading data (e.g. holiday/weekend with minute resolution) may return empty bars array","Payment not provided or insufficient USDC returns 402 Payment Required","Future date range returns empty or partial bars","Very large date ranges at minute resolution may time out or return incomplete data"],"whenToPreferThis":"Use this endpoint when you need historical candlestick/OHLC bar data specifically for USO (United States Oil Fund ETF) at any supported resolution (minute, hourly, daily, weekly, monthly). Prefer this over realtime price endpoints when you need historical ranges for charting, backtesting, or trend analysis. Data is sourced from Pyth Network. Choose a sibling endpoint for other tickers like AAPL or NVDA.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:44:05.243Z","isFirstParty":false}