Yahoo APIau.finance.yahoo.com ↗
Access real-time stock quotes, historical daily prices, and most-active stock lists from Yahoo Finance Australia via a clean JSON API.
What is the Yahoo API?
This API exposes 3 endpoints that pull stock market data from Yahoo Finance Australia, covering real-time quotes, one-month daily price history, and ranked lists of the most active stocks by region. The get_stock_quote endpoint returns 10 fields per ticker — including price, change, volume, day range, and currency — for any valid symbol such as CBA.AX or NVDA. The get_most_active_stocks endpoint supports both AU and US market regions.
curl -X GET 'https://api.parse.bot/scraper/44a39ce6-33d3-4167-b50a-c723a9cb0cef/get_most_active_stocks?count=5®ion=AU' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace au-finance-yahoo-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Yahoo Finance Australia — monitor active stocks, get quotes, check history."""
from parse_apis.yahoo_finance_australia_api import YahooFinance, Region, SymbolNotFound
client = YahooFinance()
# List the most active Australian stocks, capped at 5
for stock in client.stocks.list(region=Region.AU, count=5, limit=5):
print(stock.symbol, stock.name, stock.price, stock.change_percent)
# Get a detailed quote for one stock
quote = client.quotes.get(symbol="CBA.AX")
print(quote.name, quote.price, quote.currency, quote.market_cap)
# Drill into its price history (last month of daily closes)
history = quote.history()
for point in history.history[:3]:
print(point.date, point.close)
# Handle a bad symbol gracefully
try:
client.quotes.get(symbol="INVALID_XYZ_999")
except SymbolNotFound as exc:
print(f"Symbol not found: {exc.symbol}")
print("exercised: stocks.list / quotes.get / quote.history / SymbolNotFound")
Get a list of most active stocks in a specified region. Returns stock symbols, names, prices, and percentage changes. The region parameter selects the market (AU for Australia, US for United States). Results are ordered by trading volume descending.
| Param | Type | Description |
|---|---|---|
| count | integer | Number of stocks to return. |
| region | string | Market region code. Accepted values: AU (Australia), US (United States). |
{
"type": "object",
"fields": {
"count": "integer, number of stocks returned",
"region": "string, the region code used",
"stocks": "array of stock objects with symbol, name, price, change_percent, date"
},
"sample": {
"data": {
"count": 5,
"region": "US",
"stocks": [
{
"date": "2026-06-10 20:00:00",
"name": "Super Micro Computer, Inc.",
"price": 29.27,
"symbol": "SMCI",
"change_percent": -27.9774
},
{
"date": "2026-06-10 20:00:00",
"name": "NVIDIA Corporation",
"price": 200.42,
"symbol": "NVDA",
"change_percent": -3.73217
}
]
},
"status": "success"
}
}About the Yahoo API
Endpoints and What They Return
The get_stock_quote endpoint accepts a single symbol parameter and returns the current market snapshot for that ticker: price, open, change, day_low, day_high, volume, currency, name, and the last-trade timestamp in UTC. It works with both ASX-listed symbols (e.g. CBA.AX, BHP.AX) and US-listed symbols (e.g. TSLA, NVDA).
The get_historical_data endpoint accepts a symbol and returns an array of objects, each containing a date (YYYY-MM-DD) and close price, covering approximately the last calendar month of trading days. This is daily close-only data — intraday OHLCV is not included.
Market Activity Coverage
The get_most_active_stocks endpoint accepts optional count and region parameters. Verified working region codes are AU and US. Each stock object in the response includes symbol, name, price, change_percent, and date. This endpoint is useful for surfacing high-volume movers without knowing specific tickers in advance.
Scope and Limitations
All three endpoints return data as it appears on Yahoo Finance Australia. Historical data covers roughly one month and is limited to daily closing prices. The API does not expose financial statements, dividend history, analyst ratings, options chains, or real-time intraday tick data. Symbol coverage follows what Yahoo Finance AU indexes, so tickers from smaller or unlisted markets may not resolve.
The Yahoo API is a managed, monitored endpoint for au.finance.yahoo.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when au.finance.yahoo.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official au.finance.yahoo.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track daily closing prices for ASX-listed stocks over the past month using
get_historical_data - Display real-time bid/ask snapshots for a watchlist of tickers using
get_stock_quote - Surface the most active US or Australian stocks by volume using
get_most_active_stockswith theregionparameter - Monitor intraday high/low ranges via
day_highandday_lowfields from the quote endpoint - Build a currency-aware portfolio tracker using the
currencyandpricefields across multi-region symbols - Identify high-activity tickers programmatically for further research without manual screener queries
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Yahoo Finance have an official developer API?+
What does get_stock_quote return beyond the current price?+
price, the endpoint returns open, change (absolute price change from previous close), day_low, day_high, volume, currency, name, and a UTC timestamp for the last trade. It does not include market_cap or 52_week_range despite those fields being mentioned in the endpoint description — actual response shape is limited to the fields listed in the returns spec above.How much historical data does get_historical_data cover?+
date and close. Longer time ranges and intraday OHLCV data are not currently covered. You can fork this API on Parse and revise it to add a date-range parameter or extended history endpoint.Can I retrieve earnings, dividends, or analyst ratings through this API?+
Which region codes work with get_most_active_stocks?+
region parameter are AU (ASX-listed stocks) and US (US-listed stocks). Other region codes may not return results. The count parameter is optional and controls how many stocks appear in the response array.