Node.js/TypeScript SDK for EODHD Financial APIs

npm install eodhd

npm install ws

import { EODHDClient } from 'eodhd';

const client = new EODHDClient({ apiToken: 'YOUR_API_TOKEN' });

// Get historical end-of-day prices
const prices = await client.eod('AAPL.US', { from: '2024-01-01', to: '2024-12-31' });
console.log(prices[0]);
// { date: '2024-01-02', open: 187.15, high: 188.44, low: 183.89, close: 185.64, adjusted_close: 184.53, volume: 82488700 }

// Get live (delayed) stock price
const quote = await client.realTime('AAPL.US');
console.log(`${quote.code}: $${quote.close} (${quote.change_p}%)`);

// Search for stocks
const results = await client.search('Tesla', { limit: 5 });

export EODHD_API_TOKEN=your_token_here

// Token is read from EODHD_API_TOKEN automatically
const client = new EODHDClient({});

const client = new EODHDClient({
  apiToken: 'YOUR_API_TOKEN',
  timeout: 60000,       // 60 seconds
  maxRetries: 3,        // retry up to 3 times on transient errors
});

const eod = await client.eod('AAPL.US', {
  from: '2024-01-01',
  to: '2024-12-31',
  period: 'd', // 'd' (daily), 'w' (weekly), 'm' (monthly)
  order: 'a',  // 'a' (ascending), 'd' (descending)
});

const intraday = await client.intraday('AAPL.US', {
  interval: '5m', // '1m', '5m', '1h'
  from: '1704067200',
  to: '1704153600',
});

// Single ticker
const live = await client.realTime('AAPL.US');

// Multiple tickers in one call
const liveMulti = await client.realTime('AAPL.US', { s: 'MSFT.US,GOOG.US' });

const usQuotes = await client.usQuoteDelayed({ s: 'AAPL,MSFT,GOOG' });

const bulkUs = await client.bulkEod('US', { date: '2024-12-31' });

// Historical dividends
const dividends = await client.dividends('AAPL.US', { from: '2020-01-01' });

// Historical splits
const splits = await client.splits('AAPL.US');

// Historical market capitalization
const marketCap = await client.historicalMarketCap('AAPL.US', { from: '2024-01-01' });

// Full company fundamentals
const fundamentals = await client.fundamentals('AAPL.US');

// Filter specific sections
const general = await client.fundamentals('AAPL.US', { filter: 'General' });
const financials = await client.fundamentals('AAPL.US', { filter: 'Financials' });

// Bulk fundamentals for an exchange
const bulkFund = await client.bulkFundamentals('US', { symbols: 'AAPL,MSFT,GOOG' });

// Company logo (PNG or SVG)
const logoPng = await client.logo('AAPL.US');       // returns ArrayBuffer
const logoSvg = await client.logoSvg('AAPL.US');    // returns ArrayBuffer

// Upcoming earnings
const earnings = await client.calendar.earnings({
  from: '2025-03-01',
  to: '2025-03-31',
  symbols: 'AAPL.US,MSFT.US',
});

// Earnings trends
const trends = await client.calendar.trends({ symbols: 'AAPL.US,MSFT.US' });

// Upcoming IPOs
const ipos = await client.calendar.ipos({ from: '2025-03-01', to: '2025-06-01' });

// Upcoming splits
const calSplits = await client.calendar.splits({ from: '2025-03-01', to: '2025-06-01' });

// Financial news for a ticker
const news = await client.news({ s: 'AAPL.US', limit: 10 });

// Filter by topic tag
const techNews = await client.news({ t: 'technology', limit: 20 });

// Sentiment data over time
const sentiment = await client.sentiments({ s: 'AAPL.US', from: '2025-01-01' });

// Trending keywords from financial news
const weights = await client.newsWordWeights({
  s: 'AAPL.US',
  'filter[date_from]': '2025-01-01',
  'filter[date_to]': '2025-01-31',
});

const sma = await client.technical('AAPL.US', {
  function: 'sma',
  period: 50,
  from: '2025-01-01',
  order: 'a',
});

const rsi = await client.technical('AAPL.US', {
  function: 'rsi',
  period: 14,
  from: '2025-01-01',
});

const bbands = await client.technical('AAPL.US', {
  function: 'bbands',
  period: 20,
  from: '2025-01-01',
});

// Stock screener with financial filters
const screened = await client.screener({
  sort: 'market_capitalization.desc',
  filters: JSON.stringify([['market_capitalization', '>', 1000000000]]),
  limit: 10,
});

// Search stocks, ETFs, funds, bonds, indices, crypto
const results = await client.search('Apple', {
  limit: 10,
  type: 'stock', // 'all', 'stock', 'etf', 'fund', 'bond', 'index', 'crypto'
});

// ID mapping (ISIN, CUSIP, FIGI, LEI, CIK)
const mapped = await client.idMapping({ 'filter[isin]': 'US0378331005' });

// List all supported exchanges
const exchanges = await client.exchanges.list();

// Get tickers for an exchange
const tickers = await client.exchanges.symbols('US', { type: 'common_stock' });

// Exchange details with trading hours
const details = await client.exchanges.details('US');

// Symbol change history
const changes = await client.exchanges.symbolChangeHistory({ from: '2024-01-01' });

// Macroeconomic indicators (GDP, inflation, unemployment, etc.)
const gdp = await client.macroIndicator('USA', { indicator: 'gdp_current_usd' });
const inflation = await client.macroIndicator('USA', { indicator: 'inflation_consumer_prices_annual' });

// Economic events calendar
const events = await client.economicEvents({
  from: '2025-03-01',
  to: '2025-03-31',
  country: 'US',
});

const bills = await client.treasury.billRates({ from: '2025-01-01' });
const yields = await client.treasury.yieldRates({ from: '2025-01-01' });
const longTerm = await client.treasury.longTermRates({ from: '2025-01-01' });
const realYield = await client.treasury.realYieldRates({ from: '2025-01-01' });

const ws = client.websocket('us', ['AAPL', 'TSLA', 'MSFT']);

ws.on('data', (tick) => {
  console.log(`${tick.s}: $${tick.p} x${tick.v} @ ${new Date(tick.t)}`);
});

ws.on('error', (err) => console.error(err));
ws.on('close', () => console.log('Disconnected'));
ws.on('reconnectFailed', () => console.log('All reconnect attempts exhausted'));

// Subscribe/unsubscribe dynamically
ws.subscribe(['GOOG']);
ws.unsubscribe(['TSLA']);

// Close when done
ws.close();

const ws = client.websocket('forex', ['EURUSD', 'GBPUSD'], {
  maxReconnectAttempts: 10,
  reconnectInterval: 5000,
});

const ticks = await client.ticks({ s: 'AAPL', from: 1704067200, to: 1704070800 });

// List underlying symbols with options data
const symbols = await client.marketplace.unicornbay.options.underlyingSymbols({
  'page[limit]': 100,
});

// Options contracts
const contracts = await client.marketplace.unicornbay.options.contracts({
  'filter[underlying_symbol]': 'AAPL',
  'filter[type]': 'call',
  'filter[exp_date_from]': '2025-06-01',
  'page[limit]': 50,
});

// Options EOD data
const optionsEod = await client.marketplace.unicornbay.options.eod({
  'filter[underlying_symbol]': 'AAPL',
  'filter[exp_date_eq]': '2025-06-20',
});

// List all S&P/Dow Jones indices
const indices = await client.marketplace.unicornbay.spglobal.list();

// Index components (current)
const components = await client.marketplace.unicornbay.spglobal.components('GSPC.INDX');

// Historical components
const historical = await client.marketplace.unicornbay.spglobal.components('GSPC.INDX', {
  historical: true,
  from: '2024-01-01',
  to: '2024-12-31',
});

const markets = await client.marketplace.tradinghours.markets();
const details = await client.marketplace.tradinghours.details({ market: 'US.NASDAQ' });
const status = await client.marketplace.tradinghours.status({ market: 'US.NASDAQ' });
const lookup = await client.marketplace.tradinghours.lookup({ 'filter[symbol]': 'AAPL' });

// Equity risk scoring
const equityRisk = await client.marketplace.praams.analyseEquityByTicker('AAPL.US');

// Bond analysis
const bondAnalysis = await client.marketplace.praams.analyseBond('US912828Z880');

// Smart equity screener
const equities = await client.marketplace.praams.exploreEquity(
  { skip: 0, take: 20 },
  { regions: ['North America'], sectors: ['Technology'] },
);

const companies = await client.marketplace.investverte.companies();
const esg = await client.marketplace.investverte.esg('AAPL.US', { year: 2024 });
const countryEsg = await client.marketplace.investverte.country('US');
const sectorEsg = await client.marketplace.investverte.sector('Technology');

import {
  EODHDClient,
  EODHDError,
  EODHDAuthError,
  EODHDRateLimitError,
} from 'eodhd';

try {
  const data = await client.eod('INVALID.XX');
} catch (err) {
  if (err instanceof EODHDRateLimitError) {
    console.log('Rate limited, retry after:', err.retryAfter);
  } else if (err instanceof EODHDAuthError) {
    console.log('Check your API token');
  } else if (err instanceof EODHDError) {
    console.log(err.statusCode);  // HTTP status code
    console.log(err.code);        // 'auth_error' | 'rate_limit' | 'network_error' | ...
    console.log(err.retryable);   // boolean
  }
}

import {
  EODHDClient,
  EodDataPoint,
  RealTimeQuote,
  SearchResult,
  FundamentalsData,
  NewsArticle,
} from 'eodhd';

const client = new EODHDClient({ apiToken: 'YOUR_API_TOKEN' });

const prices: EodDataPoint[] = await client.eod('AAPL.US');
const quote: RealTimeQuote = await client.realTime('AAPL.US');
const results: SearchResult[] = await client.search('Apple');
const fund: FundamentalsData = await client.fundamentals('AAPL.US');
const news: NewsArticle[] = await client.news({ s: 'AAPL.US' });