nse-bse-api 0.1.0

package/dist-cjs/bse/utils/throttle.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Throttle = void 0;
+const throttleConfig = {
+    lookup: {
+        rps: 15,
+        delay: Math.ceil(1000 / 15), // ~67ms between requests
+    },
+    default: {
+        rps: 8,
+        delay: Math.ceil(1000 / 8), // 125ms between requests
+    },
+};
+// Simple delay function
+const delay = (ms) => new Promise(resolve => setTimeout(resolve, Math.max(0, ms)));
+// Track last request times
+let lastDefaultRequest = 0;
+let lastLookupRequest = 0;
+class Throttle {
+    static async check(type = 'default') {
+        const now = Date.now();
+        const config = throttleConfig[type];
+        if (type === 'lookup') {
+            const timeSinceLastRequest = now - lastLookupRequest;
+            const waitTime = config.delay - timeSinceLastRequest;
+            if (waitTime > 0) {
+                await delay(waitTime);
+            }
+            lastLookupRequest = Date.now();
+        }
+        else {
+            const timeSinceLastRequest = now - lastDefaultRequest;
+            const waitTime = config.delay - timeSinceLastRequest;
+            if (waitTime > 0) {
+                await delay(waitTime);
+            }
+            lastDefaultRequest = Date.now();
+        }
+    }
+}
+exports.Throttle = Throttle;
+//# sourceMappingURL=throttle.js.map

package/dist-cjs/bse/utils/throttle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.js","sourceRoot":"","sources":["../../../src/bse/utils/throttle.ts"],"names":[],"mappings":";;;AAWA,MAAM,cAAc,GAAmB;IACrC,MAAM,EAAE;QACN,GAAG,EAAE,EAAE;QACP,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC,EAAE,yBAAyB;KACvD;IACD,OAAO,EAAE;QACP,GAAG,EAAE,CAAC;QACN,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE,yBAAyB;KACtD;CACF,CAAC;AAEF,wBAAwB;AACxB,MAAM,KAAK,GAAG,CAAC,EAAU,EAAiB,EAAE,CAC1C,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;AAE/D,2BAA2B;AAC3B,IAAI,kBAAkB,GAAG,CAAC,CAAC;AAC3B,IAAI,iBAAiB,GAAG,CAAC,CAAC;AAE1B,MAAa,QAAQ;IACnB,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAA6B,SAAS;QACvD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;QAEpC,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,MAAM,oBAAoB,GAAG,GAAG,GAAG,iBAAiB,CAAC;YACrD,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,GAAG,oBAAoB,CAAC;YAErD,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;gBACjB,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAC;YACxB,CAAC;YAED,iBAAiB,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACjC,CAAC;aAAM,CAAC;YACN,MAAM,oBAAoB,GAAG,GAAG,GAAG,kBAAkB,CAAC;YACtD,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,GAAG,oBAAoB,CAAC;YAErD,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;gBACjB,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAC;YACxB,CAAC;YAED,kBAAkB,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAClC,CAAC;IACH,CAAC;CACF;AAzBD,4BAyBC"}

package/dist-cjs/index.js

@@ -0,0 +1,54 @@
+"use strict";
+/**
+ * NSE-BSE API - Unified TypeScript API for NSE and BSE India stock exchanges
+ *
+ * This package provides separate APIs for NSE and BSE while maintaining
+ * their individual functionality and keeping them isolated.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BSEApi = exports.NSEApi = exports.NSEClient = exports.BSE = exports.NSE = void 0;
+// Main exports for convenience
+var index_js_1 = require("./nse/index.js");
+Object.defineProperty(exports, "NSE", { enumerable: true, get: function () { return index_js_1.NSEClient; } });
+var index_js_2 = require("./bse/index.js");
+Object.defineProperty(exports, "BSE", { enumerable: true, get: function () { return index_js_2.BSE; } });
+// Named exports for specific usage
+var index_js_3 = require("./nse/index.js");
+Object.defineProperty(exports, "NSEClient", { enumerable: true, get: function () { return index_js_3.NSEClient; } });
+// Export namespaced APIs to avoid conflicts
+exports.NSEApi = __importStar(require("./nse/index.js"));
+exports.BSEApi = __importStar(require("./bse/index.js"));
+//# sourceMappingURL=index.js.map

package/dist-cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,+BAA+B;AAC/B,2CAAkD;AAAzC,+FAAA,SAAS,OAAO;AACzB,2CAAqC;AAA5B,+FAAA,GAAG,OAAA;AAEZ,mCAAmC;AACnC,2CAA2C;AAAlC,qGAAA,SAAS,OAAA;AAElB,4CAA4C;AAC5C,yDAAyC;AACzC,yDAAyC"}

package/dist-cjs/nse/api/corporate-api.js

@@ -0,0 +1,94 @@
+"use strict";
+/**
+ * Corporate actions and announcements API methods for NSE
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CorporateApi = void 0;
+const index_js_1 = require("../constants/index.js");
+const date_formatter_js_1 = require("../utils/date-formatter.js");
+class CorporateApi {
+    httpClient;
+    constructor(httpClient) {
+        this.httpClient = httpClient;
+    }
+    /**
+     * Get corporate actions
+     */
+    async getActions(params = {}) {
+        const query = {
+            index: params.segment ?? "equities",
+        };
+        if (params.symbol)
+            query.symbol = params.symbol;
+        if (params.from_date && params.to_date) {
+            (0, date_formatter_js_1.validateDateRange)(params.from_date, params.to_date);
+            query.from_date = (0, date_formatter_js_1.formatDateDMY)(params.from_date);
+            query.to_date = (0, date_formatter_js_1.formatDateDMY)(params.to_date);
+        }
+        return await this.httpClient.request(`${index_js_1.BASE_URL}/corporates-corporateActions`, query);
+    }
+    /**
+     * Get corporate announcements
+     */
+    async getAnnouncements(params = {}) {
+        const query = {
+            index: params.index ?? "equities",
+        };
+        if (params.symbol)
+            query.symbol = params.symbol;
+        if (params.fno)
+            query.fo_sec = true;
+        if (params.from_date && params.to_date) {
+            (0, date_formatter_js_1.validateDateRange)(params.from_date, params.to_date);
+            query.from_date = (0, date_formatter_js_1.formatDateDMY)(params.from_date);
+            query.to_date = (0, date_formatter_js_1.formatDateDMY)(params.to_date);
+        }
+        return await this.httpClient.request(`${index_js_1.BASE_URL}/corporate-announcements`, query);
+    }
+    /**
+     * Get board meetings
+     */
+    async getBoardMeetings(params = {}) {
+        const query = {
+            index: params.index ?? "equities",
+        };
+        if (params.symbol)
+            query.symbol = params.symbol;
+        if (params.fno)
+            query.fo_sec = true;
+        if (params.from_date && params.to_date) {
+            (0, date_formatter_js_1.validateDateRange)(params.from_date, params.to_date);
+            query.from_date = (0, date_formatter_js_1.formatDateDMY)(params.from_date);
+            query.to_date = (0, date_formatter_js_1.formatDateDMY)(params.to_date);
+        }
+        return await this.httpClient.request(`${index_js_1.BASE_URL}/corporate-board-meetings`, query);
+    }
+    /**
+     * Get annual reports
+     */
+    async getAnnualReports(symbol, segment = "equities") {
+        return await this.httpClient.request(`${index_js_1.BASE_URL}/annual-reports`, {
+            index: segment,
+            symbol,
+        });
+    }
+    /**
+     * Get circulars
+     */
+    async getCirculars(params = {}) {
+        const to = params.to_date ?? new Date();
+        const from = params.from_date ?? new Date(to.getTime() - 7 * 86400000);
+        (0, date_formatter_js_1.validateDateRange)(from, to);
+        const query = {
+            from_date: (0, date_formatter_js_1.formatDateDMY)(from),
+            to_date: (0, date_formatter_js_1.formatDateDMY)(to),
+        };
+        if (params.subject)
+            query.sub = params.subject;
+        if (params.dept_code)
+            query.dept = params.dept_code.toUpperCase();
+        return await this.httpClient.request(`${index_js_1.BASE_URL}/circulars`, query);
+    }
+}
+exports.CorporateApi = CorporateApi;
+//# sourceMappingURL=corporate-api.js.map

package/dist-cjs/nse/api/corporate-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"corporate-api.js","sourceRoot":"","sources":["../../../src/nse/api/corporate-api.ts"],"names":[],"mappings":"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"}

package/dist-cjs/nse/api/download-api.js

@@ -0,0 +1,151 @@
+"use strict";
+/**
+ * File download and bhavcopy API methods for NSE
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DownloadApi = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const index_js_1 = require("../constants/index.js");
+const file_operations_js_1 = require("../utils/file-operations.js");
+const date_formatter_js_1 = require("../utils/date-formatter.js");
+class DownloadApi {
+    httpClient;
+    downloadDir;
+    constructor(httpClient, downloadDir) {
+        this.httpClient = httpClient;
+        this.downloadDir = downloadDir;
+    }
+    /**
+     * Download and extract equity bhavcopy
+     */
+    async downloadEquityBhavcopy(date, folder) {
+        const outDir = folder ? (0, file_operations_js_1.getPath)(folder, true) : this.downloadDir;
+        let url;
+        if (date < index_js_1.UDIFF_SWITCH_DATE) {
+            const dateStr = (0, date_formatter_js_1.formatDateArchive)(date);
+            const month = dateStr.substring(2, 5);
+            url = `${index_js_1.ARCHIVE_URL}/content/historical/EQUITIES/${date.getFullYear()}/${month}/cm${dateStr}bhav.csv.zip`;
+        }
+        else {
+            const ymd = (0, date_formatter_js_1.formatDateYMD)(date);
+            url = `${index_js_1.ARCHIVE_URL}/content/cm/BhavCopy_NSE_CM_0_0_0_${ymd}_F_0000.csv.zip`;
+        }
+        const file = await this.httpClient.downloadFile(url, outDir);
+        if (!fs_1.default.existsSync(file)) {
+            fs_1.default.rmSync(file, { force: true });
+            throw new Error(`Failed to download file: ${path_1.default.basename(file)}`);
+        }
+        return await (0, file_operations_js_1.unzipFile)(file, path_1.default.dirname(file));
+    }
+    /**
+     * Download delivery bhavcopy
+     */
+    async downloadDeliveryBhavcopy(date, folder) {
+        const outDir = folder ? (0, file_operations_js_1.getPath)(folder, true) : this.downloadDir;
+        const ddmmyyyy = (0, date_formatter_js_1.formatDateDDMMYYYY)(date);
+        const url = `${index_js_1.ARCHIVE_URL}/products/content/sec_bhavdata_full_${ddmmyyyy}.csv`;
+        const file = await this.httpClient.downloadFile(url, outDir);
+        if (!fs_1.default.existsSync(file)) {
+            fs_1.default.rmSync(file, { force: true });
+            throw new Error(`Failed to download file: ${path_1.default.basename(file)}`);
+        }
+        return file;
+    }
+    /**
+     * Download indices bhavcopy
+     */
+    async downloadIndicesBhavcopy(date, folder) {
+        const outDir = folder ? (0, file_operations_js_1.getPath)(folder, true) : this.downloadDir;
+        const ddmmyyyy = (0, date_formatter_js_1.formatDateDDMMYYYY)(date);
+        const url = `${index_js_1.ARCHIVE_URL}/content/indices/ind_close_all_${ddmmyyyy}.csv`;
+        const file = await this.httpClient.downloadFile(url, outDir);
+        if (!fs_1.default.existsSync(file)) {
+            fs_1.default.rmSync(file, { force: true });
+            throw new Error(`Failed to download file: ${path_1.default.basename(file)}`);
+        }
+        return file;
+    }
+    /**
+     * Download F&O bhavcopy
+     */
+    async downloadFnoBhavcopy(date, folder) {
+        const outDir = folder ? (0, file_operations_js_1.getPath)(folder, true) : this.downloadDir;
+        const ymd = (0, date_formatter_js_1.formatDateYMD)(date);
+        const url = `${index_js_1.ARCHIVE_URL}/content/fo/BhavCopy_NSE_FO_0_0_0_${ymd}_F_0000.csv.zip`;
+        const file = await this.httpClient.downloadFile(url, outDir);
+        if (!fs_1.default.existsSync(file)) {
+            fs_1.default.rmSync(file, { force: true });
+            throw new Error(`Failed to download file: ${path_1.default.basename(file)}`);
+        }
+        return await (0, file_operations_js_1.unzipFile)(file, path_1.default.dirname(file));
+    }
+    /**
+     * Download priceband report
+     */
+    async downloadPricebandReport(date, folder) {
+        const outDir = folder ? (0, file_operations_js_1.getPath)(folder, true) : this.downloadDir;
+        const ddmmyyyy = (0, date_formatter_js_1.formatDateDDMMYYYY)(date);
+        const url = `${index_js_1.ARCHIVE_URL}/content/equities/sec_list_${ddmmyyyy}.csv`;
+        const file = await this.httpClient.downloadFile(url, outDir);
+        if (!fs_1.default.existsSync(file)) {
+            fs_1.default.rmSync(file, { force: true });
+            throw new Error(`Failed to download file: ${path_1.default.basename(file)}`);
+        }
+        return file;
+    }
+    /**
+     * Download PR bhavcopy
+     */
+    async downloadPrBhavcopy(date, folder) {
+        const outDir = folder ? (0, file_operations_js_1.getPath)(folder, true) : this.downloadDir;
+        const ddmmyy = (0, date_formatter_js_1.formatDateDDMMYY)(date);
+        const url = `${index_js_1.ARCHIVE_URL}/archives/equities/bhavcopy/pr/PR${ddmmyy}.zip`;
+        const file = await this.httpClient.downloadFile(url, outDir);
+        if (!fs_1.default.existsSync(file)) {
+            fs_1.default.rmSync(file, { force: true });
+            throw new Error(`Failed to download file: ${path_1.default.basename(file)}`);
+        }
+        return file;
+    }
+    /**
+     * Download CM MII security report
+     */
+    async downloadCmMiiSecurityReport(date, folder) {
+        const outDir = folder ? (0, file_operations_js_1.getPath)(folder, true) : this.downloadDir;
+        const ddmmyyyy = (0, date_formatter_js_1.formatDateDDMMYYYY)(date);
+        const url = `${index_js_1.ARCHIVE_URL}/content/cm/NSE_CM_security_${ddmmyyyy}.csv.gz`;
+        const file = await this.httpClient.downloadFile(url, outDir);
+        if (!fs_1.default.existsSync(file)) {
+            fs_1.default.rmSync(file, { force: true });
+            throw new Error(`Failed to download file: ${path_1.default.basename(file)}`);
+        }
+        return await (0, file_operations_js_1.unzipFile)(file, path_1.default.dirname(file));
+    }
+    /**
+     * Download any document from URL
+     */
+    async downloadDocument(url, folder, extractFiles) {
+        const outDir = folder ? (0, file_operations_js_1.getPath)(folder, true) : this.downloadDir;
+        const file = await this.httpClient.downloadFile(url, outDir);
+        if (!fs_1.default.existsSync(file)) {
+            fs_1.default.rmSync(file, { force: true });
+            throw new Error(`Failed to download file: ${path_1.default.basename(file)}`);
+        }
+        if (path_1.default.extname(file).toLowerCase() === ".zip") {
+            try {
+                return await (0, file_operations_js_1.unzipFile)(file, path_1.default.dirname(file), extractFiles);
+            }
+            catch (e) {
+                fs_1.default.rmSync(file, { force: true });
+                throw new Error(`Failed to extract zip file: ${String(e?.message ?? e)}`);
+            }
+        }
+        return file;
+    }
+}
+exports.DownloadApi = DownloadApi;
+//# sourceMappingURL=download-api.js.map

package/dist-cjs/nse/api/download-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download-api.js","sourceRoot":"","sources":["../../../src/nse/api/download-api.ts"],"names":[],"mappings":"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"}

package/dist-cjs/nse/api/equity-api.js

@@ -0,0 +1,107 @@
+"use strict";
+/**
+ * Equity-related API methods for NSE
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EquityApi = void 0;
+const index_js_1 = require("../constants/index.js");
+class EquityApi {
+    httpClient;
+    constructor(httpClient) {
+        this.httpClient = httpClient;
+    }
+    /**
+     * Get equity metadata information
+     */
+    async getEquityMetaInfo(symbol) {
+        return await this.httpClient.request(`${index_js_1.BASE_URL}/equity-meta-info`, {
+            symbol: symbol.toUpperCase()
+        });
+    }
+    /**
+     * Get quote for equity or derivative
+     */
+    async getQuote(params) {
+        const type = params.type ?? "equity";
+        const url = type === "equity"
+            ? `${index_js_1.BASE_URL}/quote-equity`
+            : `${index_js_1.BASE_URL}/quote-derivative`;
+        const query = { symbol: params.symbol.toUpperCase() };
+        if (params.section) {
+            if (params.section !== "trade_info") {
+                throw new Error("'Section' if specified must be 'trade_info'");
+            }
+            query.section = params.section;
+        }
+        return await this.httpClient.request(url, query);
+    }
+    /**
+     * Get simplified equity quote with OHLC data
+     */
+    async getEquityQuote(symbol) {
+        const q = await this.getQuote({ symbol, type: "equity" });
+        const v = await this.getQuote({ symbol, type: "equity", section: "trade_info" });
+        const open = q.priceInfo?.open;
+        const minmax = q.priceInfo?.intraDayHighLow;
+        const close = q.priceInfo?.close;
+        const ltp = q.priceInfo?.lastPrice;
+        return {
+            date: q.metadata?.lastUpdateTime,
+            open,
+            high: minmax?.max,
+            low: minmax?.min,
+            close: close ?? ltp,
+            volume: v.securityWiseDP?.quantityTraded,
+        };
+    }
+    /**
+     * Filter gainers from market data
+     */
+    getGainers(data, count) {
+        const filtered = data.data
+            .filter((d) => d.pChange > 0)
+            .sort((a, b) => b.pChange - a.pChange);
+        return typeof count === "number" ? filtered.slice(0, count) : filtered;
+    }
+    /**
+     * Filter losers from market data
+     */
+    getLosers(data, count) {
+        const filtered = data.data
+            .filter((d) => d.pChange < 0)
+            .sort((a, b) => a.pChange - b.pChange);
+        return typeof count === "number" ? filtered.slice(0, count) : filtered;
+    }
+    /**
+     * List equity stocks by index
+     */
+    async listEquityStocksByIndex(index = "NIFTY 50") {
+        return await this.httpClient.request(`${index_js_1.BASE_URL}/equity-stockIndices`, { index });
+    }
+    /**
+     * List all indices
+     */
+    async listIndices() {
+        return await this.httpClient.request(`${index_js_1.BASE_URL}/allIndices`);
+    }
+    /**
+     * List ETFs
+     */
+    async listEtf() {
+        return await this.httpClient.request(`${index_js_1.BASE_URL}/etf`);
+    }
+    /**
+     * List SME stocks
+     */
+    async listSme() {
+        return await this.httpClient.request(`${index_js_1.BASE_URL}/live-analysis-emerge`);
+    }
+    /**
+     * List Sovereign Gold Bonds
+     */
+    async listSgb() {
+        return await this.httpClient.request(`${index_js_1.BASE_URL}/sovereign-gold-bonds`);
+    }
+}
+exports.EquityApi = EquityApi;
+//# sourceMappingURL=equity-api.js.map

package/dist-cjs/nse/api/equity-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"equity-api.js","sourceRoot":"","sources":["../../../src/nse/api/equity-api.ts"],"names":[],"mappings":"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"}

package/dist-cjs/nse/api/historical-api.js

@@ -0,0 +1,130 @@
+"use strict";
+/**
+ * Historical data API methods for NSE
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HistoricalApi = void 0;
+const index_js_1 = require("../constants/index.js");
+const date_formatter_js_1 = require("../utils/date-formatter.js");
+class HistoricalApi {
+    httpClient;
+    constructor(httpClient) {
+        this.httpClient = httpClient;
+    }
+    /**
+     * Fetch equity historical data
+     */
+    async fetchEquityHistoricalData(params) {
+        const { symbol, from_date, to_date, series = ["EQ"] } = params;
+        // Simple case - no date range and EQ series only
+        if (!from_date && !to_date && JSON.stringify(series) === JSON.stringify(["EQ"])) {
+            const data = await this.httpClient.request(`${index_js_1.BASE_URL}/historical/cm/equity`, { symbol });
+            return data.data.slice().reverse();
+        }
+        const to = to_date ?? new Date();
+        const from = from_date ?? new Date(to.getTime() - 30 * 86400000);
+        (0, date_formatter_js_1.validateDateRange)(from, to);
+        const chunks = (0, date_formatter_js_1.splitDateRange)(from, to, 100);
+        const results = [];
+        for (const [cFrom, cTo] of chunks) {
+            const data = await this.httpClient.request(`${index_js_1.BASE_URL}/historical/cm/equity`, {
+                symbol,
+                series: JSON.stringify(series),
+                from: (0, date_formatter_js_1.formatDateDMY)(cFrom),
+                to: (0, date_formatter_js_1.formatDateDMY)(cTo),
+            });
+            const arr = data.data.slice().reverse();
+            results.push(...arr);
+        }
+        return results;
+    }
+    /**
+     * Fetch VIX historical data
+     */
+    async fetchHistoricalVixData(params = {}) {
+        const to = params.to_date ?? new Date();
+        const from = params.from_date ?? new Date(to.getTime() - 30 * 86400000);
+        (0, date_formatter_js_1.validateDateRange)(from, to);
+        const chunks = (0, date_formatter_js_1.splitDateRange)(from, to, 365);
+        const data = [];
+        for (const [cFrom, cTo] of chunks) {
+            const result = await this.httpClient.request(`${index_js_1.BASE_URL}/historical/vixhistory`, {
+                from: (0, date_formatter_js_1.formatDateDMY)(cFrom),
+                to: (0, date_formatter_js_1.formatDateDMY)(cTo),
+            });
+            data.push(...result.data);
+        }
+        return data;
+    }
+    /**
+     * Fetch F&O historical data
+     */
+    async fetchHistoricalFnoData(params) {
+        const { symbol, instrument = "FUTIDX", from_date, to_date, expiry, option_type, strike_price } = params;
+        const instrumentType = instrument.toUpperCase();
+        const to = to_date ?? new Date();
+        const from = from_date ?? new Date(to.getTime() - 30 * 86400000);
+        (0, date_formatter_js_1.validateDateRange)(from, to);
+        const query = {
+            instrumentType,
+            symbol: symbol.toUpperCase(),
+        };
+        if (expiry) {
+            query.expiryDate = (0, date_formatter_js_1.formatDateExpiry)(expiry);
+            query.year = expiry.getFullYear();
+        }
+        if (instrumentType === "OPTIDX" || instrumentType === "OPTSTK") {
+            if (!option_type) {
+                throw new Error("`option_type` param is required for Stock or Index options.");
+            }
+            query.optionType = option_type;
+            if (strike_price != null)
+                query.strikePrice = strike_price;
+        }
+        const chunks = (0, date_formatter_js_1.splitDateRange)(from, to, 365);
+        const data = [];
+        for (const [cFrom, cTo] of chunks) {
+            query.from = (0, date_formatter_js_1.formatDateDMY)(cFrom);
+            query.to = (0, date_formatter_js_1.formatDateDMY)(cTo);
+            const result = await this.httpClient.request(`${index_js_1.BASE_URL}/historical/foCPV`, query);
+            data.push(...result.data);
+        }
+        return data;
+    }
+    /**
+     * Fetch index historical data
+     */
+    async fetchHistoricalIndexData(params) {
+        const { index, from_date, to_date } = params;
+        const to = to_date ?? new Date();
+        const from = from_date ?? new Date(to.getTime() - 30 * 86400000);
+        (0, date_formatter_js_1.validateDateRange)(from, to);
+        const chunks = (0, date_formatter_js_1.splitDateRange)(from, to, 365);
+        const result = { price: [], turnover: [] };
+        for (const [cFrom, cTo] of chunks) {
+            const data = await this.httpClient.request(`${index_js_1.BASE_URL}/historical/indicesHistory`, {
+                indexType: index.toUpperCase(),
+                from: (0, date_formatter_js_1.formatDateDMY)(cFrom),
+                to: (0, date_formatter_js_1.formatDateDMY)(cTo),
+            });
+            result.price.push(...data.data.indexCloseOnlineRecords);
+            result.turnover.push(...data.data.indexTurnoverRecords);
+        }
+        return result;
+    }
+    /**
+     * Fetch F&O underlying information
+     */
+    async fetchFnoUnderlying() {
+        const data = await this.httpClient.request(`${index_js_1.BASE_URL}/underlying-information`);
+        return data.data;
+    }
+    /**
+     * Fetch index names
+     */
+    async fetchIndexNames() {
+        return await this.httpClient.request(`${index_js_1.BASE_URL}/index-names`);
+    }
+}
+exports.HistoricalApi = HistoricalApi;
+//# sourceMappingURL=historical-api.js.map

package/dist-cjs/nse/api/historical-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"historical-api.js","sourceRoot":"","sources":["../../../src/nse/api/historical-api.ts"],"names":[],"mappings":"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"}

package/dist-cjs/nse/api/index.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * API modules for NSE client
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DownloadApi = exports.MarketApi = exports.IpoApi = exports.CorporateApi = exports.HistoricalApi = exports.OptionsApi = exports.EquityApi = void 0;
+var equity_api_js_1 = require("./equity-api.js");
+Object.defineProperty(exports, "EquityApi", { enumerable: true, get: function () { return equity_api_js_1.EquityApi; } });
+var options_api_js_1 = require("./options-api.js");
+Object.defineProperty(exports, "OptionsApi", { enumerable: true, get: function () { return options_api_js_1.OptionsApi; } });
+var historical_api_js_1 = require("./historical-api.js");
+Object.defineProperty(exports, "HistoricalApi", { enumerable: true, get: function () { return historical_api_js_1.HistoricalApi; } });
+var corporate_api_js_1 = require("./corporate-api.js");
+Object.defineProperty(exports, "CorporateApi", { enumerable: true, get: function () { return corporate_api_js_1.CorporateApi; } });
+var ipo_api_js_1 = require("./ipo-api.js");
+Object.defineProperty(exports, "IpoApi", { enumerable: true, get: function () { return ipo_api_js_1.IpoApi; } });
+var market_api_js_1 = require("./market-api.js");
+Object.defineProperty(exports, "MarketApi", { enumerable: true, get: function () { return market_api_js_1.MarketApi; } });
+var download_api_js_1 = require("./download-api.js");
+Object.defineProperty(exports, "DownloadApi", { enumerable: true, get: function () { return download_api_js_1.DownloadApi; } });
+//# sourceMappingURL=index.js.map

package/dist-cjs/nse/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/nse/api/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,iDAA4C;AAAnC,0GAAA,SAAS,OAAA;AAClB,mDAA8C;AAArC,4GAAA,UAAU,OAAA;AACnB,yDAAoD;AAA3C,kHAAA,aAAa,OAAA;AACtB,uDAAkD;AAAzC,gHAAA,YAAY,OAAA;AACrB,2CAAsC;AAA7B,oGAAA,MAAM,OAAA;AACf,iDAA4C;AAAnC,0GAAA,SAAS,OAAA;AAClB,qDAAgD;AAAvC,8GAAA,WAAW,OAAA"}