@fugle/node-twstock 2.2.1-alpha.0

package/lib/scrapers/taifex-scraper.js

@@ -0,0 +1,406 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TaifexScraper = void 0;
+const cheerio = require("cheerio");
+const csvtojson = require("csvtojson");
+const iconv = require("iconv-lite");
+const numeral = require("numeral");
+const luxon_1 = require("luxon");
+const enums_1 = require("../enums");
+const scraper_1 = require("./scraper");
+class TaifexScraper extends scraper_1.Scraper {
+    async fetchListedStockFutOpt() {
+        const url = 'https://www.taifex.com.tw/cht/2/stockLists';
+        const response = await this.httpService.get(url);
+        const $ = cheerio.load(response.data);
+        const list = $('#myTable tbody tr').map((_, el) => {
+            const td = $(el).find('td');
+            return {
+                symbol: td.eq(0).text().trim(),
+                underlyingStock: td.eq(1).text().trim(),
+                underlyingSymbol: td.eq(2).text().trim(),
+                underlyingName: td.eq(3).text().trim(),
+                hasFutures: td.eq(4).text().includes('是股票期貨標的'),
+                hasOptions: td.eq(5).text().includes('是股票選擇權標的'),
+                isTwseStock: td.eq(6).text().includes('是上市普通股標的證券'),
+                isTpexStock: td.eq(7).text().includes('是上櫃普通股標的證券'),
+                isTwseETF: td.eq(8).text().includes('是上市ETF標的證券'),
+                isTpexETF: td.eq(9).text().includes('是上櫃ETF標的證券'),
+                shares: numeral(td.eq(10).text()).value(),
+            };
+        }).toArray();
+        const data = list.reduce((data, row) => {
+            const isMicro = (row.shares === 100);
+            const futures = {
+                symbol: `${row.symbol}F`,
+                name: `${isMicro ? '小型' : ''}${row.underlyingName}期貨`,
+                exchange: enums_1.Exchange.TAIFEX,
+                type: '股票期貨',
+                underlyingSymbol: row.underlyingSymbol,
+                underlyingName: row.underlyingName,
+            };
+            const options = {
+                symbol: `${row.symbol}O`,
+                name: `${isMicro ? '小型' : ''}${row.underlyingName}選擇權`,
+                exchange: enums_1.Exchange.TAIFEX,
+                type: '股票選擇權',
+                underlyingName: row.underlyingName,
+                underlying: row.underlyingSymbol,
+            };
+            if (row.hasFutures)
+                data.push(futures);
+            if (row.hasOptions)
+                data.push(options);
+            return data;
+        }, []);
+        return data;
+    }
+    async fetchFuturesHistorical(options) {
+        const { date, symbol, afterhours } = options;
+        const alias = {
+            'TX': 'TXF',
+            'TE': 'EXF',
+            'TF': 'FXF',
+            'MTX': 'MXF', // 小型臺指期貨
+        };
+        const queryDate = luxon_1.DateTime.fromISO(date).toFormat('yyyy/MM/dd');
+        const form = new URLSearchParams({
+            down_type: '1',
+            queryStartDate: queryDate,
+            queryEndDate: queryDate,
+            commodity_id: 'all',
+        });
+        const url = 'https://www.taifex.com.tw/cht/3/futDataDown';
+        const response = await this.httpService.post(url, form, { responseType: 'arraybuffer' });
+        const csv = iconv.decode(response.data, 'big5');
+        const json = await csvtojson({ noheader: true, output: 'csv' }).fromString(csv);
+        const [_, ...rows] = json;
+        if (!rows.length)
+            return null;
+        const data = rows.map(row => {
+            var _a;
+            const [date, contract, contractMonth, ...values] = row;
+            const data = {};
+            data.date = luxon_1.DateTime.fromFormat(date, 'yyyy/MM/dd').toISODate();
+            data.exchange = enums_1.Exchange.TAIFEX;
+            data.symbol = (_a = alias[contract]) !== null && _a !== void 0 ? _a : contract;
+            data.contractMonth = contractMonth;
+            data.open = numeral(values[0]).value();
+            data.high = numeral(values[1]).value();
+            data.low = numeral(values[2]).value();
+            data.close = numeral(values[3]).value();
+            data.change = numeral(values[4]).value();
+            data.changePercent = numeral(values[5].replace('%', '')).value();
+            data.volume = numeral(values[6]).value();
+            data.settlementPrice = numeral(values[7]).value();
+            data.openInterest = numeral(values[8]).value();
+            data.bestBid = numeral(values[9]).value();
+            data.bestAsk = numeral(values[10]).value();
+            8;
+            data.historicalHigh = numeral(values[11]).value();
+            data.historicalLow = numeral(values[12]).value();
+            data.session = values[14];
+            data.volumeSpread = numeral(values[15]).value();
+            return data;
+        }).filter(row => afterhours ? row.session === '盤後' : row.session === '一般');
+        return symbol ? data.filter(data => data.symbol === symbol) : data;
+    }
+    async fetchOptionsHistorical(options) {
+        const { date, symbol, afterhours } = options;
+        const queryDate = luxon_1.DateTime.fromISO(date).toFormat('yyyy/MM/dd');
+        const form = new URLSearchParams({
+            down_type: '1',
+            queryStartDate: queryDate,
+            queryEndDate: queryDate,
+            commodity_id: 'all',
+        });
+        const url = 'https://www.taifex.com.tw/cht/3/optDataDown';
+        const response = await this.httpService.post(url, form, { responseType: 'arraybuffer' });
+        const csv = iconv.decode(response.data, 'big5');
+        const json = await csvtojson({ noheader: true, output: 'csv' }).fromString(csv);
+        const [_, ...rows] = json;
+        if (!rows.length)
+            return null;
+        const data = rows.map(row => {
+            const [date, contract, contractMonth, strikePrice, type, ...values] = row;
+            const data = {};
+            data.date = luxon_1.DateTime.fromFormat(date, 'yyyy/MM/dd').toISODate();
+            data.exchange = enums_1.Exchange.TAIFEX;
+            data.symbol = contract;
+            data.contractMonth = contractMonth;
+            data.strikePrice = numeral(strikePrice).value();
+            data.type = type;
+            data.open = numeral(values[0]).value();
+            data.high = numeral(values[1]).value();
+            data.low = numeral(values[2]).value();
+            data.close = numeral(values[3]).value();
+            data.volume = numeral(values[4]).value();
+            data.settlementPrice = numeral(values[5]).value();
+            data.openInterest = numeral(values[6]).value();
+            data.bestBid = numeral(values[7]).value();
+            data.bestAsk = numeral(values[8]).value();
+            data.historicalHigh = numeral(values[9]).value();
+            data.historicalLow = numeral(values[10]).value();
+            data.session = values[12];
+            data.change = numeral(values[13]).value();
+            data.changePercent = numeral(values[14].replace('%', '')).value();
+            return data;
+        }).filter(row => afterhours ? row.session === '盤後' : row.session === '一般');
+        return symbol ? data.filter(data => data.symbol === symbol) : data;
+    }
+    async fetchFuturesInstitutional(options) {
+        const { date, symbol } = options;
+        const queryDate = luxon_1.DateTime.fromISO(date).toFormat('yyyy/MM/dd');
+        const form = new URLSearchParams({
+            queryStartDate: queryDate,
+            queryEndDate: queryDate,
+            commodityId: symbol,
+        });
+        const url = 'https://www.taifex.com.tw/cht/3/futContractsDateDown';
+        const response = await this.httpService.post(url, form, { responseType: 'arraybuffer' });
+        if (response.data.toString().includes('查無資料'))
+            return null;
+        if (response.data.toString().includes('日期時間錯誤'))
+            return null;
+        const csv = iconv.decode(response.data, 'big5');
+        const json = await csvtojson({ noheader: true, output: 'csv' }).fromString(csv);
+        const [_, ...rows] = json;
+        const data = {};
+        data.date = date,
+            data.exchange = enums_1.Exchange.TAIFEX;
+        data.symbol = symbol;
+        data.name = rows[0][1];
+        data.institutional = rows.map(row => ({
+            investor: row[2],
+            longTradeVolume: numeral(row[3]).value(),
+            longTradeValue: numeral(row[4]).value(),
+            shortTradeVolume: numeral(row[5]).value(),
+            shortTradeValue: numeral(row[6]).value(),
+            netTradeVolume: numeral(row[7]).value(),
+            netTradeValue: numeral(row[8]).value(),
+            longOiVolume: numeral(row[9]).value(),
+            longOiValue: numeral(row[10]).value(),
+            shortOiVolume: numeral(row[11]).value(),
+            shortOiValue: numeral(row[12]).value(),
+            netOiVolume: numeral(row[13]).value(),
+            netOiValue: numeral(row[14]).value(),
+        }));
+        return data;
+    }
+    async fetchOptionsInstitutional(options) {
+        const { date, symbol } = options;
+        const queryDate = luxon_1.DateTime.fromISO(date).toFormat('yyyy/MM/dd');
+        const form = new URLSearchParams({
+            queryStartDate: queryDate,
+            queryEndDate: queryDate,
+            commodityId: symbol,
+        });
+        const url = 'https://www.taifex.com.tw/cht/3/callsAndPutsDateDown';
+        const response = await this.httpService.post(url, form, { responseType: 'arraybuffer' });
+        if (response.data.toString().includes('查無資料'))
+            return null;
+        if (response.data.toString().includes('日期時間錯誤'))
+            return null;
+        const csv = iconv.decode(response.data, 'big5');
+        const json = await csvtojson({ noheader: true, output: 'csv' }).fromString(csv);
+        const [_, ...rows] = json;
+        const data = {};
+        data.date = date;
+        data.exchange = enums_1.Exchange.TAIFEX;
+        data.symbol = symbol;
+        data.name = rows[0][1];
+        data.institutional = rows.map(row => ({
+            type: row[2],
+            investor: row[3],
+            longTradeVolume: numeral(row[4]).value(),
+            longTradeValue: numeral(row[5]).value(),
+            shortTradeVolume: numeral(row[6]).value(),
+            shortTradeValue: numeral(row[7]).value(),
+            netTradeVolume: numeral(row[8]).value(),
+            netTradeValue: numeral(row[9]).value(),
+            longOiVolume: numeral(row[10]).value(),
+            longOiValue: numeral(row[11]).value(),
+            shortOiVolume: numeral(row[12]).value(),
+            shortOiValue: numeral(row[13]).value(),
+            netOiVolume: numeral(row[14]).value(),
+            netOiValue: numeral(row[15]).value(),
+        }));
+        return data;
+    }
+    async fetchFuturesLargeTraders(options) {
+        const { date, symbol } = options;
+        const alias = {
+            'TXF': 'TX',
+            'EXF': 'TE',
+            'FXF': 'TF', // 金融期貨
+        };
+        const queryDate = luxon_1.DateTime.fromISO(date).toFormat('yyyy/MM/dd');
+        const form = new URLSearchParams({
+            queryStartDate: queryDate,
+            queryEndDate: queryDate,
+        });
+        const url = 'https://www.taifex.com.tw/cht/3/largeTraderFutDown';
+        const response = await this.httpService.post(url, form, { responseType: 'arraybuffer' });
+        if (response.data.toString().includes('查無資料'))
+            return null;
+        const csv = iconv.decode(response.data, 'big5');
+        const json = await csvtojson({ noheader: true, output: 'csv' }).fromString(csv);
+        const [_, ...rows] = json;
+        const targetRows = rows.filter(row => {
+            var _a;
+            return row[1] === ((_a = alias[symbol]) !== null && _a !== void 0 ? _a : symbol) || (row[1] === symbol.substring(0, 2));
+        });
+        const data = {};
+        data.date = date;
+        data.exchange = enums_1.Exchange.TAIFEX;
+        data.symbol = symbol;
+        data.name = targetRows[0][2];
+        data.largeTraders = targetRows
+            .map(row => ({
+            contractMonth: row[3],
+            traderType: row[4],
+            topFiveLongOi: numeral(row[5]).value(),
+            topFiveShortOi: numeral(row[6]).value(),
+            topTenLongOi: numeral(row[7]).value(),
+            topTenShortOi: numeral(row[8]).value(),
+            marketOi: numeral(row[9]).value(),
+        }));
+        return data;
+    }
+    async fetchOptionsLargeTraders(options) {
+        const { date, symbol } = options;
+        const queryDate = luxon_1.DateTime.fromISO(date).toFormat('yyyy/MM/dd');
+        const form = new URLSearchParams({
+            queryStartDate: queryDate,
+            queryEndDate: queryDate,
+        });
+        const url = 'https://www.taifex.com.tw/cht/3/largeTraderOptDown';
+        const response = await this.httpService.post(url, form, { responseType: 'arraybuffer' });
+        if (response.data.toString().includes('查無資料'))
+            return null;
+        const csv = iconv.decode(response.data, 'big5');
+        const json = await csvtojson({ noheader: true, output: 'csv' }).fromString(csv);
+        const [_, ...rows] = json;
+        const targetRows = rows.filter(row => {
+            return row[1] === symbol || (row[1] === symbol.substring(0, 2));
+        });
+        const data = {};
+        data.date = date;
+        data.exchange = enums_1.Exchange.TAIFEX;
+        data.symbol = symbol;
+        data.name = targetRows[0][2];
+        data.largeTraders = targetRows
+            .map(row => ({
+            type: row[3],
+            contractMonth: row[4],
+            traderType: row[5],
+            topFiveLongOi: numeral(row[6]).value(),
+            topFiveShortOi: numeral(row[7]).value(),
+            topTenLongOi: numeral(row[8]).value(),
+            topTenShortOi: numeral(row[9]).value(),
+            marketOi: numeral(row[10]).value(),
+        }));
+        return data;
+    }
+    async fetchMxfRetailPosition(options) {
+        const date = options.date;
+        const [fetchedMxfHistorical, fetchedMxfInstitutional] = await Promise.all([
+            this.fetchFuturesHistorical({ date, symbol: 'MXF' }),
+            this.fetchFuturesInstitutional({ date, symbol: 'MXF' }),
+        ]);
+        if (!fetchedMxfHistorical || !fetchedMxfInstitutional)
+            return null;
+        const mxfMarketOi = fetchedMxfHistorical
+            .filter(row => row.session === '一般' && !row.volumeSpread)
+            .reduce((oi, row) => oi + numeral(row.openInterest).value(), 0);
+        const { mxfInstitutionalLongOi, mxfInstitutionalShortOi } = fetchedMxfInstitutional.institutional
+            .reduce((institutional, row) => ({
+            mxfInstitutionalLongOi: institutional.mxfInstitutionalLongOi + row.longOiVolume,
+            mxfInstitutionalShortOi: institutional.mxfInstitutionalShortOi + row.shortOiVolume,
+        }), { mxfInstitutionalLongOi: 0, mxfInstitutionalShortOi: 0 });
+        const data = {};
+        data.date = date;
+        data.mxfRetailLongOi = mxfMarketOi - mxfInstitutionalLongOi;
+        data.mxfRetailShortOi = mxfMarketOi - mxfInstitutionalShortOi;
+        data.mxfRetailNetOi = data.mxfRetailLongOi - data.mxfRetailShortOi;
+        data.mxfRetailLongShortRatio = Math.round(data.mxfRetailNetOi / mxfMarketOi * 10000) / 10000;
+        return data;
+    }
+    async fetchTmfRetailPosition(options) {
+        const date = options.date;
+        const [fetchedTmfHistorical, fetchedTmfInstitutional] = await Promise.all([
+            this.fetchFuturesHistorical({ date, symbol: 'TMF' }),
+            this.fetchFuturesInstitutional({ date, symbol: 'TMF' }),
+        ]);
+        if (!fetchedTmfHistorical || !fetchedTmfInstitutional)
+            return null;
+        const tmfMarketOi = fetchedTmfHistorical
+            .filter(row => row.session === '一般' && !row.volumeSpread)
+            .reduce((oi, row) => oi + numeral(row.openInterest).value(), 0);
+        const { tmfInstitutionalLongOi, tmfInstitutionalShortOi } = fetchedTmfInstitutional.institutional
+            .reduce((institutional, row) => ({
+            tmfInstitutionalLongOi: institutional.tmfInstitutionalLongOi + row.longOiVolume,
+            tmfInstitutionalShortOi: institutional.tmfInstitutionalShortOi + row.shortOiVolume,
+        }), { tmfInstitutionalLongOi: 0, tmfInstitutionalShortOi: 0 });
+        const data = {};
+        data.date = date;
+        data.tmfRetailLongOi = tmfMarketOi - tmfInstitutionalLongOi;
+        data.tmfRetailShortOi = tmfMarketOi - tmfInstitutionalShortOi;
+        data.tmfRetailNetOi = data.tmfRetailLongOi - data.tmfRetailShortOi;
+        data.tmfRetailLongShortRatio = Math.round(data.tmfRetailNetOi / tmfMarketOi * 10000) / 10000;
+        return data;
+    }
+    async fetchTxoPutCallRatio(options) {
+        const { date } = options;
+        const queryDate = luxon_1.DateTime.fromISO(date).toFormat('yyyy/MM/dd');
+        const form = new URLSearchParams({
+            queryStartDate: queryDate,
+            queryEndDate: queryDate,
+        });
+        const url = 'https://www.taifex.com.tw/cht/3/pcRatioDown';
+        const response = await this.httpService.post(url, form, { responseType: 'arraybuffer' });
+        const csv = iconv.decode(response.data, 'big5');
+        const json = await csvtojson({ noheader: true, output: 'csv' }).fromString(csv);
+        const [_, row] = json;
+        if (!row)
+            return null;
+        const data = {};
+        data.date = date;
+        data.txoPutVolume = numeral(row[1]).value();
+        data.txoCallVolume = numeral(row[2]).value();
+        data.txoPutCallVolumeRatio = numeral(row[3]).divide(100).value();
+        data.txoPutOi = numeral(row[4]).value();
+        data.txoCallOi = numeral(row[5]).value();
+        data.txoPutCallOiRatio = numeral(row[6]).divide(100).value();
+        return data;
+    }
+    async fetchExchangeRates(options) {
+        const date = options.date;
+        const queryDate = luxon_1.DateTime.fromISO(date).toFormat('yyyy/MM/dd');
+        const form = new URLSearchParams({
+            queryStartDate: queryDate,
+            queryEndDate: queryDate,
+        });
+        const url = 'https://www.taifex.com.tw/cht/3/dailyFXRateDown';
+        const response = await this.httpService.post(url, form, { responseType: 'arraybuffer' });
+        const csv = iconv.decode(response.data, 'big5');
+        const json = await csvtojson({ noheader: true, output: 'csv' }).fromString(csv);
+        const [_, row] = json;
+        if (!row.length)
+            return null;
+        const data = {};
+        data.date = luxon_1.DateTime.fromFormat(row[0], 'yyyy/MM/dd').toISODate();
+        data.usdtwd = numeral(row[1]).value();
+        data.cnytwd = numeral(row[2]).value();
+        data.eurusd = numeral(row[3]).value();
+        data.usdjpy = numeral(row[4]).value();
+        data.gbpusd = numeral(row[5]).value();
+        data.audusd = numeral(row[6]).value();
+        data.usdhkd = numeral(row[7]).value();
+        data.usdcny = numeral(row[8]).value();
+        data.usdzar = numeral(row[9]).value();
+        data.nzdusd = numeral(row[10]).value();
+        return data;
+    }
+}
+exports.TaifexScraper = TaifexScraper;

package/lib/scrapers/tdcc-scraper.d.ts

@@ -0,0 +1,11 @@
+import { Scraper } from './scraper';
+import { StockShareholders } from '../interfaces';
+export declare class TdccScraper extends Scraper {
+    fetchStocksShareholders(options: {
+        date: string;
+        symbol: string;
+    }): Promise<StockShareholders | null>;
+    fetchStocksShareholdersRecentWeek(options?: {
+        symbol: string;
+    }): Promise<StockShareholders | StockShareholders[] | undefined>;
+}

package/lib/scrapers/tdcc-scraper.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TdccScraper = void 0;
+const _ = require("lodash");
+const cheerio = require("cheerio");
+const numeral = require("numeral");
+const csvtojson = require("csvtojson");
+const luxon_1 = require("luxon");
+const scraper_1 = require("./scraper");
+class TdccScraper extends scraper_1.Scraper {
+    async fetchStocksShareholders(options) {
+        const { date, symbol } = options;
+        const url = 'https://www.tdcc.com.tw/portal/zh/smWeb/qryStock';
+        const request = await this.httpService.get(url);
+        const $request = cheerio.load(request.data);
+        const token = $request('#SYNCHRONIZER_TOKEN').attr('value');
+        const uri = $request('#SYNCHRONIZER_URI').attr('value');
+        const method = $request('#method').attr('value');
+        const firDate = $request('#firDate').attr('value');
+        const scaDate = $request('#scaDate').find('option').map((_, el) => {
+            return $request(el).attr('value');
+        }).toArray();
+        const cookie = request.headers['set-cookie'];
+        const form = new URLSearchParams({
+            SYNCHRONIZER_TOKEN: token,
+            SYNCHRONIZER_URI: uri,
+            method,
+            firDate,
+            scaDate: luxon_1.DateTime.fromISO(date).toFormat('yyyyMMdd'),
+            sqlMethod: 'StockNo',
+            stockNo: symbol,
+            stockName: '',
+        });
+        const response = await this.httpService.post(url, form, { headers: { 'Cookie': cookie } });
+        const $response = cheerio.load(response.data);
+        const message = $response('.table tr').find('td').eq(0).text();
+        if (message === '查無此資料')
+            return null;
+        const data = {};
+        data.date = date;
+        data.symbol = symbol;
+        data.shareholders = $response('.table tr').slice(1).map((_, el) => {
+            const td = $response(el).find('td');
+            return {
+                level: numeral(td.eq(0).text()).value(),
+                holders: numeral(td.eq(2).text()).value(),
+                shares: numeral(td.eq(3).text()).value(),
+                proportion: numeral(td.eq(4).text()).value(),
+            };
+        }).toArray();
+        if (data.shareholders.length === 16) {
+            data.shareholders = [
+                ...data.shareholders.slice(0, -1),
+                { level: 16, holders: null, shares: 0, proportion: 0 },
+                Object.assign(Object.assign({}, data.shareholders[data.shareholders.length - 1]), { level: 17 })
+            ];
+        }
+        return data;
+    }
+    async fetchStocksShareholdersRecentWeek(options) {
+        const url = 'https://smart.tdcc.com.tw/opendata/getOD.ashx?id=1-5';
+        const response = await this.httpService.get(url);
+        const json = await csvtojson({ noheader: true, output: 'csv' }).fromString(response.data);
+        const [fields, ...rows] = json;
+        const distributions = rows.map(row => ({
+            date: luxon_1.DateTime.fromFormat(row[0], 'yyyyMMdd').toISODate(),
+            symbol: row[1],
+            level: numeral(row[2]).value(),
+            holders: row[2] === '16' ? null : numeral(row[3]).value(),
+            shares: row[2] === '16' ? numeral(row[4]).multiply(-1).value() : numeral(row[4]).value(),
+            proportion: row[2] === '16' ? numeral(row[5]).multiply(-1).value() : numeral(row[5]).value(),
+        }));
+        const data = _(distributions).groupBy('symbol')
+            .map(rows => {
+            const { date, symbol } = rows[0];
+            const shareholders = rows.map(row => _.omit(row, ['date', 'symbol']));
+            return { date, symbol, shareholders };
+        }).value();
+        return (options === null || options === void 0 ? void 0 : options.symbol) ? data.find(data => data.symbol === options.symbol) : data;
+    }
+}
+exports.TdccScraper = TdccScraper;

package/lib/scrapers/tpex-scraper.d.ts

@@ -0,0 +1,95 @@
+import { Scraper } from './scraper';
+import { IndexHistorical, IndexTrades, MarketBreadth, MarketInstitutional, MarketMarginTrades, MarketTrades, StockCapitalReductions, StockDividends, StockFiniHoldings, StockHistorical, StockInstitutional, StocksListingApplication, StockMarginTrades, StockShortSales, StockSplits, StockValues, StocksDividendAnnouncement, StocksCapitalReductionAnnouncement, StocksSplitAnnouncement, StocksEtfSplitAnnouncement } from '../interfaces';
+export declare class TpexScraper extends Scraper {
+    fetchStocksHistorical(options: {
+        date: string;
+        symbol?: string;
+    }): Promise<StockHistorical | StockHistorical[] | null | undefined>;
+    fetchStocksInstitutional(options: {
+        date: string;
+        symbol?: string;
+    }): Promise<StockInstitutional | StockInstitutional[] | null | undefined>;
+    fetchStocksFiniHoldings(options: {
+        date: string;
+        symbol?: string;
+    }): Promise<StockFiniHoldings | StockFiniHoldings[] | null | undefined>;
+    fetchStocksMarginTrades(options: {
+        date: string;
+        symbol?: string;
+    }): Promise<StockMarginTrades | StockMarginTrades[] | null | undefined>;
+    fetchStocksShortSales(options: {
+        date: string;
+        symbol?: string;
+    }): Promise<StockShortSales | StockShortSales[] | null | undefined>;
+    fetchStocksValues(options: {
+        date: string;
+        symbol?: string;
+    }): Promise<StockValues | StockValues[] | null | undefined>;
+    fetchStocksDividends(options: {
+        startDate: string;
+        endDate: string;
+        symbol?: string;
+        includeDetail?: boolean;
+    }): Promise<StockDividends[]>;
+    fetchStocksCapitalReductions(options: {
+        startDate: string;
+        endDate: string;
+        symbol?: string;
+        includeDetail?: boolean;
+    }): Promise<StockCapitalReductions[]>;
+    fetchStocksSplits(options: {
+        startDate: string;
+        endDate: string;
+        symbol?: string;
+    }): Promise<StockSplits[]>;
+    fetchStocksEtfSplits(options: {
+        startDate: string;
+        endDate: string;
+        symbol?: string;
+    }): Promise<StockSplits[]>;
+    fetchStocksEtfReverseSplits(options: {
+        startDate: string;
+        endDate: string;
+        symbol?: string;
+    }): Promise<StockSplits[]>;
+    fetchIndicesHistorical(options: {
+        date: string;
+        symbol?: string;
+    }): Promise<IndexHistorical | IndexHistorical[] | null | undefined>;
+    fetchIndicesTrades(options: {
+        date: string;
+        symbol?: string;
+    }): Promise<IndexTrades | IndexTrades[] | null | undefined>;
+    fetchMarketTrades(options: {
+        date: string;
+    }): Promise<MarketTrades | null>;
+    fetchMarketBreadth(options: {
+        date: string;
+    }): Promise<MarketBreadth | null>;
+    fetchMarketInstitutional(options: {
+        date: string;
+    }): Promise<MarketInstitutional | null>;
+    fetchMarketMarginTrades(options: {
+        date: string;
+    }): Promise<MarketMarginTrades | null>;
+    fetchStocksDividendsAnnouncement(options?: {
+        symbol?: string;
+    }): Promise<StocksDividendAnnouncement[]>;
+    fetchStocksCapitalReductionAnnouncement(options?: {
+        symbol?: string;
+    }): Promise<StocksCapitalReductionAnnouncement[]>;
+    fetchStocksSplitAnnouncement(options?: {
+        symbol?: string;
+    }): Promise<StocksSplitAnnouncement[]>;
+    fetchStocksEtfSplitAnnouncement(options?: {
+        symbol?: string;
+    }): Promise<StocksEtfSplitAnnouncement[]>;
+    fetchStocksEtfReverseSplitAnnouncement(options?: {
+        symbol?: string;
+    }): Promise<StocksEtfSplitAnnouncement[]>;
+    private fetchEtfSplitAnnouncementBase;
+    fetchStocksListingApplicants(options?: {
+        symbol?: string;
+        year?: number | 'ALL';
+    }): Promise<StocksListingApplication[]>;
+}