@nepse-toolkit/core

Core data models, provider abstraction, and utilities for Nepal Stock Exchange (NEPSE).

Part of the nepse-toolkit monorepo.

Features

• Data models — TypeScript types for stocks, quotes, OHLCV, market data, sectors, floorsheet, IPO
• NEPSE provider — Official NEPSE API client with WASM-based token authentication and auto-refresh
• MeroLagani provider — Fallback provider for historical OHLCV and market summary (no auth required)
• Provider manager — Multi-provider failover with health checking (3 failures = unhealthy, auto-heal after cooldown)
• HTTP client — Built on undici with TLS handling for NEPSE's API
• Nepali date utils — Bikram Sambat ↔ AD conversion, NEPSE fiscal year/quarter awareness

Install

npm install @nepse-toolkit/core

Usage

import {
  NepseProvider,
  MeroLaganiProvider,
  ProviderManager,
} from "@nepse-toolkit/core";

// Single provider
const nepse = new NepseProvider();
const quote = await nepse.getStockQuote("NABIL");

// Multi-provider with failover
const manager = new ProviderManager([
  new NepseProvider(),
  new MeroLaganiProvider(),
]);
const stocks = await manager.execute((p) => p.getStockList());

License

MIT