> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Yahoo Finance Quotes API

> Price history from Yahoo Finance with open, high, low, close and volume over the range and interval you choose. Pass Yahoo tickers or index names, US or global (AAPL, RELIANCE.NS, NIFTY, SENSEX).

`POST /v1/data/yahoo-finance/quotes/run`

**Pricing:** $0.002 per quote ($2.00 per 1,000).

## Request

Send the inputs under `params`. Only the keys below are accepted; any other key returns `422 invalid_params`.

**tickers** `string[]` *required*

One or more Yahoo Finance tickers. US listings as AAPL or BRK-B; other markets need the exchange suffix (RELIANCE.NS or 500325.BO for India, VOD.L, 7203.T); NSE:RELIANCE also works. Indices as ^ symbols (^NSEI, ^BSESN, ^GSPC) or by name: NIFTY, BANKNIFTY, SENSEX, SP500, NASDAQ100, FTSE100. An unknown ticker is reported as an error. One request reads them all.

**range** `string` (default: 1mo)

Range to use. 1 month by default.

Allowed values: `1d` (1 day), `5d` (5 days), `1mo` (1 month), `3mo` (3 months), `6mo` (6 months), `ytd` (Year to date), `1y` (1 year), `2y` (2 years), `5y` (5 years), `10y` (10 years), `max` (All history).

**interval** `string` (default: 1d)

Interval to use. 1 day by default.

Allowed values: `1m` (1 minute), `2m` (2 minutes), `5m` (5 minutes), `15m` (15 minutes), `30m` (30 minutes), `60m` (60 minutes), `90m` (90 minutes), `1h` (1 hour), `1d` (1 day), `5d` (5 days), `1wk` (1 week), `1mo` (1 month), `3mo` (3 months).

**maxResults** `integer` (default: 100)

How many quotes to return in total. Defaults to 100; use 0 for all.

## Example

```bash cURL theme={null}
curl -X POST "https://api.mindcase.co/v1/data/yahoo-finance/quotes/run?wait=true" \
  -H "Authorization: Bearer $MINDCASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "tickers": [
      "AAPL",
      "MSFT",
      "BRK-B"
    ],
    "range": "5d",
    "interval": "1d"
  }
}'
```

```python Python theme={null}
import os, requests

r = requests.post(
    "https://api.mindcase.co/v1/data/yahoo-finance/quotes/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {
    "tickers": [
        "AAPL",
        "MSFT",
        "BRK-B"
    ],
    "range": "5d",
    "interval": "1d"
}},
)
job = r.json()
rows = job.get("data", [])  # if job["status"] == "running", poll /v1/jobs/{job_id}/results
```

```javascript Node.js theme={null}
const r = await fetch("https://api.mindcase.co/v1/data/yahoo-finance/quotes/run?wait=true", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ params: {
  "tickers": [
    "AAPL",
    "MSFT",
    "BRK-B"
  ],
  "range": "5d",
  "interval": "1d"
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
```

## Response fields

Each row in `data` is one quote, keyed by these fields.

| Field | Name | Type |
| - | - | - |
| `symbol` | Symbol | text |
| `date` | Date | date |
| `name` | Name | text |
| `exchange` | Exchange | text |
| `currency` | Currency | text |
| `open` | Open | number |
| `high` | High | number |
| `low` | Low | number |
| `close` | Close | number |
| `adjClose` | Adj Close | number |
| `volume` | Volume | number |

## Example response

Abridged: long text and lists are shortened.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "yahoo-finance/quotes",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "low": 341.03,
      "exchange": "NasdaqGS",
      "name": "Apple Inc.",
      "adjClose": 343.91,
      "close": 343.91,
      "open": 343.92,
      "high": 347.09,
      "volume": 42743600,
      "date": "2026-10-26",
      "symbol": "AAPL",
      "currency": "USD"
    }
  ]
}
```

## Related APIs

For the current price only use [`yahoo-finance/prices`](https://docs.mindcase.co/apis/yahoo-finance/prices).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.