Fundamentals API (quoteSummary)

Company profile, financial statements, key statistics, earnings, analyst trends and holders for one symbol, from 35 YH quoteSummary modules chosen per request.

GET/v11/finance/quoteSummary/{symbol}

Request

curl -H "x-api-key: $KEY" \
  "https://api.stockdataapi.com/v11/finance/quoteSummary/AAPL?modules=assetProfile,price,financialData"

Send your key in the x-api-key header. Try it in the browser with your own key.

Parameters

symbol

pathstringrequired

Symbol such as AAPL, BRK-B, ^GSPC, ES=F, BTC-USD or M&M.NS. Letters, digits and . ^ = & -, at most 20 characters, case-insensitive. Percent-encode ^, = and & in a URL (%5EGSPC, ES%3DF, M%26M.NS).

modules

querystring

Comma-separated module names from the list below, at most 1,000 characters. Unknown names are ignored; naming none that is known is a 400.

Default: assetProfile,summaryDetail,price,defaultKeyStatistics,financialData

Also accepted, for compatibility with existing clients, and ignored: region, lang.

Modules

assetProfile
balanceSheetHistory
balanceSheetHistoryQuarterly
calendarEvents
cashflowStatementHistory
cashflowStatementHistoryQuarterly
defaultKeyStatistics
earnings
earningsHistory
earningsTrend
esgScores
financialData
fundOwnership
fundPerformance
fundProfile
incomeStatementHistory
incomeStatementHistoryQuarterly
indexTrend
industryTrend
insiderHolders
insiderTransactions
institutionOwnership
majorDirectHolders
majorHoldersBreakdown
netSharePurchaseActivity
pageViews
price
quoteType
recommendationTrend
secFilings
sectorTrend
summaryDetail
summaryProfile
topHoldings
upgradeDowngradeHistory

Behavior

A module the source has no data for is simply absent from the result.
A stored payload older than an hour, or missing a module you asked for, is refetched (only the requested modules) and merged into what is stored.
An unknown symbol is a 404 with a YH-style quoteSummary.error envelope.
Values keep YH's {raw, fmt} wrapping.

Example response

{
  "quoteSummary": {
    "result": [
      {
        "assetProfile": {
          "sector": "Technology",
          "industry": "Consumer Electronics",
          "fullTimeEmployees": 161000,
          "longBusinessSummary": "Apple designs, manufactures and markets smartphones, personal computers and wearables."
        },
        "price": {
          "currency": "USD",
          "shortName": "Apple Inc.",
          "regularMarketPrice": { "raw": 230.5, "fmt": "230.50" }
        },
        "financialData": {
          "currentPrice": { "raw": 230.5, "fmt": "230.50" },
          "recommendationKey": "buy"
        }
      }
    ],
    "error": null
  }
}

json

Every plan includes this endpoint.

Create your free key