{"id":7210,"date":"2026-11-12T13:23:33","date_gmt":"2026-11-12T13:23:33","guid":{"rendered":"https:\/\/eodhd.com\/financial-academy\/?p=7210"},"modified":"2026-11-12T13:41:35","modified_gmt":"2026-11-12T13:41:35","slug":"run-eodhd-open-source-market-data-apps","status":"publish","type":"post","link":"https:\/\/eodhd.com\/financial-academy\/building-stocks-apps-examples\/run-eodhd-open-source-market-data-apps","title":{"rendered":"How to Run EODHD’s Seven Open-Source Market Data Apps on Your Own API Key"},"content":{"rendered":"\n

EODHD APIs has published seven of the screens of EODHD Terminal as open-source apps on GitHub: a stock screener, an options explorer, a portfolio tracker, a news and sentiment feed, a market heatmap, an index constituents browser and a market calendar. Each one is a small Node project that you start on your laptop with your own EODHD API key. This guide walks through the setup, the plan each app needs, the messages you will see when a key or a limit gets in the way, and where to change the code when you want the app to do something else.<\/p>\n\n\n\n

\n

In short.<\/strong> The seven apps are MIT-licensed and live under the EodHistoricalData organisation on GitHub. Any of them starts with four commands and Node 20 or later. Your key goes into a .env file and a local server adds it to each request, so the key never reaches the browser. News & Sentiment and the positions in Portfolio Tracker run on the free EODHD plan; the other apps need a paid plan or an add-on, listed below. AI analysis is optional and works with any OpenAI-compatible endpoint, including a local Ollama.<\/p>\n<\/blockquote>\n\n\n\n

Register & Get Data<\/span><\/a><\/p>\n\n\n\n

<\/p>\n\n\n\n

<\/div>\n\n\n\n

The seven EODHD open-source apps and their repositories<\/h2>\n\n\n\n

Each of the EODHD open-source apps copies a screen people already use in EODHD Terminal<\/a> and keeps the code that makes that screen work: the key handling, the caching, the wait after a rate limit and the plan checks. So here is what each one shows.<\/p>\n\n\n\n

Stock Screener<\/h3>\n\n\n\n

eodhd-screener<\/a> filters and sorts stocks from several exchanges on fields such as market capitalisation, price-to-earnings, dividend yield and sector. It starts on a page of ready-made screens sorted by theme, so you can see results before you build a filter of your own.<\/p>\n\n\n\n

\"EODHD
The screener opens on themed presets; here the Dividend Earners results, largest companies first.<\/figcaption><\/figure>\n\n\n\n

Options Explorer<\/h3>\n\n\n\n

eodhd-options-explorer<\/a> opens the options chain of a US stock with Greeks, gamma exposure by strike, the gamma flip, an implied volatility surface and an unusual activity view. The Options Data API developer guide<\/a> explains the endpoints it reads.<\/p>\n\n\n\n

\"EODHD
Gamma exposure for AAPL: the total, the flip level and the exposure at each strike.<\/figcaption><\/figure>\n\n\n\n

Portfolio Tracker<\/h3>\n\n\n\n

eodhd-portfolio-tracker<\/a> records holdings and transactions, prices them with live quotes (delayed 15 to 20 minutes for stocks), and adds Performance, Research, Tax and Macro tabs. Positions can come from a CSV file, and on a plan with fundamentals a new portfolio can start from a real fund’s allocation. Portfolios stay in the browser’s own storage.<\/p>\n\n\n\n

\"EODHD
A five-stock portfolio priced live, with day and total P&L, weights and sector allocation.<\/figcaption><\/figure>\n\n\n\n

News & Sentiment<\/h3>\n\n\n\n

eodhd-news-sentiment<\/a> pairs a financial news feed with EODHD’s sentiment scores: one gauge for the tracked tickers together, a 30-day line for each ticker, and a ranking of the tickers the news mentions most.<\/p>\n\n\n\n

\"EODHD
Sentiment for AAPL, MSFT and NVDA: a combined gauge, a 30-day line per ticker and the most mentioned names.<\/figcaption><\/figure>\n\n\n\n

Market Heatmap<\/h3>\n\n\n\n

eodhd-heatmap<\/a> draws an index such as the S&P 500 as a treemap grouped by sector: the size of a tile is the company’s market cap, the colour is its move today, and the biggest movers are listed under the map.<\/p>\n\n\n\n

\"EODHD
The S&P 500 as a treemap: sectors as blocks, tile size by market cap, colour by today\u2019s move.<\/figcaption><\/figure>\n\n\n\n

Index Constituents<\/h3>\n\n\n\n

eodhd-index-constituents<\/a> lists the members of about 110 US S&P and Dow Jones indices with their weight, sector and industry, and filters them by sector or by a minimum weight.<\/p>\n\n\n\n

\"EODHD
All 504 S&P 500 members sorted by index weight, with the sector split above the table.<\/figcaption><\/figure>\n\n\n\n

Market Calendar<\/h3>\n\n\n\n

eodhd-calendar<\/a> shows a month of earnings, dividends, splits, IPOs and economic events at a glance; every day lists its event count and its biggest reporting company. The feeds behind it are covered in the Economic and Earnings Calendar API guide<\/a>.<\/p>\n\n\n\n

\"EODHD
One month of corporate and economic events, with the count and the main reporter for each day.<\/figcaption><\/figure>\n\n\n\n
<\/div>\n\n\n\n

What you need before you start<\/h2>\n\n\n\n

To run the EODHD open-source apps you need three things: Node 20 or later (we test the apps in current Chrome and Firefox on Node 20 and 24), Git, and an EODHD API key. A free key comes with a free EODHD APIs account<\/a>. The free plan gives 20 API calls a day, whereas every paid plan gives 100,000. The table shows which data each app reads and what its first load costs in API calls, as measured for the apps’ READMEs. Plan availability follows the EODHD documentation as of November 2026.<\/p>\n\n\n\n

App<\/th>Data it needs<\/th>First load<\/th><\/tr><\/thead>
Portfolio Tracker<\/td>Live (delayed) quotes on any plan, including free; fund templates need fundamentals (All-In-One or Fundamentals Data Feed)<\/td>0 calls until you add positions, then 1 per position; 10 per fund template<\/td><\/tr>
News & Sentiment<\/td>News and sentiment, any plan including free<\/td>5 calls on the free plan, 15 on a paid plan<\/td><\/tr>
Market Heatmap<\/td>Index fundamentals plus live quotes: All-In-One (the Fundamentals Data Feed has no live quotes)<\/td>About 16 calls, about 46 while the US market is open<\/td><\/tr>
Stock Screener<\/td>Screener API: All-In-One or EOD+Intraday All World Extended<\/td>0 calls to open, 10 per US screen<\/td><\/tr>
Options Explorer<\/td>US Stock Options Data API add-on<\/td>0 calls to open, 40 to 70 per large chain from the add-on’s allowance<\/td><\/tr>
Index Constituents<\/td>S&P and Dow Jones index data add-on on the EODHD Marketplace<\/td>8 to 10 calls, plus 10 per index from the add-on’s allowance<\/td><\/tr>
Market Calendar<\/td>Calendar feeds: All-In-One, Fundamentals Data Feed or the Corporate Events Calendar & News Feed; ranking each day’s companies needs the Screener API, so the full view runs on All-In-One<\/td>About 90 to 115 calls, cached until midnight<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

So if you are on the free plan, start with News & Sentiment or with Portfolio Tracker for your own positions, because both stay well inside 20 calls a day. For the whole set, All-In-One covers five of the seven apps; the options chain and the index members are add-ons on top of any plan.<\/p>\n\n\n\n

<\/div>\n\n\n\n

Install and start an app<\/h2>\n\n\n\n

The steps are the same for all seven EODHD open-source apps, and only the repository name changes. For example, with the portfolio tracker:<\/p>\n\n\n\n

\n
\n \n
git clone https:\/\/github.com\/EodHistoricalData\/eodhd-portfolio-tracker\ncd eodhd-portfolio-tracker\nnpm ci                    # installs exactly what package-lock.json pins\ncp .env.example .env      # Windows cmd: copy .env.example .env<\/code><\/pre>\n\n                <\/div>\n                
\n