ca.finance.yahoo.com APIca.finance.yahoo.com ↗
Get real-time Bitcoin prices, all-time high stock screener results, and detailed multi-symbol quote data from Yahoo Finance via a clean REST API.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/ea5d3c8b-294d-4c28-a670-c58efe208822/get_bitcoin_price' \ -H 'X-API-Key: $PARSE_API_KEY'
Extract the current price of Bitcoin (BTC-USD) from Yahoo Finance. Returns real-time price, change amount, and percentage change.
No input parameters required.
{
"type": "object",
"fields": {
"name": "string, asset name",
"change": "number, price change amount",
"symbol": "string, trading symbol (BTC-USD)",
"currency": "string, currency code (USD)",
"market_time": "integer, Unix timestamp of last market update",
"current_price": "number, current BTC price in USD",
"change_percent": "number, percentage change"
},
"sample": {
"data": {
"name": "Bitcoin USD",
"change": -1552.65,
"symbol": "BTC-USD",
"currency": "USD",
"market_time": 1778745909,
"current_price": 79611.28,
"change_percent": -1.913
},
"status": "success"
}
}About the ca.finance.yahoo.com API
This API exposes 3 endpoints against Yahoo Finance Canada, returning live market data across equities and crypto. The get_bitcoin_price endpoint delivers BTC-USD spot price, change amount, and percentage change in a single call. The get_all_time_high_stocks endpoint surfaces screener results for equities currently trading at historical highs, and get_stock_quote accepts a comma-separated list of ticker symbols and returns up to 10 fields per quote including market cap and volume.
Bitcoin Price Endpoint
The get_bitcoin_price endpoint returns a snapshot of BTC-USD at the time of the request. The response includes current_price (number, USD), change (the raw price movement), change_percent, currency, symbol (BTC-USD), and market_time as a Unix timestamp. There are no input parameters — the endpoint is fixed to BTC-USD.
All-Time High Stock Screener
The get_all_time_high_stocks endpoint wraps Yahoo Finance's built-in all-time-high screener. The response contains a stocks array where each object carries ticker, name, current_price, volume, all_time_high_value, fifty_two_week_high, and fifty_two_week_low. Two counts are returned: total_in_screener reflects the raw screener pool before filters, while count reflects the number of stocks that passed volume and price filters. No input parameters are required, though screener filters can be adjusted via screener configuration at the API level.
Multi-Symbol Stock Quote
The get_stock_quote endpoint accepts a symbols string — a comma-separated list of ticker symbols such as AAPL,MSFT,GOOG — and returns a quotes array. Each quote object includes symbol, longName, shortName, regularMarketPrice, regularMarketChange, regularMarketChangePercent, currency, and additional market fields. This endpoint is suitable for monitoring a watchlist or populating a dashboard without needing one call per ticker.
- Display a live BTC-USD price widget using
current_price,change, andchange_percentfromget_bitcoin_price. - Screen for equities at all-time highs and rank by volume using the
stocksarray fromget_all_time_high_stocks. - Populate a multi-stock portfolio dashboard by passing a watchlist to
get_stock_quoteas a comma-separatedsymbolsparameter. - Compare
fifty_two_week_highvsall_time_high_valueacross screener results to identify recent breakout candidates. - Track intraday price movement on a basket of tech stocks using
regularMarketChangeandregularMarketChangePercentfromget_stock_quote. - Trigger alerts when a stock in
get_all_time_high_stockscrosses a volume threshold using thevolumefield. - Log Bitcoin
market_timetimestamps alongsidecurrent_priceto build a lightweight BTC price history dataset.
| 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 | 250 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_all_time_high_stocks` return, and how is `count` different from `total_in_screener`?+
total_in_screener is the raw number of equities Yahoo Finance's all-time-high screener identifies before any additional filtering. count reflects the subset that passes the volume and price filters applied by this endpoint's configuration. The stocks array contains only the filtered set, each with fields including all_time_high_value, fifty_two_week_high, fifty_two_week_low, volume, current_price, ticker, and name.Does `get_stock_quote` support equity types other than US-listed common stocks — for example, ETFs, ADRs, or Canadian TSX-listed tickers?+
symbols parameter, so ETFs and ADRs that have Yahoo Finance listings should resolve. However, the API was designed and tested around standard US equity symbols. Coverage of TSX-listed or other exchange-specific tickers may be inconsistent. You can fork this API on Parse and revise it to add explicit handling or validation for non-US symbols.Is historical OHLCV or earnings data available through this API?+
How fresh is the data from `get_bitcoin_price`?+
market_time field in the response is a Unix timestamp indicating when Yahoo Finance last recorded the price update. BTC-USD trades continuously, so data freshness depends on when the request is made relative to Yahoo Finance's own feed latency. The endpoint does not cache results across calls; each request retrieves the current value at call time.