--- name: blockrun-web-vbsbhh7lea-uc.a.run.app description: blockrun-web-vbsbhh7lea-uc.a.run.app provides real-time spot price lookups for US equities, ETFs, and Korean stocks sourced from the Pyth Network oracle. Each skill returns a single latest price snapshot with confidence interval, publish timestamp, and feed metadata. No historical data, streaming, or order execution is available. host: blockrun-web-vbsbhh7lea-uc.a.run.app --- # blockrun-web-vbsbhh7lea-uc.a.run.app This host is a price-feed aggregator built on Pyth Network data, serving agents that need current equity prices for US stocks, sector ETFs, commodity ETFs, bond ETFs, and Korean equities. It offers both fixed-ticker endpoints (one skill per symbol) and parameterized endpoints for flexible symbol lookup. It is not a trading, portfolio management, or historical data service — it is purely a real-time price oracle relay. ## When to use this host Use this host when an agent needs the current real-time spot price of a specific US equity, US ETF, or Korean stock sourced from Pyth Network, with confidence interval and feed provenance. For parameterized US stock lookups, prefer fetch-us-stock-spot-price or fetch-us-stock-price over the fixed-ticker skills to avoid maintaining per-symbol skill references. Do not use this host for: historical price series or OHLCV data (use a dedicated market data provider such as Polygon.io or Alpha Vantage); streaming or tick-by-tick price feeds; non-US, non-Korean equities (e.g. LSE, TSE, XETRA, Euronext — the skill descriptions hint at dedicated endpoints elsewhere); crypto asset prices (use a crypto-specific oracle host); or any trade execution, order routing, or portfolio management operations. ## Capabilities ### Parameterized US Equity Price Lookup Flexible endpoints that accept a ticker symbol as input, enabling agents to query any supported US-listed stock price without needing a symbol-specific skill. - **`fetch-us-stock-price`** — Returns the current US equity price for NVDA sourced from Pyth, including confidence interval, publish time, and feed metadata. - **`fetch-us-stock-spot-price`** — Returns the current spot price for a US-listed stock symbol sourced from Pyth Network, including price, confidence interval, and publish timestamp. ### Fixed US Stock Price Feeds Hardcoded single-symbol endpoints for specific US equities (MU, NVDA, CRCL), returning the latest price, confidence, and Pyth feed metadata. - **`fetch-us-stock-price`** — Returns the current US equity price for NVDA sourced from Pyth, including confidence interval, publish time, and feed metadata. - **`fetch-us-stock-price-crcl`** — Returns the current US equity price for CRCL (Circle Internet Group) sourced from Pyth, including price, confidence interval, and publish timestamp. ### US Broad Market ETF Prices Fixed-ticker price feeds for major broad-market index ETFs (SPY, QQQ, DIA, IWM, VOO), useful for market-level valuation and benchmark comparisons. - **`fetch-us-stock-price-spy`** — Returns the latest SPY US equity price with confidence score, publish time, and Pyth feed metadata via a single GET request. - **`fetch-qqq-us-stock-price`** — Returns the latest real-time US equity price for QQQ (Invesco QQQ Trust) including price, confidence interval, publish time, and data source. - **`fetch-us-stock-price-dia`** — Returns the latest US equity price for DIA (SPDR Dow Jones Industrial Average ETF) including confidence score, publish time, and data source. - **`fetch-iwm-us-price`** — Returns the latest real-time US equity price for IWM (iShares Russell 2000 ETF) sourced from Pyth, including confidence interval and publish timestamp. - **`fetch-us-stock-price-voo`** — Returns the latest US equity price for VOO (Vanguard S&P 500 ETF) including price, confidence score, publish time, and data source. ### Commodity and Sector ETF Prices Fixed-ticker price feeds for commodity-linked and sector ETFs (GLD, SLV, USO, XLE), enabling agents to track gold, silver, oil, and energy sector pricing. - **`fetch-us-stock-price-gld`** — Returns the latest US equity price for GLD (SPDR Gold Shares) including price, confidence interval, publish time, and data source from Pyth. - **`fetch-slv-us-stock-price`** — Returns the latest US equity price for SLV (iShares Silver Trust) sourced from Pyth, including price, confidence, publish time, and feed metadata. - **`fetch-uso-stock-price`** — Returns the latest USO (United States Oil Fund) stock price with confidence score, publish time, and source metadata from Pyth Network. - **`fetch-us-stock-price-xle`** — Returns the current US equity price for XLE (Energy Select Sector SPDR Fund) sourced from Pyth, including price, confidence interval, and publish timestamp. ### Bond and International ETF Prices Fixed-ticker price feeds for fixed-income and international equity ETFs (BND, BSV, VXUS), supporting portfolio diversification monitoring across asset classes. - **`fetch-us-stock-price-bnd`** — Returns the latest US equity price for BND (Vanguard Total Bond Market ETF) including confidence interval, publish time, and Pyth feed metadata. - **`fetch-us-stock-price-bsv`** — Returns the latest US equity price for BSV (ticker symbol) including price, confidence score, publish time, and data source metadata. - **`fetch-vxus-stock-price`** — Returns the latest U.S. equity price for VXUS (Vanguard Total International Stock ETF) sourced from Pyth, including price, confidence interval, and publish timestamp. ### Korean Equity Price Lookup Parameterized endpoint for fetching the latest price of Korean equities by KRX ticker code, sourced from Pyth, with confidence and timestamp metadata. - **`fetch-kr-stock-price`** — Returns the latest price for a Korean stock by ticker symbol, sourced from Pyth, including confidence interval, publish time, and asset metadata. ## Workflows ### Multi-Asset Portfolio Snapshot *Use when an agent needs to value a portfolio containing a mix of US equities, ETFs, and Korean stocks by fetching current prices for each holding.* 1. **`fetch-us-stock-spot-price`** — Fetch the current price for each US equity holding using the parameterized symbol input. 2. **`fetch-kr-stock-price`** — Fetch the current price for each Korean equity holding using the KRX ticker code. 3. **`fetch-us-stock-price-spy`** — Fetch the SPY benchmark price to contextualize US equity performance against the S&P 500. ### Commodity vs Equity Relative Pricing *Use when an agent needs to compare commodity ETF prices (gold, silver, oil) against a broad equity benchmark to assess relative value or risk-off signals.* 1. **`fetch-us-stock-price-gld`** — Fetch the current GLD price as a gold proxy. 2. **`fetch-slv-us-stock-price`** — Fetch the current SLV price as a silver proxy. 3. **`fetch-uso-stock-price`** — Fetch the current USO price as an oil proxy. 4. **`fetch-us-stock-price-spy`** — Fetch the SPY price as the broad equity benchmark for comparison. ## Skill reference ### `fetch-us-stock-price` **MU Stock Price** — Returns the latest US equity price for Micron Technology (MU) including price, confidence interval, publish timestamp, and data source metadata from Pyth. *Use when:* Use when an agent needs the current market price of MU (Micron Technology) stock, including the feed confidence value, asset type confirmation, and the originating oracle source. *Not for:* Do not use for historical price data or price series; this returns a single latest quote only. Not suitable for non-MU tickers — use a parameterized stock price endpoint for other symbols. **Returns:** Returns a JSON object with symbol, category, price (USD), confidence interval, publishTime (unix), ISO timestamp, assetType, feedId, and source (pyth). **Example:** `GET https://blockrun-web-vbsbhh7lea-uc.a.run.app/api/v1/stocks/us/price/MU` --- ### `fetch-kr-stock-price` **KR Stock Price Lookup** — Returns the latest price for a Korean stock by ticker symbol, sourced from Pyth, including confidence interval, publish time, and asset metadata. *Use when:* Use when an agent needs the current market price of a Korean equity by its KRX ticker code (e.g. 000660 for SK Hynix), along with price confidence and timestamp. *Not for:* Do not use for non-Korean equities or crypto assets; use a dedicated global stock or crypto price endpoint instead. Not suitable for historical price series — this returns a single latest quote only. **Inputs:** - `symbol` (string, required) — KRX ticker symbol of the Korean stock to look up, embedded in the URL path (e.g. 000660 for SK Hynix). **Returns:** Returns a JSON object with symbol, price in KRW, confidence interval, publishTime, ISO timestamp, assetType, Pyth feedId, and source for the requested Korean stock ticker. **Example:** `GET https://blockrun-web-vbsbhh7lea-uc.a.run.app/api/v1/stocks/kr/price/000660` --- ### `fetch-us-stock-price` **US Stock Price** — Returns the latest US equity price for a given stock symbol, sourced from Pyth, including confidence interval and publish timestamp. *Use when:* Use when an agent needs the current market price of a US-listed stock (e.g. TSLA) along with price confidence, asset type, and the Pyth feed ID for on-chain reference. *Not for:* Do not use for non-US equities, crypto assets, or historical price series; this is a single-shot latest-price lookup only. **Inputs:** - `symbol` (string, required) — US stock ticker symbol embedded in the URL path (e.g. TSLA, AAPL, MSFT). **Returns:** Returns a JSON object with TSLA's latest USD price (422.14), Pyth confidence interval, publish timestamp, asset type 'equity', and the Pyth feed ID. **Example:** `GET https://blockrun-web-vbsbhh7lea-uc.a.run.app/api/v1/stocks/us/price/TSLA` --- ### `fetch-us-stock-price` **NVDA Stock Price** — Returns the current US equity price for NVDA sourced from Pyth, including confidence interval, publish time, and feed metadata. *Use when:* Use when an agent needs the latest market price for NVDA (Nvidia) stock as a numeric value with confidence and timestamp, suitable for display, calculation, or downstream trading logic. *Not for:* Do not use for historical price data or other US stock tickers; this endpoint is hardcoded to NVDA only. Not suitable for streaming or real-time tick data. **Returns:** Returns a JSON object with NVDA's current USD price (222.14), a Pyth confidence interval, publish timestamp, asset type of equity, and the Pyth feed ID. **Example:** `GET https://blockrun-web-vbsbhh7lea-uc.a.run.app/api/v1/stocks/us/price/NVDA` --- ### `fetch-us-stock-price-crcl` **CRCL Stock Price** — Returns the current US equity price for CRCL (Circle Internet Group) sourced from Pyth, including price, confidence interval, and publish timestamp. *Use when:* Use when an agent needs the latest market price for CRCL stock, including confidence score and feed metadata, to display, compare, or act on equity pricing data. *Not for:* Do not use for historical price data or other ticker symbols; this endpoint is fixed to CRCL only. **Returns:** Returns a JSON object with CRCL's current USD price (114.00), a Pyth confidence interval, publish timestamp, asset type, and feed ID. **Example:** `GET https://blockrun-web-vbsbhh7lea-uc.a.run.app/api/v1/stocks/us/price/CRCL` --- ### `fetch-us-stock-price-gld` **GLD Price Quote** — Returns the latest US equity price for GLD (SPDR Gold Shares) including price, confidence interval, publish time, and data source from Pyth. *Use when:* Use when an agent needs the current market price of GLD (SPDR Gold Shares ETF) as a US equity, along with metadata such as confidence, timestamp, and feed source. *Not for:* Do not use for historical price series or other ticker symbols; this endpoint is fixed to GLD only. **Returns:** Returns a JSON object with GLD's current USD price (~417.37), confidence interval, Unix and ISO publish timestamps, asset type (equity), Pyth feed ID, and source. **Example:** `GET https://blockrun-web-vbsbhh7lea-uc.a.run.app/api/v1/stocks/us/price/GLD` --- ### `fetch-slv-us-stock-price` **SLV Price Lookup** — Returns the latest US equity price for SLV (iShares Silver Trust) sourced from Pyth, including price, confidence, publish time, and feed metadata. *Use when:* Use when an agent needs the current or most recently published price of SLV (iShares Silver Trust) as a US equity feed, including confidence interval and Pyth feed ID. *Not for:* Do not use for other tickers or non-US equity symbols; use the corresponding ticker-specific endpoint instead. Not suitable for streaming or real-time price subscriptions — this is a single-shot lookup. **Returns:** Returns a JSON object with symbol, category, price, confidence, publishTime, ISO timestamp, assetType, Pyth feedId, and source for SLV. **Example:** `GET https://blockrun-web-vbsbhh7lea-uc.a.run.app/api/v1/stocks/us/price/SLV` --- ### `fetch-iwm-us-price` **IWM US Price Feed** — Returns the latest real-time US equity price for IWM (iShares Russell 2000 ETF) sourced from Pyth, including confidence interval and publish timestamp. *Use when:* Use when an agent needs the current market price of IWM (iShares Russell 2000 ETF) along with price confidence, asset type, and feed metadata for display, calculation, or decision-making purposes. *Not for:* Do not use for historical price data or price series; this returns only the latest single price snapshot. Not suitable for non-US equities or other asset classes. **Returns:** Returns a JSON object with IWM's latest USD price (282.595), confidence interval, Unix and ISO publish timestamps, asset type (equity), Pyth feed ID, and source. **Example:** `GET https://blockrun-web-vbsbhh7lea-uc.a.run.app/api/v1/stocks/us/price/IWM` --- ### `fetch-us-stock-price-dia` **DIA Stock Price** — Returns the latest US equity price for DIA (SPDR Dow Jones Industrial Average ETF) including confidence score, publish time, and data source. *Use when:* Use when an agent needs the current market price of DIA along with metadata such as confidence, timestamp, feed ID, and source for downstream financial calculations or display. *Not for:* Do not use for historical price series or other ticker symbols; this endpoint is specific to DIA only. **Returns:** Returns a JSON object with DIA's latest USD price, confidence interval, publish timestamp, asset type, Pyth feed ID, and source. **Example:** `GET https://blockrun-web-vbsbhh7lea-uc.a.run.app/api/v1/stocks/us/price/DIA` --- ### `fetch-qqq-us-stock-price` **QQQ US Stock Price** — Returns the latest real-time US equity price for QQQ (Invesco QQQ Trust) including price, confidence interval, publish time, and data source. *Use when:* Use when an agent needs the current market price of QQQ (Invesco QQQ Trust ETF) for display, trading decisions, portfolio valuation, or price-triggered logic. *Not for:* Do not use for historical price data or other ticker symbols; this endpoint is fixed to QQQ only. **Returns:** Returns a JSON object with QQQ's latest price (e.g. 673.62), confidence interval, Unix and ISO publish timestamps, asset type, Pyth feed ID, and source. **Example:** `GET https://blockrun-web-vbsbhh7lea-uc.a.run.app/api/v1/stocks/us/price/QQQ` --- ### `fetch-us-stock-price-xle` **XLE Stock Price** — Returns the current US equity price for XLE (Energy Select Sector SPDR Fund) sourced from Pyth, including price, confidence interval, and publish timestamp. *Use when:* Use when an agent needs the current market price of XLE (Energy Select Sector SPDR ETF) along with its confidence interval and last-updated timestamp for trading decisions, portfolio valuation, or price monitoring. *Not for:* Do not use for historical price data or price series; this returns only the latest single-point price. Not suitable for non-US equities or other tickers — this endpoint is fixed to XLE. **Returns:** Returns a JSON object with XLE's current USD price, Pyth confidence interval, publish Unix timestamp, ISO timestamp, asset type, Pyth feed ID, and source label. **Example:** `GET https://blockrun-web-vbsbhh7lea-uc.a.run.app/api/v1/stocks/us/price/XLE` --- ### `fetch-us-stock-price-spy` **SPY Price Lookup** — Returns the latest SPY US equity price with confidence score, publish time, and Pyth feed metadata via a single GET request. *Use when:* Use when an agent needs the current market price of the SPY ETF (S&P 500 tracker) along with a confidence interval and data source attribution from Pyth Network. *Not for:* Do not use for historical price series or other ticker symbols; this endpoint is hardcoded to SPY only. **Returns:** Returns a JSON object with SPY's latest USD price, confidence interval, publish timestamp, asset type, Pyth feed ID, and source label. **Example:** `GET https://blockrun-web-vbsbhh7lea-uc.a.run.app/api/v1/stocks/us/price/SPY` --- ### `fetch-uso-stock-price` **USO Price Feed** — Returns the latest USO (United States Oil Fund) stock price with confidence score, publish time, and source metadata from Pyth Network. *Use when:* Use when an agent needs the current market price of USO equity, including timestamp and data source provenance, for display, calculation, or decision-making purposes. *Not for:* Do not use for historical price series or other US equities; use a dedicated historical or multi-symbol endpoint instead. **Returns:** Returns a JSON object with USO's current price (e.g. 133.49 USD), confidence interval, Unix and ISO publish timestamps, asset type, Pyth feed ID, and source. **Example:** `GET https://blockrun-web-vbsbhh7lea-uc.a.run.app/api/v1/stocks/us/price/USO` --- ### `fetch-vxus-stock-price` **VXUS Price Check** — Returns the latest U.S. equity price for VXUS (Vanguard Total International Stock ETF) sourced from Pyth, including price, confidence interval, and publish timestamp. *Use when:* Use when an agent needs the current market price of VXUS (Vanguard Total International Stock ETF) along with its confidence value, feed ID, and last publish time for trading or portfolio valuation purposes. *Not for:* Do not use for historical price data or price series; this endpoint returns only the latest single price snapshot. Not suitable for non-US equities or other asset classes. **Returns:** Returns a JSON object with symbol, category, numeric price in USD, confidence interval, Unix and ISO publish timestamps, asset type, Pyth feed ID, and source name. **Example:** `GET https://blockrun-web-vbsbhh7lea-uc.a.run.app/api/v1/stocks/us/price/VXUS` --- ### `fetch-us-stock-price-bnd` **BND Price Feed** — Returns the latest US equity price for BND (Vanguard Total Bond Market ETF) including confidence interval, publish time, and Pyth feed metadata. *Use when:* Use when an agent needs the current market price of BND (Vanguard Total Bond Market ETF) along with price confidence, asset type, and feed source details for display, calculation, or decision-making. *Not for:* Do not use for historical price data or price series; this returns only the latest single price snapshot. Not suitable for non-US equities or other asset classes. **Returns:** Returns a JSON object with BND's latest price (~$73.52), confidence interval, Unix and ISO publish timestamps, asset type (equity), Pyth feedId, and source. **Example:** `GET https://blockrun-web-vbsbhh7lea-uc.a.run.app/api/v1/stocks/us/price/BND` --- ### `fetch-us-stock-price-bsv` **BSV Stock Price** — Returns the latest US equity price for BSV (ticker symbol) including price, confidence score, publish time, and data source metadata. *Use when:* Use when an agent needs the current market price of the BSV US stock, along with metadata such as confidence level, feed ID, and timestamp of the last price update. *Not for:* Do not use for historical price data or price series; this returns only the latest single price snapshot. Not suitable for non-US equities or crypto assets with the same ticker. **Returns:** Returns a JSON object with BSV's latest USD price (78.17), confidence score, Unix and ISO publish timestamps, asset type, Pyth feed ID, and source name. **Example:** `GET https://blockrun-web-vbsbhh7lea-uc.a.run.app/api/v1/stocks/us/price/BSV` --- ### `fetch-us-stock-price-voo` **VOO Stock Price** — Returns the latest US equity price for VOO (Vanguard S&P 500 ETF) including price, confidence score, publish time, and data source. *Use when:* Use when an agent needs the current market price of VOO along with metadata such as confidence level, feed ID, and timestamp for display, calculation, or decision-making purposes. *Not for:* Do not use for historical price data or other ticker symbols; this endpoint is fixed to VOO only. **Returns:** Returns a JSON object with VOO's latest price in USD, a confidence score, Unix and ISO publish timestamps, asset type, Pyth feed ID, and source name. **Example:** `GET https://blockrun-web-vbsbhh7lea-uc.a.run.app/api/v1/stocks/us/price/VOO` --- ### `fetch-us-stock-spot-price` **US Stock Spot Price** — Returns the current spot price for a US-listed stock symbol sourced from Pyth Network, including price, confidence interval, and publish timestamp. *Use when:* Use when an agent needs the latest real-time spot price for a US equity ticker (e.g. AAPL, TSLA) from Pyth Network, including confidence and feed metadata. *Not for:* Do not use for non-US stock markets (use the equivalent HK, TSE, KRX, LSE, XETRA, or Euronext endpoint instead). Not suitable for historical price lookups or streaming price feeds. **Inputs:** - `symbol` (string, required) — US stock ticker symbol as a path parameter. Must match a valid symbol from /list (e.g. AAPL, TSLA). - `session` (string) — Trading session hint. Accepted values: 'regular' or 'extended'. **Returns:** Returns a JSON object with the stock symbol, USD spot price, Pyth confidence interval, publish timestamp, asset type, feed ID, and source. **Example:** `GET https://blockrun-web-vbsbhh7lea-uc.a.run.app/api/v1/stocks/us/price/AAPL?session=regular` ---