> ## Documentation Index > Fetch the complete documentation index at: /docs/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > Quiver Quantitative API: base URL https://api.quiverquant.com, endpoints under /beta/. Authenticate every request with the header `Authorization: Bearer `. Keys are on https://api.quiverquant.com/dashboard/ after subscribing at https://api.quiverquant.com/pricing/. > AI agents can use the Quiver MCP server at https://mcp.quiverquant.com/ (streamable HTTP; OAuth sign-in, or the API key as a Bearer token). Setup: https://api.quiverquant.com/docs/mcp-server. > Each dataset needs a plan (https://api.quiverquant.com/docs/plans-and-access) and each endpoint has a per-account rate limit (https://api.quiverquant.com/docs/rate-limits). # Earnings Distortion Scores > Access New Constructs' detailed ratings for stocks, ETFs, and mutual funds. Ratings are derived from proprietary analysis of SEC filings and cover Overall Risk/Reward, Economic vs. Reported EPS, ROIC, FCF Yield, Price-to-Economic Book Value, Growth Appreciation Period (GAP), Portfolio quality, Total Annual Costs, and Cash Allocation. Data is updated daily. **Plan:** a New Constructs subscription, sold separately from the Quiver API plans. See [Plans and data access](/docs/plans-and-access.md). ## OpenAPI ````yaml /openapi.json get /beta/live/earningsdistortionscores/{ticker} openapi: 3.0.3 info: title: Quiver API version: v1 description: Tap into the power of alternative data contact: name: 'Us: info@quiverquant.com' email: info@quiverquant.com license: name: Terms of Service url: https://www.quiverquant.com/termsofservice/ servers: - url: https://api.quiverquant.com security: [] tags: - name: Congress description: Stock trades, holdings and profiles of members of Congress. - name: Trump trades description: Stock trades by Donald Trump. - name: Insiders and institutions description: Insider trades, 13F holdings, shareholders and executive pay. - name: Government contracts description: Federal contracts awarded to public companies. - name: Lobbying and donations description: Corporate lobbying, revolving door lobbyists and PAC donations. - name: Market data description: Daily prices, off-exchange trading and Polymarket trades. - name: Patents description: Patents granted to public companies, and patent-based signals. - name: Company data description: Layoff notices, app ratings and the Quiver newsfeed. - name: New Constructs description: New Constructs ratings, a separate subscription. paths: /beta/live/earningsdistortionscores/{ticker}: get: tags: - New Constructs summary: Earnings Distortion Scores description: >2- Access New Constructs' detailed ratings for stocks, ETFs, and mutual funds. Ratings are derived from proprietary analysis of SEC filings and cover Overall Risk/Reward, Economic vs. Reported EPS, ROIC, FCF Yield, Price-to-Economic Book Value, Growth Appreciation Period (GAP), Portfolio quality, Total Annual Costs, and Cash Allocation. Data is updated daily. operationId: live_earningsdistortionscores_retrieve parameters: - in: path name: ticker schema: type: string description: Ticker for any given stock, ETF, or mutual fund required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/EarningsDistortionScoresResponse' description: '' security: - WebPlatformTokenAuth: [] components: schemas: EarningsDistortionScoresResponse: title: EarningsDistortionScoresResponse description: JSON Response structure for earnings distortion scores endpoint. type: array items: $ref: '#/components/schemas/EarningsDistortionScore' EarningsDistortionScore: title: EarningsDistortionScore description: Earnings distortion score model. type: object properties: ticker_current: title: Ticker Current description: The ticker for the security on the dataset generation date. type: string company_name_current: title: Company Name Current description: The name of the company on the dataset generation date. type: string cik_current: title: Cik Current description: Central Index Key on the dataset generation date. type: string stock_exchange_current: title: Stock Exchange Current description: >- The exchange on which a ticker trades on the dataset generation date. type: string market_identifier_code_current: title: Market Identifier Code Current description: >- The market identifier code (MIC) for the exchange on which a ticker trades on the dataset generation date. type: string company_status_current: title: Company Status Current description: The trading status of the security on the dataset generation date. type: string ticker_on_event_date: title: Ticker On Event Date description: The ticker for the security on the event_date. type: string company_name_on_event_date: title: Company Name On Event Date description: The name of the company on the event_date. type: string cik_on_event_date: title: Cik On Event Date description: Central Index Key on the event_date. type: string stock_exchange_on_event_date: title: Stock Exchange On Event Date description: The exchange on which a ticker traded on the event_date. type: string market_identifier_code_on_event_date: title: Market Identifier Code On Event Date description: >- The market identifier code (MIC) for the exchange on which a ticker traded on event_date. type: string figi: title: Figi description: Financial Instrument Global Identifier type: string perm_id: title: Perm Id description: Refinitiv Permanent Identifier type: string lei: title: Lei description: Legal Entity Identifier type: string event_date: title: Event Date description: The date of the event that created new or revised data. type: string format: date-time nc_publish_date_actual: title: Nc Publish Date Actual description: The date we published the data in this row to clients. type: string rating_overall: title: Rating Overall description: >- Our Overall rating for stocks is based on 5 component ratings: Economic vs Reported EPS, ROIC (Return on Invested Capital), FCF Yield, Price-to-Economic Book Value, and GAP (Growth Appreciation Period). Our Overall rating for ETFs also considers Total Annual Costs. Our Overall rating for mutual fund ratings also considers Total Annual Costs & Cash Allocation. We assign ratings as follows: Most Attractive (1 - best rating), Attractive (2), Neutral (3), Unattractive (4), Very Unattractive (5 - worst rating). type: number rating_income_net_economic_profit: title: Rating Income Net Economic Profit description: >- Our Economic vs Reported EPS rating compares reported accounting income to the economic earnings of the company. We assign ratings as follows: Most Attractive (1 - best rating), Attractive (2), Neutral (3), Unattractive (4), Very Unattractive (5 - worst rating). type: number rating_roic: title: Rating Roic description: >- Our Return on Invested Capital (ROIC) rating is based on the aggregate cash on cash returns of the company. We assign ratings as follows: Most Attractive (1 - best rating), Attractive (2), Neutral (3), Unattractive (4), Very Unattractive (5 - worst rating). type: number rating_fcf_yield: title: Rating Fcf Yield description: >- 2-Year Average FCF (excl cash) Yield Rating measures the amount of cash available for distribution to all stakeholders relative to the total value of the enterprise. We assign ratings as follows: Most Attractive (1 - best rating), Attractive (2), Neutral (3), Unattractive (4), Very Unattractive (5 - worst rating). type: number rating_price_to_ebv_ratio: title: Rating Price To Ebv Ratio description: >- Our Price-to-Economic Book Value rating is based on the growth expectations embedded in the stock price. We assign ratings as follows: Most Attractive (1 - best rating), Attractive (2), Neutral (3), Unattractive (4), Very Unattractive (5 - worst rating). type: number rating_gap: title: Rating Gap description: >- Our GAP (Growth Appreciation Period) rating is based on the number of years of future profit growth required to justify the current valuation of the stock. We assign ratings as follows: Most Attractive (1 - best rating), Attractive (2), Neutral (3), Unattractive (4), Very Unattractive (5 - worst rating). type: number rating_portfolio: title: Rating Portfolio description: >- Our Portfolio rating for ETFs and mutual funds is based on the aggregated stock ratings of the securities the fund holds as well as its allocation to cash. We assign ratings as follows: Most Attractive (1 - best rating), Attractive (2), Neutral (3), Unattractive (4), Very Unattractive (5 - worst rating). type: number rating_total_annual_cost: title: Rating Total Annual Cost description: >- Our Total Annual Costs rating for ETFs and mutual funds is based on the all-in cost of a minimum investment in each fund assuming a 3-year holding period, the average holding period for mutual funds. We assign ratings as follows: Most Attractive (1 - best rating), Attractive (2), Neutral (3), Unattractive (4), Very Unattractive (5 - worst rating). type: number rating_cash_allocation: title: Rating Cash Allocation description: >- Our Cash Allocation rating for mutual funds is based on the percent of the fund's assets allocated to cash. We assign ratings as follows: Most Attractive (1 - best rating), Attractive (2), Neutral (3), Unattractive (4), Very Unattractive (5 - worst rating). type: number new_score_ind: title: New Score Ind type: integer old_score: title: Old Score type: number required: - ticker_current - event_date securitySchemes: WebPlatformTokenAuth: type: http scheme: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.