The Journalism Library (finance)

Useful TypeScript functions for financial calculations and data fetching in journalism projects. Part of the journalism library.

The library is maintained by Nael Shiab, computational journalist and senior data producer for CBC News.

Installation

npm install @nshiab/journalism-finance
Copy

import { getYahooFinanceData } from "@nshiab/journalism-finance";

const prices = await getYahooFinanceData(
  "AAPL",
  new Date("2025-03-13"),
  new Date("2025-03-14"),
  "close",
  "1d",
);
console.log(prices);
Copy

For browser applications, import browser-safe calculations from @nshiab/journalism-finance/web with your JavaScript bundler.

import { adjustToInflation } from "@nshiab/journalism-finance/web";

const adjustedAmount = adjustToInflation(100, 120, 150);
console.log(adjustedAmount); // 125
Copy

To start a data project with folders, configuration and documentation for AI agents, run:

npx @nshiab/setup-data-project
Copy

Documentation

• Documentation
• llms.txt — Documentation index for AI agents
• llm.md — Complete Markdown reference, for AI assistants or offline reading
• npm package

See CONTRIBUTING.md for development commands.