> ## 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 Prices API

> Current prices from Yahoo Finance with quote type, exchange, currency, price and change. Pass Yahoo tickers or index names, US or global (AAPL, RELIANCE.NS, NIFTY, SENSEX).

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

**Pricing:** $0.001 per price ($1.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.

## Example

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

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

r = requests.post(
    "https://api.mindcase.co/v1/data/yahoo-finance/prices/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {
    "tickers": [
        "AAPL",
        "MSFT",
        "BRK-B"
    ]
}},
)
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/prices/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"
  ]
} }),
});
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 price, keyed by these fields.

| Field | Name | Type |
| - | - | - |
| `symbol` | Symbol | text |
| `name` | Name | text |
| `quoteType` | Quote Type | text |
| `exchange` | Exchange | text |
| `currency` | Currency | text |
| `price` | Price | number |
| `change` | Change | number |
| `changePercent` | Change Percent | percentage |
| `previousClose` | Previous Close | number |
| `open` | Open | number |
| `dayHigh` | Day High | number |
| `dayLow` | Day Low | number |
| `volume` | Volume | number |
| `marketCap` | Market Cap | number |
| `averageVolume3Month` | Average Volume 3 Month | number |
| `fiftyTwoWeekHigh` | Fifty Two Week High | number |
| `fiftyTwoWeekLow` | Fifty Two Week Low | number |
| `trailingPE` | Trailing Pe | number |
| `dividendYield` | Dividend Yield | percentage |
| `marketState` | Market State | text |
| `priceTime` | Price Time | datetime |
| `quoteDelayMinutes` | Quote Delay Minutes | number |
| `exchangeTimezone` | Exchange Timezone | text |

## Example response

Abridged: long text and lists are shortened.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "yahoo-finance/prices",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "averageVolume3Month": 41866653,
      "trailingPE": 39.52179,
      "quoteType": "EQUITY",
      "dividendYield": 0.31,
      "exchange": "NasdaqGS",
      "name": "Apple Inc.",
      "marketCap": 5029592301568,
      "dayLow": 342.35,
      "change": -4.28,
      "marketState": "CLOSED",
      "fiftyTwoWeekHigh": 351.73,
      "quoteDelayMinutes": 15,
      "previousClose": 348.91,
      "fiftyTwoWeekLow": 243.42,
      "dayHigh": 349.19,
      "open": 346.685,
      "exchangeTimezone": "America/New_York",
      "changePercent": -1.22668,
      "volume": 67842804,
      "symbol": "AAPL",
      "currency": "USD",
      "priceTime": "2026-10-30T20:00:01Z",
      "price": 344.63
    }
  ]
}
```

## Related APIs

For price history over a range use [`yahoo-finance/quotes`](https://docs.mindcase.co/apis/yahoo-finance/quotes); for funds and ETFs with fund type use [`yahoo-finance/index-funds`](https://docs.mindcase.co/apis/yahoo-finance/index-funds); for valuation and technical metrics use [`finviz/metrics`](https://docs.mindcase.co/apis/finviz/metrics).


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