{"id":26217275,"url":"https://github.com/janlukasschroeder/eodhistoricaldata-api","last_synced_at":"2025-04-15T22:07:17.566Z","repository":{"id":57226120,"uuid":"162548811","full_name":"janlukasschroeder/eodhistoricaldata-api","owner":"janlukasschroeder","description":null,"archived":false,"fork":false,"pushed_at":"2018-12-24T05:06:43.000Z","size":140,"stargazers_count":9,"open_issues_count":1,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-29T02:02:50.504Z","etag":null,"topics":["api","bonds","earnings","equities","etf","etf-holdings","financial-analysis","financial-data","financials","fundamental-analysis","mutual-fund","options","stock-prices","stocks","valuation"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/janlukasschroeder.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-12-20T08:23:29.000Z","updated_at":"2022-09-20T08:21:22.000Z","dependencies_parsed_at":"2022-08-24T11:00:31.553Z","dependency_job_id":null,"html_url":"https://github.com/janlukasschroeder/eodhistoricaldata-api","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/janlukasschroeder%2Feodhistoricaldata-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/janlukasschroeder%2Feodhistoricaldata-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/janlukasschroeder%2Feodhistoricaldata-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/janlukasschroeder%2Feodhistoricaldata-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/janlukasschroeder","download_url":"https://codeload.github.com/janlukasschroeder/eodhistoricaldata-api/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248721465,"owners_count":21151101,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","bonds","earnings","equities","etf","etf-holdings","financial-analysis","financial-data","financials","fundamental-analysis","mutual-fund","options","stock-prices","stocks","valuation"],"created_at":"2025-03-12T12:26:20.227Z","updated_at":"2025-04-15T22:07:17.267Z","avatar_url":"https://github.com/janlukasschroeder.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# eodhistoricaldata.com API (React, Vue, Angular, Node.js)\n\n[eodhistoricaldata.com](https://eodhistoricaldata.com) API wrapper.\n\nSupports client-side (React, Vue, Angular, etc.) and server-side (Node.js).\n\n# Getting Started\n\n- `npm install eodhistoricaldata-api`\n- No API token required\n\n# Examples\n\n## Node.js\n\n```js\nconst api = require('eodhistoricaldata-api');\n\n// get historical end-of-day stock price of Apple\nconst options = {\n  symbol: 'AAPL', // ticker\n  from: '2018-02-01', // YYYY-MM-DD [optional]\n  to: '2018-10-10', // YYYY-MM-DD [optional]\n  period: 'd', // d = day, w = week, m = month [optional]\n  order: 'd' // d = descending, a = ascending [optional]\n  // filter: 'last_close' // last_close, last_volume [optional]\n};\napi.getHistoricalEodData(options).then(prices =\u003e console.log(prices));\n\n// get fundamentals of Tesla (symbol: TSLA)\napi.getFundamentals('TSLA').then(result =\u003e console.log(result));\n\n// list supported ETFs\napi.listSupportedEtfs().then(etfs =\u003e console.log(etfs));\n```\n\n## React\n\nLive Demo: https://codesandbox.io/s/znoo29zp74\n\n```js\nimport api from 'eodhistoricaldata-api';\n\nclass Eodhistoricaldata extends React.Component {\n  componentDidMount() {\n    api.getFundamentals('VGT').then(data =\u003e this.setState({ data }));\n  }\n\n  render() {\n    // ...\n    return \u003cpre\u003e{JSON.stringify(this.state.data, null, 1)}\u003c/pre\u003e;\n  }\n}\n```\n\n# Documentation\n\n## getHistoricalEodData(options)\n\nReturns historical stock price data.\n\nAccepts an object as input:\n\n- `symbol` (string, required) - any symbol of a company, ETF, or Mutual Fund\n- `from` (string, optional) - YYYY-MM-DD format, e.g. `2018-02-01`\n- `to` (string, optional) - YYYY-MM-DD format, e.g. `2018-10-01`\n- `period` (string, optional) - use `d` for daily, `w` for weekly and `m`\n  for monthly prices. By default daily prices will be shown.\n- `order` (string, optional): use `a` for ascending dates (from old to new) and `d` for\n  descending dates (from new to old). By default dates are shown in ascending order.\n- `filter` (string, optional) - use `last_close` to get only the last value,\n  or `last_volume`\n\n## getFundamentals(symbol)\n\n- `symbol` - any symbol of a company, ETF, or Mutual Fund\n\n```js\napi.getFundamentals('AAPL').then(data =\u003e ... )\n```\n\nReturns company, ETF, and Mutual Fund fundamentals.\n\n#### Company Fundamentals\n\n- Code and name of the company.\n- Exchange, currency, and country information.\n- Sector/industry and company description.\n- ISIN and CUSIP of the asset.\n- General Information:\n  - Market Capitalization\n  - EBITDA, PE ratio, PEG ratio.\n  - Earnings per share (EPS), book value, dividend share, dividend yield.\n  - Profit margin, operating margin, return on assets and return on equity.\n  - Revenue, revenue per share, gross profit, diluted EPS and quarterly earnings growth (year-over-year).\n- Numbers for Valuation\n  - Trailing PE, Forward PE\n  - Price/Sales\n  - Price/Book Ratio\n  - Enterprise Value/Revenue\n  - Enterprise Value Ebitda\n- Technical Indicators\n  - Beta\n  - 52 Week high/low\n  - 50/200 day moving average\n  - Shares short, short ratio, short ratio percentage.\n- Splits and Dividends\n  - The forward annual dividend rate and yield\n  - Payout ratio.\n  - Dividend date, ex-dividend date.\n  - Last split factor and split date.\n- Outstanding Shares (only US companies):\n  - Date.\n  - Amount of outstanding shares on the date in Millions.\n- Earnings:\n  - History and Trend.\n  - Quarterly and Annual.\n- Financials\n  - Balance Sheet\n  - Cash Flow\n  - Income Statements.\n  - Quarterly and Annual.\n\n#### ETF Fundamentals\n\n- ETF general data.\n  - ISIN, Company Name, and URL.\n  - Current Yield, Dividend Payments information.\n  - Ongoing charge, Average Market Capitalization (in Millions).\n  - Net expense ratio and annual holdings turnover.\n- Technicals\n  - Beta\n  - 52 week high/lows\n  - 50/200 day moving average\n- Breakdowns\n  - Market Capitalization.\n  - Asset Allocation.\n  - World Regions.\n  - Sector Weights.\n  - Top 10 Holdings.\n  - Valuation and Growth Rates for portfolio and compare to the ETF category.\n  - Morning Star Data: Ratio, Category_Benchmark, Sustainability Ratio.\n  - Performance: Volatility, Expected Returns, Sharp Ratio, Returns YTD/3 years/5 years/10 years.\n\n## listSupportedEtfs()\n\n```js\napi.listSupportedEtfs().then(etfs =\u003e ... )\n```\n\nReturns a list of supported ETFs.\n\nExample:\n\n```js\n[\n { 'ETF Code': '3BLR',\n    'Exchange': 'LSE',\n    'Country': 'UK',\n    'ISIN': 'IE00BYTYHS72',\n    'ETF Name': 'Boost Brent Oil 3X Leverage Daily ETP' },\n  { 'ETF Code': '3BRL',\n    'Exchange': 'LSE',\n    'Country': 'UK',\n    'ISIN': 'IE00BYTYHS72',\n    'ETF Name': 'Boost Brent Oil 3X Leverage Daily ETP' },\n  ...\n]\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjanlukasschroeder%2Feodhistoricaldata-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjanlukasschroeder%2Feodhistoricaldata-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjanlukasschroeder%2Feodhistoricaldata-api/lists"}