POST /v1/data/yahoo-finance/index-funds/run
Pricing: $0.001 per fund ($1.00 per 1,000).
Request
Send the inputs underparams. Only the keys below are accepted; any other key returns 422 invalid_params.
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
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"
]
}
}'
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
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 indata 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.{
"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 useyahoo-finance/prices; for price history use yahoo-finance/quotes.