# Yahoofinance — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 live stock quotes, historical price data, company profiles, and financial news for any ticker symbol. Supports real-time market data, OHLCV history across configurable intervals, detailed company fundamentals, and news aggregation across global exchanges.

**Category:** Finance & Markets | **Website:** [yahoofinance.com/](https://yahoofinance.com/) | **Docs:** [parse.bot/marketplace/417d966a-b180-44b0-80e5-477772dfc4e2/yahoofinance-com-api](https://parse.bot/marketplace/417d966a-b180-44b0-80e5-477772dfc4e2/yahoofinance-com-api)

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

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/parse-yahoofinance-com-api-417d966a/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### Get company profile

Obtain a detailed company profile including business summary, key executives, sector, industry, and financial metrics such as revenue, profit margins, and analyst recommendations. Returns structured modules: assetProfile, summaryDetail, defaultKeyStatistics, and financialData.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | Stock ticker symbol (e.g., AAPL). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-yahoofinance-com-api-417d966a/get_company_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"symbol":"<string>"}'
```

### Get historical data

Extract historical OHLCV price data for a single ticker over a configurable date range and interval. Returns timestamped records suitable for charting and technical analysis. Intraday intervals (1m-90m) require shorter ranges (1d-5d); daily and above work with any range.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `interval` | string | No | Data interval granularity. |
| `range` | string | No | Date range for historical data. |
| `symbol` | string | Yes | Stock ticker symbol (e.g., AAPL). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-yahoofinance-com-api-417d966a/get_historical_data \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"interval":"<string>","range":"<string>","symbol":"<string>"}'
```

### Get quote

Retrieve real-time stock quotes including current price, bid/ask, volume, market cap, and market status for one or more tickers. Supports batch lookups via comma-separated symbols. Each quote carries the full market snapshot visible on the Yahoo Finance quote page.

**Estimated cost:** Metered

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

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-yahoofinance-com-api-417d966a/get_quote \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"symbols":"<string>"}'
```

### Get stock news

Gather the latest financial news articles related to a specified stock ticker. Returns headlines, publishers, links, publish timestamps, and related tickers for each article.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `count` | integer | No | Number of news items to retrieve. |
| `symbol` | string | Yes | Stock ticker symbol (e.g., AAPL). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-yahoofinance-com-api-417d966a/get_stock_news \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"count":"<integer>","symbol":"<string>"}'
```

### Search tickers

Search for stock tickers and companies by name or keyword. Returns matching equities, ETFs, and other instruments across global exchanges with symbol, name, exchange, quote type, sector, and industry.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search query string (e.g., Apple, Tesla, MSFT). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-yahoofinance-com-api-417d966a/search_tickers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```