> ## 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 Index Funds API

> Index funds, ETFs and market indices from Yahoo Finance with fund type, exchange, currency and price. Pass tickers or index names (SPY, NIFTYBEES.NS, NIFTY, SENSEX).

`POST /v1/data/yahoo-finance/index-funds/run`

**Pricing:** $0.001 per fund ($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: ETFs and funds (SPY, VFIAX, NIFTYBEES.NS) or indices as ^ symbols (^NSEI, ^BSESN, ^GSPC). Common index names are mapped for you: 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/index-funds/run?wait=true" \
  -H "Authorization: Bearer $MINDCASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "tickers": [
      "SPY",
      "VOO",
      "QQQ"
    ]
  }
}'
```

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

r = requests.post(
    "https://api.mindcase.co/v1/data/yahoo-finance/index-funds/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {
    "tickers": [
        "SPY",
        "VOO",
        "QQQ"
    ]
}},
)
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/index-funds/run?wait=true", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ params: {
  "tickers": [
    "SPY",
    "VOO",
    "QQQ"
  ]
} }),
});
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 fund, keyed by these fields.

| Field | Name | Type |
| - | - | - |
| `symbol` | Symbol | text |
| `name` | Name | text |
| `fundType` | Fund Type | text |
| `exchange` | Exchange | text |
| `currency` | Currency | text |
| `price` | Price | number |
| `priceTime` | Price Time | datetime |
| `previousClose` | Previous Close | number |
| `changePercent` | Change Percent | number |
| `fiftyTwoWeekLow` | Fifty Two Week Low | number |
| `fiftyTwoWeekHigh` | Fifty Two Week High | number |
| `expenseRatioPct` | Expense Ratio Pct | number |
| `netAssets` | Net Assets | number |
| `dividendYieldPct` | Dividend Yield Pct | number |
| `ytdReturnPct` | Ytd Return Pct | number |
| `fundFamily` | Fund Family | text |
| `category` | Category | text |
| `legalType` | Legal Type | text |
| `holdingsTurnover` | Holdings Turnover | number |
| `beta3Year` | Beta 3 Year | number |
| `firstTradeDate` | First Trade Date | date |
| `description` | Description | text |
| `portfolio` | Portfolio | object |
| `performance` | Performance | object |

## Example response

Abridged: long text and lists are shortened.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "yahoo-finance/index-funds",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "portfolio": {
        "cashPosition": 0.00059999997,
        "stockPosition": 0.9994,
        "bondPosition": 0,
        "otherPosition": 0,
        "preferredPosition": 0,
        "convertiblePosition": 0,
        "holdings": [
          {
            "symbol": "AAPL",
            "holdingName": "Apple Inc",
            "holdingPercent": 0.0770069
          },
          {
            "symbol": "NVDA",
            "holdingName": "NVIDIA Corp",
            "holdingPercent": 0.0758232
          },
          {
            "symbol": "MSFT",
            "holdingName": "Microsoft Corp",
            "holdingPercent": 0.0593322
          }
        ],
        "equityHoldings": {
          "priceToEarnings": 0.0416,
          "priceToBook": 0.197,
          "priceToSales": 0.29058,
          "priceToCashflow": 0.05486,
          "medianMarketCap": {},
          "threeYearEarningsGrowth": {},
          "priceToEarningsCat": {},
          "priceToBookCat": {},
          "priceToSalesCat": {},
          "priceToCashflowCat": {},
          "medianMarketCapCat": {},
          "threeYearEarningsGrowthCat": {}
        },
        "bondHoldings": {
          "maturity": {},
          "duration": {},
          "creditQuality": {},
          "maturityCat": {},
          "durationCat": {},
          "creditQualityCat": {}
        },
        "bondRatings": [
          {
            "us_government": 0
          }
        ],
        "sectorWeightings": [
          {
            "realestate": 0.018
          },
          {
            "consumer_cyclical": 0.0919
          },
          {
            "basic_materials": 0.015800001
          }
        ]
      },
      "exchange": "NYSEArca",
      "name": "State Street SPDR S&P 500 ETF Trust",
      "beta3Year": 0.97,
      "firstTradeDate": "1993-01-29",
      "performance": {
        "fundCategoryName": "Large Blend",
        "performanceOverview": {
          "asOfDate": 1793750400,
          "morningStarReturnRating": {},
          "ytdReturnPct": 0.1332801,
          "fiveYrAvgReturnPct": 0.1192181,
          "numYearsUp": {},
          "numYearsDown": {},
          "bestOneYrTotalReturn": {},
          "worstOneYrTotalReturn": {},
          "bestThreeYrTotalReturn": {},
          "worstThreeYrTotalReturn": {},
          "oneYearTotalReturn": 0.14784351,
          "threeYearTotalReturn": 0.2229608
        },
        "performanceOverviewCat": {
          "asOfDate": {},
          "morningStarReturnRating": {},
          "ytdReturnPct": 0.051434003,
          "fiveYrAvgReturnPct": 0.112004004,
          "numYearsUp": {},
          "numYearsDown": {},
          "bestOneYrTotalReturn": {},
          "worstOneYrTotalReturn": {},
          "bestThreeYrTotalReturn": {},
          "worstThreeYrTotalReturn": {},
          "oneYearTotalReturn": 0.27720898,
          "threeYearTotalReturn": 0.1934272
        },
        "trailingReturns": {
          "asOfDate": 1793750400,
          "ytd": 0.116868295,
          "oneMonth": -0.0087734,
          "threeMonth": 0.0145386,
          "oneYear": 0.12008721,
          "threeYear": 0.2326477,
          "fiveYear": 0.1196218,
          "tenYear": 0.1534065,
          "lastBullMkt": 0,
          "lastBearMkt": 0
        },
        "trailingReturnsNav": {
          "ytd": 0.116868295,
          "oneMonth": -0.0087734,
          "threeMonth": 0.0145386,
          "oneYear": 0.12008721,
          "threeYear": 0.2326477,
          "fiveYear": 0.1196218,
          "tenYear": 0.1534065
        },
        "trailingReturnsCat": {
          "ytd": 0.051434003,
          "oneMonth": 0.0943234,
          "threeMonth": 0.0341969,
          "oneYear": 0.27720898,
          "threeYear": 0.1934272,
          "fiveYear": 0.112004004,
          "tenYear": 0.1377275,
          "lastBullMkt": 0,
          "lastBearMkt": 0
        },
        "annualTotalReturns": {
          "returns": [
            {
              "year": "2025",
              "annualValue": 0.1771505
            },
            {
              "year": "2024",
              "annualValue": 0.24885151
            },
            {
              "year": "2023",
              "annualValue": 0.2618955
            }
          ],
          "returnsCat": [
            {
              "year": "2025",
              "annualValue": 0.1554386
            },
            {
              "year": "2024",
              "annualValue": 0.2144601
            },
            {
              "year": "2023",
              "annualValue": 0.2231864
            }
          ]
        },
        "pastQuarterlyReturns": {
          "returns": []
        },
        "riskOverviewStatistics": {
          "riskRating": {},
          "riskStatistics": [
            {
              "year": "5y",
              "alpha": 1.06,
              "beta": 0.98,
              "meanAnnualReturn": 1.04,
              "rSquared": 99.27,
              "stdDev": 15.42,
              "sharpeRatio": 0.56,
              "treynorRatio": 8.1
            },
            {
              "year": "3y",
              "alpha": 0.64,
              "beta": 0.97,
              "meanAnnualReturn": 1.82,
              "rSquared": 99.12,
              "stdDev": 12.3,
              "sharpeRatio": 1.41,
              "treynorRatio": 19.32
            },
            {
              "year": "10y",
              "alpha": 0.77,
              "beta": 0.96,
              "meanAnnualReturn": 1.29,
              "rSquared": 99.25,
              "stdDev": 15.31,
              "sharpeRatio": 0.85,
              "treynorRatio": 13.22
            }
          ]
        },
        "riskOverviewStatisticsCat": {
          "riskStatisticsCat": [
            {
              "year": "5y",
              "alpha": -1.39,
              "beta": 0.96,
              "meanAnnualReturn": 0.99,
              "rSquared": 92.82,
              "stdDev": {},
              "sharpeRatio": 0.53,
              "treynorRatio": 7.79
            },
            {
              "year": "3y",
              "alpha": -1.58,
              "beta": 0.98,
              "meanAnnualReturn": 1.55,
              "rSquared": 90.91,
              "stdDev": {},
              "sharpeRatio": 1.03,
              "treynorRatio": 14.75
            },
            {
              "year": "10y",
              "alpha": -1.07,
              "beta": 0.98,
              "meanAnnualReturn": 1.18,
              "rSquared": 94.36,
              "stdDev": {},
              "sharpeRatio": 0.76,
              "treynorRatio": 11.58
            }
          ]
        }
      },
      "netAssets": 796865200000,
      "ytdReturnPct": 11.68683,
      "fiftyTwoWeekHigh": 781.62,
      "dividendYieldPct": 1,
      "previousClose": 766.81,
      "description": "The trust seeks to achieve its investment objective by holding a portfolio of the common stocks that are included in the index (the “Portfolio”), with the we...",
      "fiftyTwoWeekLow": 629.28,
      "category": "Large Blend",
      "expenseRatioPct": 0.0945,
      "fundType": "ETF",
      "changePercent": -4.40918,
      "holdingsTurnover": 0.03,
      "legalType": "Exchange Traded Fund",
      "symbol": "SPY",
      "fundFamily": "State Street Investment Management",
      "currency": "USD",
      "priceTime": "2026-11-05T21:00:00Z",
      "price": 733
    }
  ]
}
```

## Related APIs

For a stock's current price use [`yahoo-finance/prices`](https://docs.mindcase.co/apis/yahoo-finance/prices); for price history use [`yahoo-finance/quotes`](https://docs.mindcase.co/apis/yahoo-finance/quotes).


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