General Data

Exchange List

List worldwide exchanges.

Request

GET /exchange_list

Example

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

Response

{
  "USA": [
    "NAS",
    "NYSE",
    "OTCPK",
    "",
    "OTCBB",
    "AMEX",
    "ARCA",
    "IEXG",
    "BATS",
    "GREY"
  ],
  "Canada": [
    "TSXV",
    "TSX",
    "XCNQ",
    "NEOE"
  ]
}

Stock List in Exchange

Get list of all stocks of a particular exchange.

Request

GET /exchange_stocks/{exchange_name}

Example

GET https://api.gurufocus.com/public/user/{api_token}/exchange_stocks/NYSE

Response

[
  {
    "symbol": "A",
    "exchange": "NYSE",
    "company": "Agilent Technologies Inc",
    "currency": "USD",
    "industry": "Medical Diagnostics & Research",
    "sector": "Healthcare",
    "subindustry": "Diagnostics & Research"
  },
  {
    "symbol": "AA",
    "exchange": "NYSE",
    "company": "Alcoa Corp",
    "currency": "USD",
    "industry": "Metals & Mining",
    "sector": "Basic Materials",
    "subindustry": "Aluminum"
  }
]

Stocks List with Fundamental Data Updated

Get a list of stocks with fundamental data that has been updated since your customized date within a week.

Request

GET /funda_updated/{date}

Example

GET https://api.gurufocus.com/public/user/{api_token}/funda_updated/2019-01-01

Response

[
  "OTCPK:SGTZY",
  "LTS:0RL4",
  "FRA:2ZP",
  "NAS:ELGX",
  "NYSE:LMT",
  "AMEX:CVU",
  "AMEX:UAVS",
  "XTER:WDC",
  "NYSE:GIS",
  "ASX:CSL",
  "LSE:50IT.PFD",
  "NAS:PLCE"
]

Currency Symbol List

Get a list of currency symbol for each country.

Request

GET /country_currency

Example

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

Response

[
  {
    "country": "Argentina",
    "country_ISO": "ARG",
    "currency": "ARS"
  },
  {
    "country": "Australia",
    "country_ISO": "AUS",
    "currency": "AUD"
  },
  {
    "country": "Austria",
    "country_ISO": "AUT",
    "currency": "EUR"
  },
  {
    "country": "Bahrain",
    "country_ISO": "BHR",
    "currency": "BHD"
  },
  {
    "country": "Bangladesh",
    "country_ISO": "BGD",
    "currency": "BDT"
  },
  {
    "country": "Belgium",
    "country_ISO": "BEL",
    "currency": "EUR"
  }
]

Indexs List

List worldwide Indexs.

Request

GET /index_list

Example

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

Response

[
  {
    "name": "S&P/TSX Composite index",
    "symbol": "^GSPTSE"
  },
  {
    "name": "STOXX Europe 600",
    "symbol": "^STOXX"
  },
  {
    "name": "SZSE Component Index",
    "symbol": "SZSE:399001"
  },
  {
    "name": "SSE Composite Index",
    "symbol": "SHSE:000001"
  },
  {
    "name": "CHINEXT Price Index",
    "symbol": "SZSE:399006"
  },
  {
    "name": "CSI 300 Index",
    "symbol": "SHSE:000300"
  },
  {
    "name": "SZSE SME Price Index",
    "symbol": "SZSE:399005"
  },
  {
    "name": "CSI 500 Index",
    "symbol": "SHSE:000905"
  },
  {
    "name": "DAX 40",
    "symbol": "^GDAXI"
  },
  {
    "name": "CAC 40",
    "symbol": "^FCHI"
  },
  {
    "name": "FTSE 100",
    "symbol": "^FTSE"
  },
  {
    "name": "FTSE 250",
    "symbol": "^FTMC"
  },
  {
    "name": "Hang Seng Index",
    "symbol": "^HSI"
  },
  {
    "name": "Hang Seng China Enterprises Index",
    "symbol": "^HSCE"
  },
  {
    "name": "Hong Kong Stock Connect",
    "symbol": "^HKSC"
  },
  {
    "name": "BSE SENSEX",
    "symbol": "^BSESN"
  },
  {
    "name": "NIFTY 50",
    "symbol": "^NSEI"
  },
  {
    "name": "NIFTY 500",
    "symbol": "^CRSLDX"
  },
  {
    "name": "Nikkei 225",
    "symbol": "^N225"
  },
  {
    "name": "KOSPI",
    "symbol": "^KS11"
  },
  {
    "name": "KOSDAQ Composite Index",
    "symbol": "^KQ11"
  },
  {
    "name": "Straits Times Index",
    "symbol": "SGX:^STI"
  },
  {
    "name": "TSEC Weighted Index",
    "symbol": "^TWII"
  },
  {
    "name": "iShares MSCI ACWI Ex US Index Fund",
    "symbol": "NAS:ACWX"
  },
  {
    "name": "Dow 30",
    "symbol": "^DJI"
  },
  {
    "name": "S&P 500",
    "symbol": "^GSPC"
  },
  {
    "name": "Russell 2000",
    "symbol": "^RUT"
  },
  {
    "name": "NASDAQ 100",
    "symbol": "^NDX"
  },
  {
    "name": "China Concepts Stock",
    "symbol": "^CHINACS"
  },
  {
    "name": "NASDAQ Golden Dragon China Index",
    "symbol": "^HXC"
  },
  {
    "name": "Russell 1000",
    "symbol": "^RUI"
  },
  {
    "name": "Russell 3000",
    "symbol": "^RUA"
  }
]

Stock List of index

Get list of all stocks of a particular index.

Request

GET /index_stocks/{index_symbol}?page={page?}

Parameters

• index_symbol Required
  Available index symbol can be found in Indexs List
• page Optional
  Page number of results, default value is 1.

Example

GET https://api.gurufocus.com/public/user/{api_token}/index_stocks/^DJI?page=1

Response

[
  {
    "symbol": "AAPL",
    "exchange": "NAS",
    "company": "Apple Inc",
    "currency": "USD",
    "sector": "Technology",
    "industry": "Hardware",
    "subindustry": "Consumer Electronics"
  },
  {
    "symbol": "AMGN",
    "exchange": "NAS",
    "company": "Amgen Inc",
    "currency": "USD",
    "sector": "Healthcare",
    "industry": "Drug Manufacturers",
    "subindustry": "Drug Manufacturers - General"
  },
  {
    "symbol": "CSCO",
    "exchange": "NAS",
    "company": "Cisco Systems Inc",
    "currency": "USD",
    "sector": "Technology",
    "industry": "Hardware",
    "subindustry": "Communication Equipment"
  },
  {
    "symbol": "INTC",
    "exchange": "NAS",
    "company": "Intel Corp",
    "currency": "USD",
    "sector": "Technology",
    "industry": "Semiconductors",
    "subindustry": "Semiconductors"
  },
  {
    "symbol": "MSFT",
    "exchange": "NAS",
    "company": "Microsoft Corp",
    "currency": "USD",
    "sector": "Technology",
    "industry": "Software",
    "subindustry": "Software - Infrastructure"
  },
  {
    "symbol": "WBA",
    "exchange": "NAS",
    "company": "Walgreens Boots Alliance Inc",
    "currency": "USD",
    "sector": "Healthcare",
    "industry": "Healthcare Providers & Services",
    "subindustry": "Pharmaceutical Retailers"
  },
  {
    "symbol": "AXP",
    "exchange": "NYSE",
    "company": "American Express Co",
    "currency": "USD",
    "sector": "Financial Services",
    "industry": "Credit Services",
    "subindustry": "Credit Services"
  },
  {
    "symbol": "BA",
    "exchange": "NYSE",
    "company": "Boeing Co",
    "currency": "USD",
    "sector": "Industrials",
    "industry": "Aerospace & Defense",
    "subindustry": "Aerospace & Defense"
  },
  {
    "symbol": "CAT",
    "exchange": "NYSE",
    "company": "Caterpillar Inc",
    "currency": "USD",
    "sector": "Industrials",
    "industry": "Farm & Heavy Construction Machinery",
    "subindustry": "Farm & Heavy Construction Machinery"
  },
  {
    "symbol": "CRM",
    "exchange": "NYSE",
    "company": "Salesforce Inc",
    "currency": "USD",
    "sector": "Technology",
    "industry": "Software",
    "subindustry": "Software - Application"
  }
]

Financial Calendars

Get list of stock events and economic events of the day.

Request

GET /calendar?date={date}&type={type?}

Parameters

• date Required
  String of specific date, date string format example: 2024-01-01.
• type Optional
  This optional parameter type defines the stock event type, default value is all.
  options of type:

  • all - All kinds of stock events
  • earnings - Earnings
  • dividends - Dividends
  • split - Stock splits
  • ipo - IPO
  • economic - Economic events

Example

GET https://api.gurufocus.com/public/user/{api_token}/calendar?date=2024-02-05

Response

{
  "economic": [
    {
      "cateName": "Exchange Rates",
      "children": [
        {
          "econ_name": "Canada / U.S. Foreign Exchange Rate",
          "release_date": "2024-02-05",
          "report_frequency": "m"
        },
        {
          "econ_name": "U.S. / Euro Foreign Exchange Rate (EXUSEU)",
          "release_date": "2024-02-05",
          "report_frequency": "m"
        },
        {
          "econ_name": "Japan / U.S. Foreign Exchange Rate (EXJPUS)",
          "release_date": "2024-02-05",
          "report_frequency": "m"
        }
      ]
    }
  ],
  "ipo": [
    {
      "ipo_date": "2024-02-05",
      "symbol": "STI",
      "exchange": "NAS",
      "company": "Solidion Technology Inc",
      "ipo_offer_price": "0.000000",
      "price": "0.700000",
      "return": 0
    }
  ],
  "earning": [
    {
      "symbol": "MCD",
      "exchange": "NYSE",
      "company": "McDonald's Corp",
      "Event": "Fourth quarter earnings results for 2023",
      "EndDateTime": "2024-02-05",
      "EventFiscalYear": 2023
    },
    {
      "symbol": "CAT",
      "exchange": "NYSE",
      "company": "Caterpillar Inc",
      "Event": "Fourth quarter earnings results for 2023",
      "EndDateTime": "2024-02-05",
      "EventFiscalYear": 2023
    },
    {
      "symbol": "VRTX",
      "exchange": "NAS",
      "company": "Vertex Pharmaceuticals Inc",
      "Event": "Fourth quarter earnings results for 2023",
      "EndDateTime": "2024-02-05",
      "EventFiscalYear": 2023
    },
    {
      "symbol": "NXPI",
      "exchange": "NAS",
      "company": "NXP Semiconductors NV",
      "Event": "Fourth quarter earnings results for 2023",
      "EndDateTime": "2024-02-05",
      "EventFiscalYear": 2023
    },
    {
      "symbol": "UNCRY",
      "exchange": "OTCPK",
      "company": "UniCredit SpA",
      "Event": "Fourth quarter earnings results for 2023",
      "EndDateTime": "2024-02-05",
      "EventFiscalYear": 2023
    }
  ],
  "dividend": [
    {
      "symbol": "ASML",
      "exchange": "NAS",
      "company": "ASML Holding NV",
      "DeclarationDate": "2024-01-24",
      "ExDate": "2024-02-05",
      "RecordDate": "2024-02-06",
      "PayDate": "2024-02-14",
      "CashAmount": "1.579",
      "PriceCurrency": "USD",
      "DividendType": "CD",
      "Frequency": 4,
      "yield": "0.73"
    },
    {
      "symbol": "MET",
      "exchange": "NYSE",
      "company": "MetLife Inc",
      "DeclarationDate": "2024-01-09",
      "ExDate": "2024-02-05",
      "RecordDate": "2024-02-06",
      "PayDate": "2024-03-14",
      "CashAmount": "0.520",
      "PriceCurrency": "USD",
      "DividendType": "CD",
      "Frequency": 4,
      "yield": "3.09"
    }
  ],
  "split": [
    {
      "symbol": "GTBP",
      "exchange": "NAS",
      "company": "GT Biopharma Inc",
      "date": "2024-02-05",
      "ratio": 0.0333333,
      "adjusted": 1
    },
    {
      "symbol": "WSCO",
      "exchange": "OTCPK",
      "company": "Global AI Inc",
      "date": "2024-02-05",
      "ratio": 4,
      "adjusted": 1
    }
  ]
}