Stock Data

Stock Summary Data

Company current price, valuations ratios and ranks, summary information. This API mainly provides data for the stock summary page.

Request

GET /stock/{symbol}/summary

Example

GET https://api.gurufocus.com/public/user/{api_token}/stock/WMT/summary

Note: For all stocks that are not traded in the US, please replace {symbol} with {exchange:symbol} when calling the api. For example: ASX:ABC

Response

Response will be an object containing the stock summary data
{
  "summary": {
    "general": {
      "company": "Walmart Inc",
      "price": 134.48,
      "timestamp": "1662084501",
      "gf_score": "82",
      "rank_financial_strength": "7",
      "rank_profitability": "8",
      "rank_gf_value": "7",
      "rank_growth": "6",
      "rank_momentum": "4",
      "supersector": "Defensive",
      "sector": "Consumer Defensive",
      "group": "Retail - Defensive",
      "subindustry": "Discount Stores",
      "risk_assessment": "Low Risk: Strong fundamentals, worth long-term holding",
      "gf_valuation": "Modestly Undervalued",
      "desc": "America's largest retailer by sales, Walmart operated over 10,500 stores under 46 banners at the end of fiscal 2022, selling a variety of general merchandise and grocery items. Its home market accounted for 82% of sales in fiscal 2022, with Mexico and Central America (6%) and Canada (4%) its largest external markets. In the United States at the namesake banner, around 56% of sales come from grocery, 32% from general merchandise, and 11% from health and wellness items. The company operates several e-commerce properties apart from its eponymous site, including Flipkart and shoes.com (it also owns a roughly 10% stake in Chinese online retailer JD.com). Combined, e-commerce accounted for about 13% of fiscal 2022 sales.",
      "short_desc": "Walmart Inc operates retail stores in various formats under various banners. Its operations comprise of three reportable business segments, Walmart U.S., Walmart International and Sam's Club in three categories retail, wholesale and others.",
      "rating": "1",
      "currency": "$",
      "country": "USA"
    },
    "chart": {
      "GF Value": "149.13",
      "Earnings Power Value": "108.32",
      "Net-Net Working Capital": "-43.82",
      "Net Current Asset Value": "-31.180",
      "Tangible Book": "17.84",
      "Projected FCF": "86.00",
      "DCF (FCF Based)": "0.00",
      "DCF (Earnings Based)": "0.00",
      "Median P/S Value": "116.96",
      "Graham Number": "44.85",
      "Peter Lynch Value": "28.21"
    }
  }
}

Company Financial Data

Company Financials up to 40 years of annual data and 120 quarters of quarterly data. This API mainly provides data for the 30-year financial page.

Request

GET /stock/{symbol}/financials

Parameters

  • order Optional
    Using 'desc' to sort by fiscal year, largest to smallest. Otherwise it will be sorted from smallest to largest
  • target_currency Optional
    Specify currency unit for stock financial data. Available currency symbols can be found in Currency symbol List

Example 1

GET https://api.gurufocus.com/public/user/{api_token}/stock/WMT/financials

Response

Response will be an object containing the financial data. Different companies have different financial templates, and each template has different financial fields. GuruFocus now changes the new financial API to be in accordance with the template shown in 30-Y financials page, effective 2020-01-03. Any recent financial API or 30-year financials data changes can be found HERE. By default, the returned values are sorted in ascending order. You can change this by setting the parameter "order" as "desc" and the URL will be "stock/WMT/financials?order=desc".
{
  "financials": {
    "financial_template_parameters": {
      "ind_template": "N",
      "REITs": "N",
      "IsDirect": "Indirect Method"
    },
    "annuals": {
      "Fiscal Year": [
        "1989-12",
        "1990-12",
        "1991-12",
        "1992-12",
        "1993-12",
        "1994-12",
        "1995-12",
        "1996-12",
        "1997-12",
        "1998-12",
        "1999-12",
        "2000-12",
        "2001-12",
        "2002-12",
        "2003-12",
        "2004-12",
        "2005-12",
        "2006-12",
        "2007-12",
        "2008-12",
        "2009-12",
        "2010-12",
        "2011-12",
        "2012-12",
        "2013-12",
        "2014-12",
        "2015-12",
        "2016-12",
        "2017-12",
        "2018-12",
        "TTM"
      ],
      "Preliminary": [],
      "per_share_data_array": {
        "Revenue per Share": [
          "12.207",
          "14.862",
          "18.201",
          "20.612",
          "23.122",
          "26.318",
          "31.039",
          "37.284",
          "43.068",
          "45.932",
          "52.087",
          "59.154",
          "66.646",
          "74.523",
          "83.582",
          "92.589",
          "102.317",
          "105.258",
          "114.945",
          "128.529",
          "138.286",
          "145.079",
          "149.754",
          "149.869",
          "156.129",
          "166.227",
          "174.671",
          "182.693",
          "196.4",
          "204.19",
          "212.097"
        ],
        "EBITDA per Share": [],
        "EBIT per Share": [],
        "Earnings per Share (Diluted)": [],
        "EPS without NRI": [],
        "Owner Earnings per Share (TTM)": [],
        "Free Cash Flow per Share": [],
        "Operating Cash Flow per Share": [],
        "Dividends per Share": [],
        "Book Value per Share": [],
        "Tangible Book per Share": [],
        "Total Debt per Share": [],
        "Month End Stock Price": []
      },
      "common_size_ratios": {
        "ROE %": [],
        "ROE % Adjusted to Book Value": [],
        "ROA %": [],
        "Return-on-Tangible-Equity": [],
        "Return-on-Tangible-Asset": [],
        "ROC (Joel Greenblatt) %": [],
        "ROC (ROIC) %": [],
        "WACC %": [],
        "Effective Interest Rate on Debt %": [],
        "Gross Margin %": [],
        "Operating Margin %": [],
        "Net Margin %": [],
        "FCF Margin %": [],
        "Debt-to-Equity": [],
        "Equity-to-Asset": [],
        "Debt-to-Asset": [],
        "Gross-Profit-to-Asset %": [],
        "Asset Turnover": [],
        "Dividend Payout Ratio": [],
        "Days Sales Outstanding": [],
        "Days Payable": [],
        "Days Inventory": [],
        "Cash Conversion Cycle": [],
        "Inventory Turnover": [],
        "COGS-to-Revenue": [],
        "Inventory-to-Revenue": []
      },
      "income_statement": {},
      "balance_sheet": {},
      "cashflow_statement": {},
      "valuation_ratios": {},
      "valuation_and_quality": {}
    },
    "quarterly": {}
  }
}

Example 2

GET https://api.gurufocus.com/public/user/{api_token}/stock/XTER:APC/financials?order=desc&target_currency=EUR

Response

{
  "financials": {
    "financial_template_parameters": {
      "ind_template": "N",
      "REITs": "N",
      "IsDirect": "Indirect Method",
      "financial_report_frequency": "Quarterly"
    },
    "annuals": {
      "Fiscal Year": [
        "2023-09",
        "2022-09",
        "2021-09",
        "2020-09",
        "2019-09",
        "2018-09",
        "2017-09",
        "2016-09",
        "2015-09",
        "2014-09",
        "2013-09",
        "2012-09",
        "2011-09",
        "2010-09",
        "2009-09",
        "2008-09",
        "2007-09",
        "2006-09",
        "2005-09",
        "2004-09",
        "2003-09",
        "2002-09",
        "2001-09",
        "2000-09",
        "1999-09",
        "1998-09",
        "1997-09",
        "1996-09",
        "1995-09",
        "1994-09",
        "TTM"
      ],
      "Preliminary": [
        "0",
        "0",
        "0",
        "0",
        "0",
        "0",
        "0",
        "0",
        "0",
        "0",
        "0",
        "0",
        "0",
        "0",
        "0",
        "0",
        "0",
        "0",
        "0",
        "0",
        "0",
        "0",
        "0",
        "0",
        "0",
        "0",
        "0",
        "0",
        "0",
        "0",
        "0"
      ],
      "per_share_data_array": {
        "Revenue per Share": [
          "22.712",
          "24.395",
          "18.437",
          "13.296",
          "12.704",
          "11.38",
          "9.155",
          "8.733",
          "8.987",
          "5.792",
          "4.901",
          "4.588",
          "3.001",
          "1.922",
          "1.159",
          "1.034",
          "0.71",
          "0.618",
          "0.474",
          "0.312",
          "0.271",
          "0.289",
          "0.304",
          "0.455",
          "0.3",
          "0.273",
          "0.433",
          "0.612",
          "0.693",
          "0.596",
          "22.66"
        ],
        "EBITDA per Share": [
          "7.655",
          "8.237",
          "6.206",
          "3.924",
          "3.997",
          "3.73",
          "3.058",
          "2.97",
          "3.249",
          "1.959",
          "1.636",
          "1.731",
          "0.998",
          "0.572",
          "0.337",
          "0.243",
          "0.136",
          "0.086",
          "0.062",
          "0.02",
          "0.006",
          "0.011",
          "0.004",
          "0.068",
          "0.039",
          "0.023",
          "-0.052",
          "-0.07",
          "0.053",
          "0.046",
          "7.64"
        ],
        "EBIT per Share": [],
        "Earnings per Share (Diluted)": [],
        "EPS without NRI": [],
        "Owner Earnings per Share (TTM)": [],
        "Free Cash Flow per Share": [],
        "Operating Cash Flow per Share": [],
        "Dividends per Share": [],
        "Book Value per Share": [],
        "Tangible Book per Share": [],
        "Total Debt per Share": [],
        "Month End Stock Price": []
      },
      "common_size_ratios": {
        "ROE %": [],
        "ROE % Adjusted to Book Value": [],
        "ROA %": [],
        "Return-on-Tangible-Equity": [],
        "Return-on-Tangible-Asset": [],
        "ROC (Joel Greenblatt) %": [],
        "ROC (ROIC) %": [],
        "WACC %": [],
        "Effective Interest Rate on Debt %": [],
        "Gross Margin %": [],
        "Operating Margin %": [],
        "Net Margin %": [],
        "FCF Margin %": [],
        "Debt-to-Equity": [],
        "Equity-to-Asset": [],
        "Debt-to-Asset": [],
        "Gross-Profit-to-Asset %": [],
        "Asset Turnover": [],
        "Dividend Payout Ratio": [],
        "Days Sales Outstanding": [],
        "Days Payable": [],
        "Days Inventory": [],
        "Cash Conversion Cycle": [],
        "Inventory Turnover": [],
        "COGS-to-Revenue": [],
        "Inventory-to-Revenue": []
      },
      "income_statement": {},
      "balance_sheet": {},
      "cashflow_statement": {},
      "valuation_ratios": {},
      "valuation_and_quality": {}
    },
    "quarterly": {}
  }
}

Company Key Statistics Data

Request

GET /stock/{symbol}/keyratios

Example

GET https://api.gurufocus.com/public/user/{api_token}/stock/WMT/keyratios

Response

Response will be an object containing the key statistics data.
{
  "Basic": {
    "Price Updated Time": "2019-06-07 15:31:06 (EDT)"
  },
  "Fundamental": {
    "Currency": "USD",
    "Total Assets (Current)": "234544.000",
    "Book Value per Share": "23.63",
    "Cash-to-Debt": "0.16",
    "Cash-to-Debt (10y High)": "0.29",
    "Cash-to-Debt (10y Low)": "0.00",
    "Cash-to-Debt (10y Median)": "0.12",
    "Share Class Description": "",
    "Headquarter Country": "USA",
    "Current Ratio": "0.77",
    "Current Ratio (10y High)": "1.86",
    "Current Ratio (10y Low)": "0.73",
    "Current Ratio (10y Median)": "0.92",
    "Days Inventory": "42.42",
    "Days Inventory (10y High)": "45.30",
    "Days Inventory (10y Low)": "40.07",
    "Days Inventory (10y Median)": "43.11",
    "Days Sales Outstanding": "3.78",
    "Days Sales Outstanding (10y High)": "5.27",
    "Days Sales Outstanding (10y Low)": "3.78",
    "Days Sales Outstanding (10y Median)": "4.46",
    "Debt-to-Equity": "0.85",
    "Debt-to-Revenue": "0.11",
    "EPS": "2.89",
    "Equity-to-Asset": "0.29",
    "Equity-to-Asset (10y High)": "0.48",
    "Equity-to-Asset (10y Low)": "0.29",
    "Equity-to-Asset (10y Median)": "0.39",
    "Enterprise Value (Current M)": "360302.040",
    "Enterprise Value ($M)": "360302.040",
    "Piotroski F-Score": 5,
    "Piotroski F-Score (10y High)": 9,
    "Piotroski F-Score (10y Low)": 2,
    "Piotroski F-Score (10y Median)": 6,
    "Insider Ownership": "1.75",
    "Institutional Ownership": "45.64",
    "Interest Coverage": "8.74",
    "Interest Coverage (10y High)": "12.33",
    "Interest Coverage (10y Low)": "8.74"
  }
}

Company Current Quote Data

Request

GET /stock/{symbols}/quote

Support at most 100 stocks split by ","(eg. WMT,AAPL).

Example

GET https://api.gurufocus.com/public/user/{api_token}/stock/WMT,AAPL/quote

Response

Response will be an object containing the stock quote data.
[
  {
    "timestamp": 1559935866,
    "Price Updated Time": "2019-06-07 15:31:06 (EDT)",
    "Current Price": 106.06,
    "Day's Change": 0.9,
    "open": 105.23,
    "Day's Volume": 6621731,
    "low": 105.05,
    "high": 106.36,
    "Currency": "USD",
    "Symbol": "WMT",
    "Exchange": "NYSE",
    "Price Change": 0.95
  },
  {
    "timestamp": 1559935837,
    "Price Updated Time": "2019-06-07 15:30:37 (EDT)",
    "Current Price": 190.15,
    "Day's Change": 2.66,
    "open": 186.51,
    "Day's Volume": 30610492,
    "low": 185.77,
    "high": 191.92,
    "Currency": "USD",
    "Symbol": "AAPL",
    "Exchange": "NAS",
    "Price Change": 4.93
  }
]

Stock Historical Price/Unadjusted Price/Full Price/Volume Data

Company historical price/unadjusted price/Full Price/Volume data. Here the price is the close price. The full price includes open price/close price/high price/low price/volume, and it is the price_ohlc option.

Request

GET /stock/{symbol}/price(or unadjusted_price/price_ohlc/volume)?start_date={start_date}&end_date={end_date}

Example

GET https://api.gurufocus.com/public/user/{api_token}/stock/WMT/price?start_date=20100101&end_date=20200101

Response

Response will be an array containing the price(or unadjusted price/volume) data. Data format: [date , split-adjusted close price]. The parameters start_date and end_date are optional. If not set, all the available data will be returned.
[
  [
    "01-02-1990",
    5.891
  ],
  [
    "01-03-1990",
    5.891
  ],
  [
    "01-05-1990",
    5.859
  ]
]

Historical Ownership Data

Historical Information about ownership. This API mainly provides data for the stock ownership page.

Request

GET /stock/{symbol}/indicator_history

Example

GET https://api.gurufocus.com/public/user/{api_token}/stock/WMT/indicator_history

Response

Response will be an object of arrays containing the historical ownership information of symbol.
{
  "insti_owner": [
    [
      "2005-01-31",
      0.83,
      47.61
    ],
    [
      "2005-02-28",
      1.81,
      103.56
    ],
    [
      "2005-03-31",
      3.9,
      224.69
    ],
    [
      "2005-04-30",
      4.1,
      236.27
    ]
  ],
  "shares_outstanding": [
    [
      "1979-09-28",
      9520
    ],
    [
      "1980-09-28",
      10920
    ],
    [
      "1981-09-28",
      12257.78
    ],
    [
      "1982-09-28",
      12714.07
    ],
    [
      "1983-09-28",
      13422.5
    ]
  ],
  "InstitutionSharesHeld": [
    [
      "2005-01-31",
      47.61,
      47.61
    ],
    [
      "2005-02-28",
      103.56,
      103.56
    ],
    [
      "2005-03-31",
      224.69,
      224.69
    ],
    [
      "2005-04-30",
      236.27,
      236.27
    ]
  ]
}

Current Ownership Data

Current Institutional Ownership and Insider Ownership Information. This API mainly provides data ofstock ownership page.

Request

GET /stock/{symbol}/ownership

Example

GET https://api.gurufocus.com/public/user/{api_token}/stock/WMT/ownership

Response

Response will be an object containing Institutional Ownership and Insider Ownership information of symbol.
{
  "company": "Walmart Inc",
  "display_symbol": "WMT",
  "exchange": "NYSE",
  "Share_Outstanding": {
    "value": "2692.84(Mil)"
  },
  "Institutional_Ownership": {
    "percentage": "22.04%",
    "value": "593.41(Mil)"
  },
  "Insider_Ownership": {
    "percentage": "1.63%",
    "value": "43.93(Mil)"
  },
  "Float_Percentage_of_TSO": {
    "percentage": "52.77%",
    "value": "1421.07Mil"
  }
}

Real-time Guru Trades of Specific Companies

Real-time Guru stock trades and current holdings data for specific companies.

Request

GET /stock/{symbol}/gurus

Example

GET https://api.gurufocus.com/public/user/{api_token}/stock/WMT/gurus

Response

Response will be an object containing the guru picks data.
{
  "WMT": {
    "picks": [
      {
        "guru": "VANGUARD GROUP INC",
        "date": "2019-03-31",
        "action": "Add",
        "impact": "0",
        "price_min": "92.86",
        "price_max": "102.2",
        "Avg": "97.26",
        "comment": "Add 0.43%",
        "current_shares": "129186475",
        "guru_id": "2402"
      },
      {
        "guru": "BlackRock Inc.",
        "date": "2019-03-31",
        "action": "Add",
        "impact": "0",
        "price_min": "92.86",
        "price_max": "102.2",
        "Avg": "97.26",
        "comment": "Add 0.25%",
        "current_shares": "87313606",
        "guru_id": "2453"
      }
    ]
  }
}

Real-Time Insider Trades of Specific Companies

Company Real-time insider trades data.

Request

GET /stock/{symbol}/insider

Example

GET https://api.gurufocus.com/public/user/{api_token}/stock/WMT/insider

Response

Response will be an object containing the insider data.
{
  "WMT": [
    {
      "position": "10% Owner",
      "date": "2019-05-23",
      "type": "S",
      "trans_share": "841,920",
      "final_share": "1,439,840,492",
      "price": "101.44",
      "cost": "85404.4",
      "insider": "WALTON JIM C",
      "change": "4.55"
    },
    {
      "position": "10% Owner",
      "date": "2019-05-23",
      "type": "S",
      "trans_share": "841,920",
      "final_share": "1,429,086,992",
      "price": "101.44",
      "cost": "85404.4",
      "insider": "WALTON ALICE L",
      "change": "4.55"
    }
  ]
}

List of Company Executives

Get the list of company executives.

Request

GET /stock/{symbol}/executives

Example

GET https://api.gurufocus.com/public/user/{api_token}/stock/WMT/executives

Response

Response will be an array containing the executives data.
[
  {
    "name": "John D Rainey",
    "position": "officer: Executive Vice President",
    "transaction_date": "2022-05-23"
  },
  {
    "name": "Randall L Stephenson",
    "position": "director",
    "transaction_date": "2021-03-03"
  },
  {
    "name": "Donna Morris",
    "position": "officer: Executive Vice President",
    "transaction_date": "2020-02-17"
  },
  {
    "name": "Kathryn J. Mclay",
    "position": "officer: Executive Vice President",
    "transaction_date": "2019-11-15"
  },
  {
    "name": "Suresh Kumar",
    "position": "officer: Chief Technology Officer",
    "transaction_date": "2019-07-08"
  },
  {
    "name": "Cesar Conde",
    "position": "director",
    "transaction_date": "2019-02-07"
  }
]

Dividend History Data

Get 30 years dividend history data of a stock.

Request

GET /stock/{symbol}/dividend

Example

GET https://api.gurufocus.com/public/user/{api_token}/stock/WMT/dividend

Response

Response will be an array containing the list of dividend history object.
[
  {
    "amount": "0.510",
    "ex_date": "2017-12-07",
    "record_date": "2017-12-08",
    "pay_date": "2018-01-02",
    "type": "Cash Div.",
    "currency": "USD"
  },
  {
    "amount": "0.510",
    "ex_date": "2017-08-09",
    "record_date": "2017-08-11",
    "pay_date": "2017-09-05",
    "type": "Cash Div.",
    "currency": "USD"
  },
  {
    "amount": "0.510",
    "ex_date": "2017-05-10",
    "record_date": "2017-05-12",
    "pay_date": "2017-06-05",
    "type": "Cash Div.",
    "currency": "USD"
  },
  {
    "amount": "0.510",
    "ex_date": "2017-03-08",
    "record_date": "2017-03-10",
    "pay_date": "2017-04-03",
    "type": "Cash Div.",
    "currency": "USD"
  },
  "...",
  {
    "amount": "0.002",
    "ex_date": "1985-06-17",
    "record_date": "1985-06-21",
    "pay_date": "1985-07-09",
    "type": "Cash Div.",
    "currency": "USD"
  },
  {
    "amount": "0.002",
    "ex_date": "1985-03-18",
    "record_date": "1985-03-22",
    "pay_date": "1985-04-10",
    "type": "Cash Div.",
    "currency": "USD"
  },
  {
    "amount": "0.002",
    "ex_date": "1984-12-07",
    "record_date": "1984-12-13",
    "pay_date": "1985-01-04",
    "type": "Cash Div.",
    "currency": "USD"
  }
]

Current Dividend Data

Get current dividend data of a stock.

Request

GET /stock/{symbol}/current_dividend

Example

GET https://api.gurufocus.com/public/user/{api_token}/stock/WMT/current_dividend

Response

Response will be an object of current dividend data.
{
  "Dividends per Share (TTM)": 2.27,
  "Dividend Yield %": 1.41,
  "Dividend Yield % (10y Range)": "1.37 - 3.46",
  "Dividend Yield % (10y Median)": 2.13,
  "Next Dividend Payment Date": "N/A",
  "Dividend Frequency": "Quarterly",
  "Currency": "$"
}

Analyst Estimate Data

Get analyst estimate data of a stock.

Request

GET /stock/{symbol}/analyst_estimate

Example

GET https://api.gurufocus.com/public/user/{api_token}/stock/WMT/analyst_estimate

Response

Response will be an array containing the annual and quarter estimate data.
{
  "annual": {
    "date": [
      "2019-01",
      "2020-01"
    ],
    "revenue_estimate": [
      510691.5,
      520968.1
    ],
    "ebit_estimate": [
      23043.48,
      23188.01
    ],
    "ebitda_estimate": [
      33599.2,
      33668
    ],
    "dividend_estimate": [
      2.136,
      2.1367
    ],
    "per_share_eps_estimate": [
      4.9189,
      5.0805
    ],
    "eps_nri_estimate": [
      4.9189,
      5.0805
    ],
    "eps_growth_rate_estimate": 5.88
  },
  "quarter": {}
}

Operating Data

Get operating data of a stock.

Request

GET /stock/{symbol}/operating_data

Example

GET https://api.gurufocus.com/public/user/{api_token}/stock/WMT/operating_data

Response

Response will be an array containing the annual and quarter operating data.
{
  "wmt": {
    "stores_at_period_end_num": {
      "name": "Number of Stores at Period End Total",
      "key": "stores_at_period_end_num",
      "data": {
        "annual": {
          "2018-01": 11718,
          "2019-01": 11361,
          "2020-01": 11501,
          "2021-01": 11443,
          "2022-01": 10593
        },
        "quarter": {
          "2018-07": 11735,
          "2018-10": 11277,
          "2019-01": 11361,
          "2019-04": 11368,
          "2019-07": 11389,
          "2019-10": 11438,
          "2020-01": 11501,
          "2020-04": 11484,
          "2020-07": 11496,
          "2020-10": 11510,
          "2021-01": 11443,
          "2021-04": 10526,
          "2021-07": 10524,
          "2021-10": 10566,
          "2022-01": 10593,
          "2022-04": 10585,
          "2022-07": 10585,
          "2022-10": 10586
        }
      }
    },
    "stores_opened_num": {
      "name": "Number of Stores Opened",
      "key": "stores_opened_num",
      "data": {
        "annual": {
          "2018-01": 324,
          "2019-01": 0,
          "2020-01": 0,
          "2021-01": 0,
          "2022-01": 0
        },
        "quarter": {
          "2018-07": 51,
          "2018-10": 47,
          "2019-01": 111,
          "2019-04": 24,
          "2019-07": 52,
          "2019-10": 91,
          "2020-01": 96,
          "2020-04": 10,
          "2020-07": 18,
          "2020-10": 29,
          "2021-01": 46,
          "2021-04": 51,
          "2021-07": 29,
          "2021-10": 42,
          "2022-01": 59,
          "2022-04": 11,
          "2022-07": 25,
          "2022-10": 28
        }
      }
    }
  }
}

Segments Data

Get segments data of a stock.

Request

GET /stock/{symbol}/segments_data?start_date={start_date?}

Parameters

  • start_date Optional
    start_date for segments data. Default is current date. Date format is YYYYmm

Example

GET https://api.gurufocus.com/public/user/{api_token}/stock/WMT/segments_data?start_date=201701

Response

Response will be an array containing the annual and quarter segments data.
{
  "business": {
    "annual": [
      {
        "Walmart US": 331666,
        "Membership and other income": 4076,
        "Walmart International": 120824,
        "Sam's Club": 57839,
        "Corporate and support": 0,
        "date": "2019-01"
      },
      {
        "Walmart US": 341004,
        "Corporate and support": 0,
        "Membership and other income": 4038,
        "Sam's Club": 58792,
        "Walmart International": 120130,
        "date": "2020-01"
      },
      {
        "Walmart US": 369963,
        "Corporate and support": 0,
        "Membership and other income": 3918,
        "Sam's Club": 63910,
        "Walmart International": 121360,
        "date": "2021-01"
      },
      {
        "Walmart US": 393247,
        "Corporate and support": 0,
        "Membership and other income": 4992,
        "Sam's Club": 73556,
        "Walmart International": 100959,
        "date": "2022-01"
      }
    ],
    "quarterly": [
      {
        "Walmart US": 99585,
        "Membership and other income": 1094,
        "Corporate and support": 0,
        "Sam's Club": 16527,
        "Walmart International": 34873,
        "date": "2021-01"
      },
      {
        "Walmart US": 93167,
        "Membership and other income": 1151,
        "Sam's Club": 16692,
        "Walmart International": 27300,
        "date": "2021-04"
      },
      {
        "Walmart US": 98192,
        "Sam's Club": 18644,
        "Walmart International": 23035,
        "Membership and other income": 1177,
        "date": "2021-07"
      },
      {
        "Walmart US": 96609,
        "Walmart International": 23627,
        "Membership and other income": 1318,
        "Sam's Club": 18971,
        "date": "2021-10"
      },
      {
        "Walmart US": 105279,
        "Sam's Club": 19249,
        "Walmart International": 26997,
        "Membership and other income": 1346,
        "Corporate and support": 0,
        "date": "2022-01"
      },
      {
        "Walmart US": 96904,
        "Membership and other income": 1281,
        "Sam's Club": 19621,
        "Walmart International": 23763,
        "date": "2022-04"
      },
      {
        "Walmart US": 105130,
        "Membership and other income": 1478,
        "Sam's Club": 21901,
        "Walmart International": 24350,
        "date": "2022-07"
      },
      {
        "Walmart US": 104775,
        "Membership and other income": 1344,
        "Sam's Club": 21399,
        "Walmart International": 25295,
        "date": "2022-10"
      }
    ],
    "keys": [
      "Walmart US",
      "Membership and other income",
      "Walmart International",
      "Sam's Club",
      "Corporate and support"
    ],
    "ttm": [
      {
        "date": "TTM",
        "Walmart US": 412088,
        "Sam's Club": 82170,
        "Walmart International": 100405,
        "Membership and other income": 5449,
        "Corporate and support": 0
      }
    ]
  },
  "geographic": {
    "annual": [
      {
        "US": 392265,
        "Non-US": 122140,
        "date": "2019-01"
      },
      {
        "US": 402532,
        "Non-US": 121432,
        "date": "2020-01"
      },
      {
        "US": 436649,
        "Non-US": 122502,
        "date": "2021-01"
      },
      {
        "US": 470295,
        "Non-US": 102459,
        "date": "2022-01"
      }
    ],
    "quarterly": [],
    "keys": [
      "US",
      "Non-US"
    ]
  }
}

Stock Indicators List

Get the list of Indicators.

Request

GET /stock/indicators

Example

GET https://api.gurufocus.com/public/user/{api_token}/stock/indicators

Response

Response will be an array containing the list of Indicators.
[
  {
    "key": "price",
    "name": "Price"
  },
  {
    "key": "revenue",
    "name": "Revenue"
  },
  {
    "key": "revenue_estimate",
    "name": "Revenue with Estimate"
  },
  {
    "key": "net_income",
    "name": "Net Income"
  },
  {
    "key": "pettm",
    "name": "PE Ratio (TTM)"
  },
  {
    "key": "price_to_owner_earnings",
    "name": "Price-to-Owner-Earnings"
  },
  {
    "key": "ps_ratio",
    "name": "PS Ratio"
  },
  {
    "key": "pb_ratio",
    "name": "PB Ratio"
  },
  {
    "key": "peg_ratio",
    "name": "PEG Ratio"
  },
  {
    "key": "yield",
    "name": "Dividend Yield %"
  },
  {
    "key": "mktcap",
    "name": "Market Cap"
  },
  {
    "key": "enterprise_value",
    "name": "Enterprise Value"
  },
  {
    "key": "shares_outstanding",
    "name": "Shares Outstanding (Diluted Average)"
  },
  {
    "key": "earning_per_share_diluted",
    "name": "Earnings per Share (Diluted)"
  },
  {
    "key": "per_share_eps_estimate",
    "name": "EPS with Estimate"
  },
  {
    "key": "eps_without_nri",
    "name": "EPS without NRI"
  },
  {
    "key": "owner_earnings",
    "name": "Owner Earnings per Share (TTM)"
  },
  {
    "key": "maxpe",
    "name": "Price at Max PE without NRI"
  },
  {
    "key": "medpe",
    "name": "Price at Med PE without NRI"
  },
  {
    "key": "minpe",
    "name": "Price at Min PE without NRI"
  },
  {
    "key": "custmpe",
    "name": "Price at PE(without NRI)="
  },
  {
    "key": "custmpeestimate",
    "name": "Price at PE(without NRI with Estimate)="
  },
  {
    "key": "maxps",
    "name": "Price at Max PS Ratio"
  },
  {
    "key": "medps",
    "name": "Price at Med PS Ratio"
  },
  {
    "key": "minps",
    "name": "Price at Min PS Ratio"
  },
  {
    "key": "custmps",
    "name": "Price at PS Ratio="
  },
  {
    "key": "maxpb",
    "name": "Price at Max PB Ratio"
  },
  {
    "key": "medpb",
    "name": "Price at Med PB Ratio"
  },
  {
    "key": "custmpb",
    "name": "Price at PB Ratio="
  }
]

Stock Indicator Data

Get stock data of Indicator.

Request

GET /stock/{symbol}/{indicator_key}?type={type?}

Parameters

  • indicator_key Required
    Indicator key got from Stock Indicators List API. Requiring URL-encoding.
  • type Optional
    This optional parameter type defines the time interval of each record.
    options of type:
    • a - annual
    • q - quarterly
    • ttm - Trailing 12-month

Example 1

GET https://api.gurufocus.com/public/user/{api_token}/stock/AAPL/net_income?type=a

Response

Response will be an array containing the stock Indicator data.
[
  [
    "1979-09-28",
    5.1
  ],
  [
    "1980-09-28",
    11.7
  ],
  [
    "1981-09-28",
    39.4
  ],
  [
    "1982-09-28",
    61.3
  ],
  [
    "1983-09-28",
    76.7
  ],
  [
    "1984-09-28",
    64.1
  ],
  [
    "1985-09-28",
    61.2
  ],
  [
    "1986-09-28",
    154
  ],
  [
    "1987-09-28",
    217.5
  ],
  [
    "1988-09-28",
    400.3
  ],
  [
    "1989-09-28",
    454
  ],
  [
    "1990-09-28",
    474.9
  ],
  [
    "1991-09-28",
    309.8
  ],
  [
    "1992-09-28",
    530.37
  ],
  [
    "1993-09-28",
    87
  ],
  [
    "1994-09-28",
    310
  ],
  [
    "1995-09-28",
    424
  ],
  [
    "1996-09-28",
    -816
  ],
  [
    "1997-09-28",
    -1045
  ],
  [
    "1998-09-28",
    309
  ],
  [
    "1999-09-28",
    601
  ],
  [
    "2000-09-28",
    786
  ],
  [
    "2001-09-28",
    -25
  ],
  [
    "2002-09-28",
    65
  ],
  [
    "2003-09-28",
    69
  ],
  [
    "2004-09-28",
    266
  ]
]

Example 2

GET https://api.gurufocus.com/public/user/{api_token}/stock/ABNB/price?type=a

Response

Response will be an array containing the stock Indicator data. For the indicator such as price have only daily data, the type parameter no longer works.
[
  [
    "12-10-2020",
    144.71
  ],
  [
    "12-11-2020",
    139.25
  ],
  [
    "12-14-2020",
    130
  ],
  [
    "12-15-2020",
    124.8
  ],
  [
    "12-16-2020",
    137.99
  ],
  [
    "12-17-2020",
    147.05
  ],
  [
    "12-18-2020",
    157.3
  ],
  [
    "12-21-2020",
    163.02
  ],
  [
    "12-22-2020",
    163.19
  ],
  [
    "12-23-2020",
    158.01
  ],
  [
    "12-24-2020",
    154.84
  ],
  [
    "12-28-2020",
    149
  ],
  [
    "12-29-2020",
    150
  ],
  [
    "12-30-2020",
    148.43
  ],
  [
    "12-31-2020",
    146.8
  ],
  [
    "01-04-2021",
    139.15
  ],
  [
    "01-05-2021",
    148.3
  ],
  [
    "01-06-2021",
    142.77
  ],
  [
    "01-07-2021",
    151.27
  ],
  [
    "01-08-2021",
    149.77
  ],
  [
    "01-11-2021",
    148.13
  ],
  [
    "01-12-2021",
    160.8
  ],
  [
    "01-13-2021",
    169.99
  ],
  [
    "01-14-2021",
    180.5
  ]
]

Stock News Headlines

Get news headlines of stock.

Request

GET /stock/news_feed

Parameters

  • symbol Required
    Stock id or Stock symbol

Example

GET https://api.gurufocus.com/public/user/{api_token}/stock/news_feed?symbol=MSFT

Response

Response will be an array containing the list of headlines.
[
  {
    "date": "2023-03-21 01:39:19",
    "headline": "Microsoft Stock: Is There Too Much AI Hype Baked In?",
    "url": "https://www.gurufocus.com/news/1966602/microsoft-stock-is-there-too-much-ai-hype-baked-in"
  },
  {
    "date": "2023-03-20 14:35:21",
    "headline": "Nasdaq Leaps Back to the Forefront",
    "url": "https://www.gurufocus.com/news/1966193/nasdaq-leaps-back-to-the-forefront"
  },
  {
    "date": "2023-03-17 11:13:05",
    "headline": "2 AI Stocks Poised to Benefit From Industry Exuberance",
    "url": "https://www.gurufocus.com/news/1964864/2-ai-stocks-poised-to-benefit-from-industry-exuberance"
  },
  {
    "date": "2023-03-16 03:24:57",
    "headline": "Snap Stock: Can AI and AR Innovations Spark Share Snap-Back?",
    "url": "https://www.gurufocus.com/news/1964537/snap-stock-can-ai-and-ar-innovations-spark-share-snapback"
  },
  {
    "date": "2023-03-15 10:31:01",
    "headline": "A Positive Growth Outlook for Amazon",
    "url": "https://www.gurufocus.com/news/1964435/a-positive-growth-outlook-for-amazon"
  },
  {
    "date": "2023-03-13 10:39:12",
    "headline": "Apple Has Value Beyond AI",
    "url": "https://www.gurufocus.com/news/1964162/apple-has-value-beyond-ai"
  },
  {
    "date": "2023-03-08 11:20:22",
    "headline": "Meta Platforms: A Top 4th-Quarter Guru Stock Pick",
    "url": "https://www.gurufocus.com/news/1963415/meta-platforms-a-top-4thquarter-guru-stock-pick"
  },
  {
    "date": "2023-03-08 11:12:26",
    "headline": "Nvidia: Leading the New Digital Era",
    "url": "https://www.gurufocus.com/news/1963414/nvidia-leading-the-new-digital-era"
  },
  {
    "date": "2023-03-06 21:38:49",
    "headline": "Top Holdings of Conference Speaker Brian Yacktman's YCG",
    "url": "https://www.gurufocus.com/news/1963256/top-holdings-of-conference-speaker-brian-yacktmans-ycg"
  },
  {
    "date": "2023-03-06 21:33:41",
    "headline": "Jim Simons' Renaissance Technologies Dumps Microsoft, Home Depot",
    "url": "https://www.gurufocus.com/news/1963255/jim-simons-renaissance-technologies-dumps-microsoft-home-depot"
  },
  {
    "date": "2023-03-06 19:37:05",
    "headline": "2 Stocks These GuruFocus Value Conference Speakers Agree On",
    "url": "https://www.gurufocus.com/news/1963244/2-stocks-these-gurufocus-value-conference-speakers-agree-on"
  },
  {
    "date": "2023-03-06 15:53:17",
    "headline": "Thousands of Stocks, yet Only 11 Sectors",
    "url": "https://www.gurufocus.com/news/1963190/thousands-of-stocks-yet-only-11-sectors"
  },
  {
    "date": "2023-03-06 11:28:09",
    "headline": "Nvidia Could Be the Real Winner in the AI Race",
    "url": "https://www.gurufocus.com/news/1963079/nvidia-could-be-the-real-winner-in-the-ai-race"
  },
  {
    "date": "2023-03-03 00:31:19",
    "headline": "The Most-Sold Guru Stocks of the 4th Quarter",
    "url": "https://www.gurufocus.com/news/1962175/the-mostsold-guru-stocks-of-the-4th-quarter"
  },
  {
    "date": "2023-03-02 21:09:03",
    "headline": "Snowflake: The Cheaper, the Better",
    "url": "https://www.gurufocus.com/news/1961923/snowflake-the-cheaper-the-better"
  },
  {
    "date": "2023-03-01 22:00:07",
    "headline": "SMITHBRIDGE ASSET MANAGEMENT INC/DE's Top 5 Buys of the 4th Quarter",
    "url": "https://www.gurufocus.com/news/1960849/smithbridge-asset-management-incdes-top-5-buys-of-the-4th-quarter"
  },
  {
    "date": "2023-02-24 22:00:09",
    "headline": "Top 5 4th Quarter Trades of Union Heritage Capital, LLC",
    "url": "https://www.gurufocus.com/news/1957449/top-5-4th-quarter-trades-of-union-heritage-capital-llc"
  },
  {
    "date": "2023-02-24 14:00:06",
    "headline": "National Pension Service Buys 4, Sells 1 in 4th Quarter",
    "url": "https://www.gurufocus.com/news/1957165/national-pension-service-buys-4-sells-1-in-4th-quarter"
  },
  {
    "date": "2023-02-24 10:55:33",
    "headline": "Netflix: A Turnaround Poised for Growth",
    "url": "https://www.gurufocus.com/news/1957064/netflix-a-turnaround-poised-for-growth"
  },
  {
    "date": "2023-02-22 23:08:17",
    "headline": "Stanley Druckenmiller Buys the Dip on Nvidia, Exits Amazon",
    "url": "https://www.gurufocus.com/news/1955890/stanley-druckenmiller-buys-the-dip-on-nvidia-exits-amazon"
  }
]