@fin.cx/opendata 1.6.1 → 1.7.0

package/dist_ts/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@fin.cx/opendata',
-    version: '1.6.1',
+    version: '1.7.0',
     description: 'A comprehensive TypeScript library for accessing business data and real-time financial information. Features include German company data management with MongoDB integration, JSONL bulk processing, automated Handelsregister interactions, and real-time stock market data from multiple providers.'
 };
 //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSxrQkFBa0I7SUFDeEIsT0FBTyxFQUFFLE9BQU87SUFDaEIsV0FBVyxFQUFFLHVTQUF1UztDQUNyVCxDQUFBIn0=

package/dist_ts/stocks/index.d.ts

@@ -2,3 +2,4 @@ export * from './interfaces/stockprice.js';
 export * from './interfaces/provider.js';
 export * from './classes.stockservice.js';
 export * from './providers/provider.yahoo.js';
+export * from './providers/provider.marketstack.js';

package/dist_ts/stocks/index.js

@@ -5,4 +5,5 @@ export * from './interfaces/provider.js';
 export * from './classes.stockservice.js';
 // Export providers
 export * from './providers/provider.yahoo.js';
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9zdG9ja3MvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsd0JBQXdCO0FBQ3hCLGNBQWMsNEJBQTRCLENBQUM7QUFDM0MsY0FBYywwQkFBMEIsQ0FBQztBQUV6QyxzQkFBc0I7QUFDdEIsY0FBYywyQkFBMkIsQ0FBQztBQUUxQyxtQkFBbUI7QUFDbkIsY0FBYywrQkFBK0IsQ0FBQyJ9
+export * from './providers/provider.marketstack.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9zdG9ja3MvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsd0JBQXdCO0FBQ3hCLGNBQWMsNEJBQTRCLENBQUM7QUFDM0MsY0FBYywwQkFBMEIsQ0FBQztBQUV6QyxzQkFBc0I7QUFDdEIsY0FBYywyQkFBMkIsQ0FBQztBQUUxQyxtQkFBbUI7QUFDbkIsY0FBYywrQkFBK0IsQ0FBQztBQUM5QyxjQUFjLHFDQUFxQyxDQUFDIn0=

package/dist_ts/stocks/providers/provider.marketstack.d.ts

@@ -0,0 +1,57 @@
+import type { IStockProvider, IProviderConfig } from '../interfaces/provider.js';
+import type { IStockPrice, IStockQuoteRequest, IStockBatchQuoteRequest } from '../interfaces/stockprice.js';
+/**
+ * Marketstack API v2 Provider
+ * Documentation: https://marketstack.com/documentation_v2
+ *
+ * Features:
+ * - End-of-Day (EOD) stock prices
+ * - Supports 125,000+ tickers across 72+ exchanges worldwide
+ * - Requires API key authentication
+ *
+ * Rate Limits:
+ * - Free Plan: 100 requests/month (EOD only)
+ * - Basic Plan: 10,000 requests/month
+ * - Professional Plan: 100,000 requests/month
+ *
+ * Note: This provider returns EOD data, not real-time prices
+ */
+export declare class MarketstackProvider implements IStockProvider {
+    private config?;
+    name: string;
+    priority: number;
+    readonly requiresAuth = true;
+    readonly rateLimit: {
+        requestsPerMinute: any;
+        requestsPerDay: any;
+    };
+    private logger;
+    private baseUrl;
+    private apiKey;
+    constructor(apiKey: string, config?: IProviderConfig);
+    /**
+     * Fetch latest EOD price for a single ticker
+     */
+    fetchPrice(request: IStockQuoteRequest): Promise<IStockPrice>;
+    /**
+     * Fetch latest EOD prices for multiple tickers
+     */
+    fetchPrices(request: IStockBatchQuoteRequest): Promise<IStockPrice[]>;
+    /**
+     * Check if the Marketstack API is available and accessible
+     */
+    isAvailable(): Promise<boolean>;
+    /**
+     * Check if a market is supported
+     * Marketstack supports 72+ exchanges worldwide
+     */
+    supportsMarket(market: string): boolean;
+    /**
+     * Check if a ticker format is supported
+     */
+    supportsTicker(ticker: string): boolean;
+    /**
+     * Map Marketstack API response to IStockPrice interface
+     */
+    private mapToStockPrice;
+}

package/dist_ts/stocks/providers/provider.marketstack.js

@@ -0,0 +1,173 @@
+import * as plugins from '../../plugins.js';
+/**
+ * Marketstack API v2 Provider
+ * Documentation: https://marketstack.com/documentation_v2
+ *
+ * Features:
+ * - End-of-Day (EOD) stock prices
+ * - Supports 125,000+ tickers across 72+ exchanges worldwide
+ * - Requires API key authentication
+ *
+ * Rate Limits:
+ * - Free Plan: 100 requests/month (EOD only)
+ * - Basic Plan: 10,000 requests/month
+ * - Professional Plan: 100,000 requests/month
+ *
+ * Note: This provider returns EOD data, not real-time prices
+ */
+export class MarketstackProvider {
+    constructor(apiKey, config) {
+        this.config = config;
+        this.name = 'Marketstack';
+        this.priority = 80; // Lower than Yahoo (100) due to rate limits and EOD-only data
+        this.requiresAuth = true;
+        this.rateLimit = {
+            requestsPerMinute: undefined, // No per-minute limit specified
+            requestsPerDay: undefined // Varies by plan
+        };
+        this.logger = console;
+        this.baseUrl = 'https://api.marketstack.com/v2';
+        if (!apiKey) {
+            throw new Error('API key is required for Marketstack provider');
+        }
+        this.apiKey = apiKey;
+    }
+    /**
+     * Fetch latest EOD price for a single ticker
+     */
+    async fetchPrice(request) {
+        try {
+            const url = `${this.baseUrl}/tickers/${request.ticker}/eod/latest?access_key=${this.apiKey}`;
+            const response = await plugins.smartrequest.SmartRequest.create()
+                .url(url)
+                .timeout(this.config?.timeout || 10000)
+                .get();
+            const responseData = await response.json();
+            // Check for API errors
+            if (responseData.error) {
+                throw new Error(`Marketstack API error: ${responseData.error.message || JSON.stringify(responseData.error)}`);
+            }
+            // For single ticker endpoint, response is direct object (not wrapped in data field)
+            if (!responseData || !responseData.close) {
+                throw new Error(`No data found for ticker ${request.ticker}`);
+            }
+            return this.mapToStockPrice(responseData);
+        }
+        catch (error) {
+            this.logger.error(`Failed to fetch price for ${request.ticker}:`, error);
+            throw new Error(`Marketstack: Failed to fetch price for ${request.ticker}: ${error.message}`);
+        }
+    }
+    /**
+     * Fetch latest EOD prices for multiple tickers
+     */
+    async fetchPrices(request) {
+        try {
+            const symbols = request.tickers.join(',');
+            const url = `${this.baseUrl}/eod/latest?access_key=${this.apiKey}&symbols=${symbols}`;
+            const response = await plugins.smartrequest.SmartRequest.create()
+                .url(url)
+                .timeout(this.config?.timeout || 15000)
+                .get();
+            const responseData = await response.json();
+            // Check for API errors
+            if (responseData.error) {
+                throw new Error(`Marketstack API error: ${responseData.error.message || JSON.stringify(responseData.error)}`);
+            }
+            if (!responseData?.data || !Array.isArray(responseData.data)) {
+                throw new Error('Invalid response format from Marketstack API');
+            }
+            const prices = [];
+            for (const data of responseData.data) {
+                try {
+                    prices.push(this.mapToStockPrice(data));
+                }
+                catch (error) {
+                    this.logger.warn(`Failed to parse data for ${data.symbol}:`, error);
+                    // Continue processing other tickers
+                }
+            }
+            if (prices.length === 0) {
+                throw new Error('No valid price data received from batch request');
+            }
+            return prices;
+        }
+        catch (error) {
+            this.logger.error(`Failed to fetch batch prices:`, error);
+            throw new Error(`Marketstack: Failed to fetch batch prices: ${error.message}`);
+        }
+    }
+    /**
+     * Check if the Marketstack API is available and accessible
+     */
+    async isAvailable() {
+        try {
+            // Test with a well-known ticker
+            const url = `${this.baseUrl}/tickers/AAPL/eod/latest?access_key=${this.apiKey}`;
+            const response = await plugins.smartrequest.SmartRequest.create()
+                .url(url)
+                .timeout(5000)
+                .get();
+            const responseData = await response.json();
+            // Check if we got valid data (not an error)
+            // Single ticker endpoint returns direct object, not wrapped in data field
+            return !responseData.error && responseData.close !== undefined;
+        }
+        catch (error) {
+            this.logger.warn('Marketstack provider is not available:', error);
+            return false;
+        }
+    }
+    /**
+     * Check if a market is supported
+     * Marketstack supports 72+ exchanges worldwide
+     */
+    supportsMarket(market) {
+        // Marketstack has broad international coverage including:
+        // US, UK, DE, FR, JP, CN, HK, AU, CA, IN, etc.
+        const supportedMarkets = [
+            'US', 'UK', 'GB', 'DE', 'FR', 'JP', 'CN', 'HK', 'AU', 'CA',
+            'IN', 'BR', 'MX', 'IT', 'ES', 'NL', 'SE', 'CH', 'NO', 'DK'
+        ];
+        return supportedMarkets.includes(market.toUpperCase());
+    }
+    /**
+     * Check if a ticker format is supported
+     */
+    supportsTicker(ticker) {
+        // Basic validation - Marketstack supports most standard ticker formats
+        return /^[A-Z0-9\.\-]{1,10}$/.test(ticker.toUpperCase());
+    }
+    /**
+     * Map Marketstack API response to IStockPrice interface
+     */
+    mapToStockPrice(data) {
+        if (!data.close) {
+            throw new Error('Missing required price data');
+        }
+        // Calculate change and change percent
+        // EOD data: previous close is typically open price of the same day
+        // For better accuracy, we'd need previous day's close, but that requires another API call
+        const currentPrice = data.close;
+        const previousClose = data.open;
+        const change = currentPrice - previousClose;
+        const changePercent = previousClose !== 0 ? (change / previousClose) * 100 : 0;
+        // Parse timestamp
+        const timestamp = data.date ? new Date(data.date) : new Date();
+        const stockPrice = {
+            ticker: data.symbol.toUpperCase(),
+            price: currentPrice,
+            currency: data.price_currency || 'USD',
+            change: change,
+            changePercent: changePercent,
+            previousClose: previousClose,
+            timestamp: timestamp,
+            provider: this.name,
+            marketState: 'CLOSED', // EOD data is always for closed markets
+            exchange: data.exchange,
+            exchangeName: data.exchange_code || data.name
+        };
+        return stockPrice;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJvdmlkZXIubWFya2V0c3RhY2suanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi90cy9zdG9ja3MvcHJvdmlkZXJzL3Byb3ZpZGVyLm1hcmtldHN0YWNrLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sa0JBQWtCLENBQUM7QUFJNUM7Ozs7Ozs7Ozs7Ozs7OztHQWVHO0FBQ0gsTUFBTSxPQUFPLG1CQUFtQjtJQWE5QixZQUFZLE1BQWMsRUFBVSxNQUF3QjtRQUF4QixXQUFNLEdBQU4sTUFBTSxDQUFrQjtRQVpyRCxTQUFJLEdBQUcsYUFBYSxDQUFDO1FBQ3JCLGFBQVEsR0FBRyxFQUFFLENBQUMsQ0FBQyw4REFBOEQ7UUFDcEUsaUJBQVksR0FBRyxJQUFJLENBQUM7UUFDcEIsY0FBUyxHQUFHO1lBQzFCLGlCQUFpQixFQUFFLFNBQVMsRUFBRSxnQ0FBZ0M7WUFDOUQsY0FBYyxFQUFFLFNBQVMsQ0FBQyxpQkFBaUI7U0FDNUMsQ0FBQztRQUVNLFdBQU0sR0FBRyxPQUFPLENBQUM7UUFDakIsWUFBTyxHQUFHLGdDQUFnQyxDQUFDO1FBSWpELElBQUksQ0FBQyxNQUFNLEVBQUUsQ0FBQztZQUNaLE1BQU0sSUFBSSxLQUFLLENBQUMsOENBQThDLENBQUMsQ0FBQztRQUNsRSxDQUFDO1FBRUQsSUFBSSxDQUFDLE1BQU0sR0FBRyxNQUFNLENBQUM7SUFDdkIsQ0FBQztJQUVEOztPQUVHO0lBQ0ksS0FBSyxDQUFDLFVBQVUsQ0FBQyxPQUEyQjtRQUNqRCxJQUFJLENBQUM7WUFDSCxNQUFNLEdBQUcsR0FBRyxHQUFHLElBQUksQ0FBQyxPQUFPLFlBQVksT0FBTyxDQUFDLE1BQU0sMEJBQTBCLElBQUksQ0FBQyxNQUFNLEVBQUUsQ0FBQztZQUU3RixNQUFNLFFBQVEsR0FBRyxNQUFNLE9BQU8sQ0FBQyxZQUFZLENBQUMsWUFBWSxDQUFDLE1BQU0sRUFBRTtpQkFDOUQsR0FBRyxDQUFDLEdBQUcsQ0FB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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fin.cx/opendata",
-  "version": "1.6.1",
+  "version": "1.7.0",
   "private": false,
   "description": "A comprehensive TypeScript library for accessing business data and real-time financial information. Features include German company data management with MongoDB integration, JSONL bulk processing, automated Handelsregister interactions, and real-time stock market data from multiple providers.",
   "main": "dist_ts/index.js",
@@ -12,7 +12,7 @@
     "@git.zone/tsbuild": "^2.6.8",
     "@git.zone/tsbundle": "^2.5.1",
     "@git.zone/tsrun": "^1.3.3",
-    "@git.zone/tstest": "^2.3.8",
+    "@git.zone/tstest": "^2.4.2",
     "@types/node": "^22.14.0"
   },
   "dependencies": {

package/readme.md

@@ -1,4 +1,5 @@
 # @fin.cx/opendata
+
 🚀 **Real-time financial data and German business intelligence in one powerful TypeScript library**
 
 Access live stock prices, cryptocurrencies, forex, commodities AND comprehensive German company data - all through a single, unified API.
@@ -8,34 +9,42 @@ Access live stock prices, cryptocurrencies, forex, commodities AND comprehensive
 ```bash
 npm install @fin.cx/opendata
 # or
-yarn add @fin.cx/opendata
+pnpm add @fin.cx/opendata
 ```
 
 ## Quick Start
 
-### 📈 Real-Time Stock Data
+### 📈 Stock Market Data
 
-Get live market data in seconds:
+Get market data with EOD (End-of-Day) pricing:
 
 ```typescript
-import { StockPriceService, YahooFinanceProvider } from '@fin.cx/opendata';
+import { StockPriceService, MarketstackProvider } from '@fin.cx/opendata';
+
+// Initialize the service with caching
+const stockService = new StockPriceService({
+  ttl: 60000,      // Cache for 1 minute
+  maxEntries: 1000 // Max cached symbols
+});
 
-// Initialize the service
-const stockService = new StockPriceService();
-stockService.register(new YahooFinanceProvider());
+// Register Marketstack provider with API key
+stockService.register(new MarketstackProvider('YOUR_API_KEY'), {
+  priority: 100,
+  retryAttempts: 3
+});
 
 // Get single stock price
 const apple = await stockService.getPrice({ ticker: 'AAPL' });
 console.log(`Apple: $${apple.price} (${apple.changePercent.toFixed(2)}%)`);
 
-// Get multiple prices at once
-const prices = await stockService.getPrices({ 
-  tickers: ['AAPL', 'MSFT', 'GOOGL', 'BTC-USD', 'ETH-USD'] 
+// Get multiple prices at once (batch fetching)
+const prices = await stockService.getPrices({
+  tickers: ['AAPL', 'MSFT', 'GOOGL', 'AMZN', 'TSLA']
 });
 
-// Market indices, crypto, forex, commodities - all supported!
-const marketData = await stockService.getPrices({
-  tickers: ['^GSPC', '^DJI', 'BTC-USD', 'EURUSD=X', 'GC=F']
+// 125,000+ tickers across 72+ exchanges worldwide
+const internationalStocks = await stockService.getPrices({
+  tickers: ['AAPL', 'VOD.LON', 'SAP.DEX', 'TM', 'BABA']
 });
 ```
 
@@ -73,11 +82,12 @@ await openData.buildInitialDb();
 
 ### 🎯 Stock Market Module
 
-- **Real-time prices** for stocks, ETFs, indices, crypto, forex, and commodities
+- **Marketstack API** - End-of-Day (EOD) data for 125,000+ tickers across 72+ exchanges
+- **Stock prices** for stocks, ETFs, indices, and more
 - **Batch operations** - fetch 100+ symbols in one request
 - **Smart caching** - configurable TTL, automatic invalidation
-- **Provider system** - easily extensible for new data sources
-- **Automatic retries** and fallback mechanisms
+- **Extensible provider system** - easily add new data sources
+- **Retry logic** - configurable retry attempts and delays
 - **Type-safe** - full TypeScript support with detailed interfaces
 
 ### 🇩🇪 German Business Intelligence
@@ -92,29 +102,24 @@ await openData.buildInitialDb();
 
 ### Market Dashboard
 
-Create a real-time market overview:
+Create an EOD market overview:
 
 ```typescript
 const indicators = [
   // Indices
   { ticker: '^GSPC', name: 'S&P 500' },
-  { ticker: '^IXIC', name: 'NASDAQ' },
-  
+  { ticker: '^DJI', name: 'DOW Jones' },
+
   // Tech Giants
   { ticker: 'AAPL', name: 'Apple' },
   { ticker: 'MSFT', name: 'Microsoft' },
-  
-  // Crypto
-  { ticker: 'BTC-USD', name: 'Bitcoin' },
-  { ticker: 'ETH-USD', name: 'Ethereum' },
-  
-  // Commodities
-  { ticker: 'GC=F', name: 'Gold' },
-  { ticker: 'CL=F', name: 'Oil' }
+  { ticker: 'GOOGL', name: 'Alphabet' },
+  { ticker: 'AMZN', name: 'Amazon' },
+  { ticker: 'TSLA', name: 'Tesla' }
 ];
 
-const prices = await stockService.getPrices({ 
-  tickers: indicators.map(i => i.ticker) 
+const prices = await stockService.getPrices({
+  tickers: indicators.map(i => i.ticker)
 });
 
 // Display with color-coded changes
@@ -122,7 +127,7 @@ prices.forEach(price => {
   const indicator = indicators.find(i => i.ticker === price.ticker);
   const arrow = price.change >= 0 ? '↑' : '↓';
   const color = price.change >= 0 ? '\x1b[32m' : '\x1b[31m';
-  
+
   console.log(
     `${indicator.name.padEnd(15)} ${price.price.toFixed(2).padStart(10)} ` +
     `${color}${arrow} ${price.changePercent.toFixed(2)}%\x1b[0m`
@@ -130,6 +135,25 @@ prices.forEach(price => {
 });
 ```
 
+### Provider Health and Statistics
+
+Monitor your provider health and track usage:
+
+```typescript
+// Check provider health
+const health = await stockService.checkProvidersHealth();
+console.log(`Marketstack: ${health.get('Marketstack') ? '✅' : '❌'}`);
+
+// Get provider statistics
+const stats = stockService.getProviderStats();
+const marketstackStats = stats.get('Marketstack');
+console.log('Marketstack Stats:', {
+  successCount: marketstackStats.successCount,
+  errorCount: marketstackStats.errorCount,
+  lastError: marketstackStats.lastError
+});
+```
+
 ### Handelsregister Integration
 
 Automate German company data retrieval:
@@ -169,15 +193,15 @@ for (const company of publicCompanies) {
   try {
     // Map company to ticker (custom logic needed)
     const ticker = mapCompanyToTicker(company.data.name);
-    
+
     if (ticker) {
       const stock = await stockService.getPrice({ ticker });
-      
+
       // Add financial metrics
       company.data.stockPrice = stock.price;
       company.data.marketCap = stock.price * getSharesOutstanding(ticker);
       company.data.priceChange = stock.changePercent;
-      
+
       await company.save();
     }
   } catch (error) {
@@ -196,8 +220,8 @@ const stockService = new StockPriceService({
   maxEntries: 1000    // Max cached symbols
 });
 
-// Provider configuration
-stockService.register(new YahooFinanceProvider(), {
+// Marketstack - EOD data, requires API key
+stockService.register(new MarketstackProvider('YOUR_API_KEY'), {
   enabled: true,
   priority: 100,
   timeout: 10000,
@@ -208,7 +232,7 @@ stockService.register(new YahooFinanceProvider(), {
 
 ### MongoDB Setup
 
-Set environment variables:
+Set environment variables for German business data:
 
 ```env
 MONGODB_URL=mongodb://localhost:27017
@@ -217,6 +241,14 @@ MONGODB_USER=myuser
 MONGODB_PASS=mypass
 ```
 
+### Marketstack API Key
+
+Get your free API key at [marketstack.com](https://marketstack.com) and set it in your environment:
+
+```env
+MARKETSTACK_COM_TOKEN=your_api_key_here
+```
+
 ## API Reference
 
 ### Stock Types
@@ -240,10 +272,21 @@ interface IStockPrice {
 ### Key Methods
 
 **StockPriceService**
-- `getPrice(request)` - Single stock price
-- `getPrices(request)` - Batch prices
-- `register(provider)` - Add data provider
+- `getPrice(request)` - Single stock price with automatic provider selection
+- `getPrices(request)` - Batch prices (100+ symbols in one request)
+- `register(provider, config)` - Add data provider with priority and retry config
+- `checkProvidersHealth()` - Test all providers and return health status
+- `getProviderStats()` - Get success/error statistics for each provider
 - `clearCache()` - Clear price cache
+- `setCacheTTL(ttl)` - Update cache TTL dynamically
+
+**MarketstackProvider**
+- ✅ End-of-Day (EOD) data
+- ✅ 125,000+ tickers across 72+ exchanges worldwide
+- ✅ Batch fetching support (multiple symbols in one request)
+- ✅ Comprehensive data: open, high, low, close, volume, splits, dividends
+- ⚠️ Requires API key (free tier: 100 requests/month)
+- ⚠️ EOD data only (not real-time)
 
 **OpenData**
 - `start()` - Initialize MongoDB connection
@@ -251,31 +294,48 @@ interface IStockPrice {
 - `CBusinessRecord` - Business record class
 - `handelsregister` - Registry automation
 
-## Performance
-
-- **Batch fetching**: Get 100+ prices in <500ms
-- **Caching**: Instant repeated queries
-- **Concurrent processing**: Handle 1000+ records/second
-- **Streaming**: Process GB-sized datasets without memory issues
-
-## Extensibility
+## Provider Architecture
 
-The provider architecture makes it easy to add new data sources:
+The library uses a flexible provider system that makes it easy to add new data sources:
 
 ```typescript
 class MyCustomProvider implements IStockProvider {
   name = 'My Provider';
-  
+  priority = 50;
+  requiresAuth = true;
+
   async fetchPrice(request: IStockQuoteRequest): Promise<IStockPrice> {
     // Your implementation
   }
-  
-  // ... other required methods
+
+  async fetchPrices(request: IStockBatchQuoteRequest): Promise<IStockPrice[]> {
+    // Batch implementation
+  }
+
+  async isAvailable(): Promise<boolean> {
+    // Health check
+  }
+
+  supportsMarket(market: string): boolean {
+    // Market validation
+  }
+
+  supportsTicker(ticker: string): boolean {
+    // Ticker validation
+  }
 }
 
 stockService.register(new MyCustomProvider());
 ```
 
+## Performance
+
+- **Batch fetching**: Get 100+ EOD prices in one API request
+- **Smart caching**: Instant repeated queries with configurable TTL
+- **Rate limit aware**: Automatic retry logic for API limits
+- **Concurrent processing**: Handle 1000+ business records/second
+- **Streaming**: Process GB-sized datasets without memory issues
+
 ## Testing
 
 Run the comprehensive test suite:
@@ -284,19 +344,21 @@ Run the comprehensive test suite:
 npm test
 ```
 
-View live market data:
+Test stock provider:
 
 ```bash
-npm test -- --grep "market indicators"
+npx tstest test/test.marketstack.node.ts --verbose
 ```
 
-## Contributing
+Test German business data:
 
-We welcome contributions! Please see our contributing guidelines for details.
+```bash
+npx tstest test/test.handelsregister.ts --verbose
+```
 
 ## License and Legal Information
 
-This repository contains open-source code that is licensed under the MIT License. A copy of the MIT License can be found in the [license](license) file within this repository. 
+This repository contains open-source code that is licensed under the MIT License. A copy of the MIT License can be found in the [license](license) file within this repository.
 
 **Please note:** The MIT License does not grant permission to use the trade names, trademarks, service marks, or product names of the project, except as required for reasonable and customary use in describing the origin of the work and reproducing the content of the NOTICE file.
 
@@ -306,9 +368,9 @@ This project is owned and maintained by Task Venture Capital GmbH. The names and
 
 ### Company Information
 
-Task Venture Capital GmbH  
+Task Venture Capital GmbH
 Registered at District court Bremen HRB 35230 HB, Germany
 
 For any legal inquiries or if you require further information, please contact us via email at hello@task.vc.
 
-By using this repository, you acknowledge that you have read this section, agree to comply with its terms, and understand that the licensing of the code does not imply endorsement by Task Venture Capital GmbH of any derivative works.
+By using this repository, you acknowledge that you have read this section, agree to comply with its terms, and understand that the licensing of the code does not imply endorsement by Task Venture Capital GmbH of any derivative works.

package/ts/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@fin.cx/opendata',
-  version: '1.6.1',
+  version: '1.7.0',
   description: 'A comprehensive TypeScript library for accessing business data and real-time financial information. Features include German company data management with MongoDB integration, JSONL bulk processing, automated Handelsregister interactions, and real-time stock market data from multiple providers.'
 }

package/ts/stocks/index.ts

@@ -6,4 +6,5 @@ export * from './interfaces/provider.js';
 export * from './classes.stockservice.js';
 
 // Export providers
-export * from './providers/provider.yahoo.js';
+export * from './providers/provider.yahoo.js';
+export * from './providers/provider.marketstack.js';

package/ts/stocks/providers/provider.marketstack.ts

@@ -0,0 +1,200 @@
+import * as plugins from '../../plugins.js';
+import type { IStockProvider, IProviderConfig } from '../interfaces/provider.js';
+import type { IStockPrice, IStockQuoteRequest, IStockBatchQuoteRequest } from '../interfaces/stockprice.js';
+
+/**
+ * Marketstack API v2 Provider
+ * Documentation: https://marketstack.com/documentation_v2
+ *
+ * Features:
+ * - End-of-Day (EOD) stock prices
+ * - Supports 125,000+ tickers across 72+ exchanges worldwide
+ * - Requires API key authentication
+ *
+ * Rate Limits:
+ * - Free Plan: 100 requests/month (EOD only)
+ * - Basic Plan: 10,000 requests/month
+ * - Professional Plan: 100,000 requests/month
+ *
+ * Note: This provider returns EOD data, not real-time prices
+ */
+export class MarketstackProvider implements IStockProvider {
+  public name = 'Marketstack';
+  public priority = 80; // Lower than Yahoo (100) due to rate limits and EOD-only data
+  public readonly requiresAuth = true;
+  public readonly rateLimit = {
+    requestsPerMinute: undefined, // No per-minute limit specified
+    requestsPerDay: undefined // Varies by plan
+  };
+
+  private logger = console;
+  private baseUrl = 'https://api.marketstack.com/v2';
+  private apiKey: string;
+
+  constructor(apiKey: string, private config?: IProviderConfig) {
+    if (!apiKey) {
+      throw new Error('API key is required for Marketstack provider');
+    }
+
+    this.apiKey = apiKey;
+  }
+
+  /**
+   * Fetch latest EOD price for a single ticker
+   */
+  public async fetchPrice(request: IStockQuoteRequest): Promise<IStockPrice> {
+    try {
+      const url = `${this.baseUrl}/tickers/${request.ticker}/eod/latest?access_key=${this.apiKey}`;
+
+      const response = await plugins.smartrequest.SmartRequest.create()
+        .url(url)
+        .timeout(this.config?.timeout || 10000)
+        .get();
+
+      const responseData = await response.json() as any;
+
+      // Check for API errors
+      if (responseData.error) {
+        throw new Error(`Marketstack API error: ${responseData.error.message || JSON.stringify(responseData.error)}`);
+      }
+
+      // For single ticker endpoint, response is direct object (not wrapped in data field)
+      if (!responseData || !responseData.close) {
+        throw new Error(`No data found for ticker ${request.ticker}`);
+      }
+
+      return this.mapToStockPrice(responseData);
+    } catch (error) {
+      this.logger.error(`Failed to fetch price for ${request.ticker}:`, error);
+      throw new Error(`Marketstack: Failed to fetch price for ${request.ticker}: ${error.message}`);
+    }
+  }
+
+  /**
+   * Fetch latest EOD prices for multiple tickers
+   */
+  public async fetchPrices(request: IStockBatchQuoteRequest): Promise<IStockPrice[]> {
+    try {
+      const symbols = request.tickers.join(',');
+      const url = `${this.baseUrl}/eod/latest?access_key=${this.apiKey}&symbols=${symbols}`;
+
+      const response = await plugins.smartrequest.SmartRequest.create()
+        .url(url)
+        .timeout(this.config?.timeout || 15000)
+        .get();
+
+      const responseData = await response.json() as any;
+
+      // Check for API errors
+      if (responseData.error) {
+        throw new Error(`Marketstack API error: ${responseData.error.message || JSON.stringify(responseData.error)}`);
+      }
+
+      if (!responseData?.data || !Array.isArray(responseData.data)) {
+        throw new Error('Invalid response format from Marketstack API');
+      }
+
+      const prices: IStockPrice[] = [];
+
+      for (const data of responseData.data) {
+        try {
+          prices.push(this.mapToStockPrice(data));
+        } catch (error) {
+          this.logger.warn(`Failed to parse data for ${data.symbol}:`, error);
+          // Continue processing other tickers
+        }
+      }
+
+      if (prices.length === 0) {
+        throw new Error('No valid price data received from batch request');
+      }
+
+      return prices;
+    } catch (error) {
+      this.logger.error(`Failed to fetch batch prices:`, error);
+      throw new Error(`Marketstack: Failed to fetch batch prices: ${error.message}`);
+    }
+  }
+
+  /**
+   * Check if the Marketstack API is available and accessible
+   */
+  public async isAvailable(): Promise<boolean> {
+    try {
+      // Test with a well-known ticker
+      const url = `${this.baseUrl}/tickers/AAPL/eod/latest?access_key=${this.apiKey}`;
+
+      const response = await plugins.smartrequest.SmartRequest.create()
+        .url(url)
+        .timeout(5000)
+        .get();
+
+      const responseData = await response.json() as any;
+
+      // Check if we got valid data (not an error)
+      // Single ticker endpoint returns direct object, not wrapped in data field
+      return !responseData.error && responseData.close !== undefined;
+    } catch (error) {
+      this.logger.warn('Marketstack provider is not available:', error);
+      return false;
+    }
+  }
+
+  /**
+   * Check if a market is supported
+   * Marketstack supports 72+ exchanges worldwide
+   */
+  public supportsMarket(market: string): boolean {
+    // Marketstack has broad international coverage including:
+    // US, UK, DE, FR, JP, CN, HK, AU, CA, IN, etc.
+    const supportedMarkets = [
+      'US', 'UK', 'GB', 'DE', 'FR', 'JP', 'CN', 'HK', 'AU', 'CA',
+      'IN', 'BR', 'MX', 'IT', 'ES', 'NL', 'SE', 'CH', 'NO', 'DK'
+    ];
+    return supportedMarkets.includes(market.toUpperCase());
+  }
+
+  /**
+   * Check if a ticker format is supported
+   */
+  public supportsTicker(ticker: string): boolean {
+    // Basic validation - Marketstack supports most standard ticker formats
+    return /^[A-Z0-9\.\-]{1,10}$/.test(ticker.toUpperCase());
+  }
+
+  /**
+   * Map Marketstack API response to IStockPrice interface
+   */
+  private mapToStockPrice(data: any): IStockPrice {
+    if (!data.close) {
+      throw new Error('Missing required price data');
+    }
+
+    // Calculate change and change percent
+    // EOD data: previous close is typically open price of the same day
+    // For better accuracy, we'd need previous day's close, but that requires another API call
+    const currentPrice = data.close;
+    const previousClose = data.open;
+    const change = currentPrice - previousClose;
+    const changePercent = previousClose !== 0 ? (change / previousClose) * 100 : 0;
+
+    // Parse timestamp
+    const timestamp = data.date ? new Date(data.date) : new Date();
+
+    const stockPrice: IStockPrice = {
+      ticker: data.symbol.toUpperCase(),
+      price: currentPrice,
+      currency: data.price_currency || 'USD',
+      change: change,
+      changePercent: changePercent,
+      previousClose: previousClose,
+      timestamp: timestamp,
+      provider: this.name,
+      marketState: 'CLOSED', // EOD data is always for closed markets
+      exchange: data.exchange,
+      exchangeName: data.exchange_code || data.name
+    };
+
+    return stockPrice;
+  }
+}