# Ca Finance Yahoo — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access real-time financial data from Yahoo Finance, including cryptocurrency prices, stock quotes, and screened lists of stocks meeting custom criteria such as all-time highs, volume thresholds, and price filters.

**Category:** Finance & Markets | **Website:** [ca.finance.yahoo.com/](https://ca.finance.yahoo.com/) | **Docs:** [parse.bot/marketplace/164807ce-e304-4cdc-ad92-4627a9a76873/ca-finance-yahoo-com-api](https://parse.bot/marketplace/164807ce-e304-4cdc-ad92-4627a9a76873/ca-finance-yahoo-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-ca-finance-yahoo-com-api-164807ce/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_all_time_high_stocks

Returns a list of stocks currently trading near all-time highs from Yahoo Finance's predefined screener, filtered to volume > 1M and price > $60. Each stock includes ticker, name, current price, volume, 52-week range, and market cap. The screener returns up to 100 candidates before filtering.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ca-finance-yahoo-com-api-164807ce/get_all_time_high_stocks \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_bitcoin_price

Extract the current price of Bitcoin (BTC-USD) from Yahoo Finance. Returns real-time price, change amount, and percentage change. A single-resource fetch that returns one quote for BTC-USD without any input parameters.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ca-finance-yahoo-com-api-164807ce/get_bitcoin_price \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_stock_quote

Get detailed quote data for one or more stock symbols. Returns current price, change, volume, and market cap for each requested symbol. Accepts a comma-separated list of ticker symbols. Invalid symbols are silently omitted from the response.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbols` | string | Yes | Comma-separated list of stock ticker symbols (e.g. AAPL,MSFT,GOOG). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ca-finance-yahoo-com-api-164807ce/get_stock_quote \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"symbols":"<string>"}'
```