# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/yahoofinance/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/yahoofinance/get-company-profile \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/yahoofinance/get-historical-data \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/yahoofinance/get-quote \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/yahoofinance/get-stock-news \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/yahoofinance/search-tickers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.