scrollport
Back to Yahoo Finance market data

Yahoo Finance Market Data

Yahoo Finance

Retrieve public Yahoo Finance quotes and bounded historical bars for one or more symbols.

Capability
Yahoo Finance market data
Current price
$0.0049/result
Availability
Ready to run
Last accepted verification

What this API does

Read-only public market research with explicit range, interval and retrieval timestamps. This route does not provide financial advice.

Agents select this operation with tool ID yahoo-finance.market-data, then inspect its current executable contract before a run.

Public input and output shape

Input

inputobject · required

Provider-specific public source, URL or search criteria.

maxItemsinteger · optional

Maximum number of records to return.

minimum: 1 · maximum: 5

Output

bar_countnumber

Returned bar count value.

historical_barsarray

Returned historical bars value.

history_availableboolean

Returned history available value.

quote_countnumber

Returned quote count value.

quotesarray

Returned quotes value.

retrieved_atstring

Returned retrieved at value.

sourcestring

Returned source value.

Example request and output

This reviewed worked example is shared with inspect. Inspect also returns the current executable schema and price estimate before a paid run.

Request

{
  "tool_id": "yahoo-finance.market-data",
  "input": {
    "input": {
      "range": "5d",
      "symbols": [
        "AAPL"
      ],
      "interval": "1d",
      "includeHistory": true
    },
    "maxItems": 1
  }
}

Output

{
  "quotes": [
    {
      "name": "Apple Inc.",
      "price": 316.83,
      "range": "5d",
      "change": 14.58,
      "source": "yahoo_finance",
      "symbol": "AAPL",
      "volume": 50009121,
      "day_low": 309.6,
      "currency": "USD",
      "day_high": 319.28,
      "exchange": "NasdaqGS",
      "interval": "1d",
      "source_url": "https://finance.yahoo.com/quote/AAPL",
      "record_type": "quote",
      "retrieved_at": "2026-08-20T12:10:12.000Z",
      "change_percent": "+4.82%",
      "previous_close": 302.25,
      "instrument_type": "EQUITY",
      "source_updated_at": null,
      "supplier_retrieved_at": "2026-08-20T12:10:11.617Z"
    }
  ],
  "source": "yahoo_finance",
  "bar_count": 5,
  "quote_count": 1,
  "retrieved_at": "2026-08-20T12:10:12.000Z",
  "historical_bars": [
    {
      "low": 302.05,
      "high": 306,
      "open": 304.21,
      "close": 305.26,
      "range": "5d",
      "source": "yahoo_finance",
      "symbol": "AAPL",
      "volume": 40349300,
      "interval": "1d",
      "timestamp": "2026-08-13",
      "record_type": "historical_bar",
      "retrieved_at": "2026-08-20T12:10:12.000Z",
      "adjusted_close": 305.26
    },
    {
      "low": 304.3,
      "high": 307.49,
      "open": 306,
      "close": 305.93,
      "range": "5d",
      "source": "yahoo_finance",
      "symbol": "AAPL",
      "volume": 28229400,
      "interval": "1d",
      "timestamp": "2026-08-14",
      "record_type": "historical_bar",
      "retrieved_at": "2026-08-20T12:10:12.000Z",
      "adjusted_close": 305.93
    },
    {
      "low": 302.94,
      "high": 307.66,
      "open": 306.21,
      "close": 305.59,
      "range": "5d",
      "source": "yahoo_finance",
      "symbol": "AAPL",
      "volume": 38169300,
      "interval": "1d",
      "timestamp": "2026-08-17",
      "record_type": "historical_bar",
      "retrieved_at": "2026-08-20T12:10:12.000Z",
      "adjusted_close": 305.59
    },
    {
      "low": 305.74,
      "high": 311.49,
      "open": 307.58,
      "close": 310.03,
      "range": "5d",
      "source": "yahoo_finance",
      "symbol": "AAPL",
      "volume": 53424500,
      "interval": "1d",
      "timestamp": "2026-08-18",
      "record_type": "historical_bar",
      "retrieved_at": "2026-08-20T12:10:12.000Z",
      "adjusted_close": 310.03
    },
    {
      "low": 309.6,
      "high": 319.28,
      "open": 310.14,
      "close": 316.83,
      "range": "5d",
      "source": "yahoo_finance",
      "symbol": "AAPL",
      "volume": 50428000,
      "interval": "1d",
      "timestamp": "2026-08-19",
      "record_type": "historical_bar",
      "retrieved_at": "2026-08-20T12:10:12.000Z",
      "adjusted_close": 316.83
    }
  ],
  "history_available": true
}
Teaching errors and limitations

No listing-specific teaching errors are published. Inspect the tool before running to receive the current schema and error guidance.

Updated
21 August 2026

Use Yahoo Finance Market Data with Scrollport

Use Scrollport

Scrollport identifies and validates the best-in-class API tools and provides them on a pay-as-you-go basis so you don't need to maintain a separate provider account, subscription or credits.

Give your agent the setup prompt to receive $1 in trial credit and start using the tools right away.