valr-typescript-client 1.0.25 → 1.0.27

package/CHECKSUMS.txt

@@ -1,50 +1,50 @@
 # Package Checksums
 
-Generated on: 2026-01-25 20:24:36 UTC
-Git commit: 71d1f6f99b44476aed1b0c667eb073e5cd33879f
-Version: 1.0.25
+Generated on: 2026-02-11 12:21:44 UTC
+Git commit: a006c6397ad1e8885042999423f37d8fcb7cd549
+Version: 1.0.27
 
 ## Distribution Files (SHA256)
 
-1ad514030f226670c9a3876382d2bf55bd17a8060af8bb8806ae053fc190fe72  dist/index.js
-4d39c0f55fdce6fead26a5de898a9f8fa96a49816ba6fcc4e229c08c9552630e  dist/index.d.mts
-4d39c0f55fdce6fead26a5de898a9f8fa96a49816ba6fcc4e229c08c9552630e  dist/index.d.ts
-7aee38224d434e0960cd922e3ea005730696262bcd1ca39eddf9683644695133  dist/index.mjs
-a5a707a70fa00165f23c389b8b5725adc574e02838763686611b18548c340861  dist/index.mjs.map
-e8e86091f42adbc55f0ff1b71d2456d5e8a60ba1eff6a5fec75ff298228764aa  dist/index.js.map
+4c56356d6d46f7061cb69196272a932c98b2664d0d63420834cb1335eb074667  dist/index.js.map
+6535b8c4a4557ad6bb77aa7c330a92ca63b7f49a5e770e1fdc090f366c582b19  dist/index.d.mts
+6535b8c4a4557ad6bb77aa7c330a92ca63b7f49a5e770e1fdc090f366c582b19  dist/index.d.ts
+8bf4f137d4459b0b15039dacab1833448c112894ac66cd2d25a66db9eaf43077  dist/index.mjs.map
+b0efcc098e3f3a8051349fdba6815896cf29fd536e849e355436cd67a63277fd  dist/index.mjs
+c3d911e9c094a2955e4e81805aa7a7ed929c7c5c091ba24725b4b91e4b102abc  dist/index.js
 
 ## Source Files (SHA256)
 
-05cf6e982fcbd24cebc6c1b4c6e366095859cdf503eb70f5faf4d9bb9844631a  src/client/ValrClient.ts
 0705454404aa0e0f2ce619615600d871c8052ac0afe495bb412219d9a6c032ac  src/types/public.ts
 07451545d78e896ab106b594151b4b9a3ae5ca4a2328914b2040a67cec403270  src/types/margin.ts
 0b4530d458e0c3bbadb79566943ef466404215e545f25c4965c72d9bfeee86dc  src/api/health.ts
+0da8bec4137e840f560cc7b0bd8a66f282111bea693c99a750c496f5cbd07f35  src/client/TradeWebSocket.ts
 13c4319ae883c96f779ea57f481c52f2298397e11950213f7d43a05290f42e8a  src/api/trading.ts
 15ef50a824d04e4466a4e34c29b54429c4d36e64d15eed1374c7165452da3abf  src/api/loans.ts
 174ffc46347008d3f473af1916e8b1b38fb9752e68a69776df831dca676a1342  src/api/public.ts
+1877f970ead05ec2f776b2c1a373e22d6b1748cb8e16543d8422eb08b8737185  src/client/ValrClient.ts
 1b2b9d2ae756384d9495e833dfa77d77f7b69da31a710dbb1bcdb7f688caace7  src/types/account.ts
 392124cca58a1532bd57472ba574bc065052c552ea8f10b7c675c942310c67e8  src/api/wallets.ts
 39fd4908c74bcca8c4e74a3a4e16de4439dfca781a7644ca9383c5f5096744cf  src/types/futures.ts
 3e5ff90a945e12f321b0e7a5bdef82f95e0b04f6ba794eeed9d4887d80d50323  src/api/pay.ts
-40f2245b2685e634bd0f531367561c1c26d174cc083c496c1f914e8c6a9f948a  src/client/ValrWebSocketClient.ts
 4202fe777fda3e43ff944971783116f17031d124395e4a44cb2bf2bec5ff246c  src/types/bundles.ts
 43ce3b42153a2e1a2d290ea893507c820e4461eb2162b1ccfa0d832118468618  src/api/margin.ts
 4e77e25219e1d4c7552ffc6b561493e33fb179c31fc9eaf456a304e7d7055552  src/api/account.ts
 551aa287e635dad4d0209502a0410f09c169715a5bac95366a875038c3e50504  src/api/futures.ts
 5572db3151cd4db275a7ac6e8a8859e3c9048e0bd873a113f445139c0db2017c  src/api/bundles.ts
+56848fb83b06ee2264c2a5197dc641d5b28513aee2c097cdcbf8ed1db3cdf271  src/client/AccountWebSocket.ts
 593e9b1515cb7e1316feae0cf24a9300b879284677c5e790e650502b32c70706  src/types/websocket.ts
+5a6cc3f289263a8d68c4dbe1d23be4c686676a81975b8eb3d49c4445903929e8  src/utils/http.ts
 5f68ae1d81c72d13f5c4c2b16d6c45e89500b069b84f3cf788f97b313790e8cf  src/types/index.ts
 612b1e543d1bbd97b75e814fa7d9b4ff4b1786f6b3671a03019917049e38a96e  src/types/stake.ts
+63fcafb0d6345bf76bb677a12cb679b621e40bc148ef1865e77495fc49f0f9b3  src/client/ValrWebSocketClient.ts
 6ec43e250aca38bc6a9dc4f16e5fe7e6ca25bd831270c5d02c1bc82d79f5731d  src/types/loans.ts
 70636220daed500243e5cd40d25748efcd401a9ff50f4237fa200bce1fe3be38  src/errors/ValrError.ts
 a1227a733cc2ab864023614a826d8c174464d6dd5390eb8820ed616c596be0d1  src/types/trading.ts
 a52c483def6de035f7fcf690b6102129ea22cb817bed5a106d3617c8edc7d849  src/api/stake.ts
-c235e305ae167ebe7b97944fb50df66df428cf7b4776aacab57f6c4d6083cf40  src/utils/http.ts
 dc9ef99ff3979f5dd0f0fc7231f9a6b9418dd13e0e8961511af1c9d54200576e  src/types/pay.ts
 e4cd666eff2f4223850198ca26912d310298291cfe0606a773350df3b3f58c59  src/types/common.ts
 ec209b0ff8de8e662c2ea701feccee22b53e6ed684affb3eacd39e68c3aa725a  src/index.ts
 f67a6c69ed003a1606221e792de802592aedb7164cafb7d7d2eab4fac105807a  src/utils/constants.ts
-f819d431730bb51a23d2cad32cc6eee83dc9d917e5cb9efd3201ffeb64d76ec5  src/client/AccountWebSocket.ts
 fadae797586481848494b79e9924ecc1e6fabc19a154d822579ffa2065d395fd  src/auth/RequestSigner.ts
-fe3ced400781e287f691c1262b48ea5005d21b45f69172a8a03b470e14c63a6e  src/client/TradeWebSocket.ts
 fe8bec28add01e200bd95ad326a0511334671b3a82a3990d2ee521adca7a7a8e  src/types/wallets.ts

package/README.md

@@ -1,36 +1,114 @@
-# VALR TypeScript Client
-
-A comprehensive, fully-typed TypeScript/JavaScript client for the [VALR](https://www.valr.com) cryptocurrency exchange API.
-
-## Features
-
-- ✅ **Full TypeScript Support** - Complete type definitions for all endpoints and responses
-- ✅ **Comprehensive API Coverage** - All 147 REST endpoints implemented
-- ✅ **WebSocket Support** - Real-time market data and account updates (coming soon)
-- ✅ **Modern Architecture** - Built with axios, supports both ESM and CommonJS
-- ✅ **Automatic Authentication** - HMAC SHA512 request signing handled automatically
-- ✅ **Error Handling** - Custom error classes for different error types
-- ✅ **Rate Limit Aware** - Built-in awareness of VALR API rate limits
-- ✅ **Subaccount Support** - Easy subaccount impersonation
-
-## Installation
-
+# VALR API TypeScript Client | Official SDK for VALR Cryptocurrency Exchange
+
+[![npm version](https://img.shields.io/npm/v/valr-typescript-client.svg)](https://www.npmjs.com/package/valr-typescript-client)
+[![npm downloads](https://img.shields.io/npm/dm/valr-typescript-client.svg)](https://www.npmjs.com/package/valr-typescript-client)
+[![GitHub license](https://img.shields.io/github/license/yashutanna/valr-typescript-client.svg)](https://github.com/yashutanna/valr-typescript-client/blob/master/LICENSE)
+[![TypeScript](https://img.shields.io/badge/TypeScript-100%25-blue.svg)](https://www.typescriptlang.org/)
+[![Node.js Version](https://img.shields.io/node/v/valr-typescript-client.svg)](https://nodejs.org/)
+
+**Official TypeScript/JavaScript SDK for [VALR](https://www.valr.com) API** - South Africa's leading cryptocurrency exchange platform.
+
+Complete, fully-typed REST API client for VALR cryptocurrency exchange. Build Bitcoin, Ethereum, and altcoin trading bots with comprehensive TypeScript support. Perfect for algorithmic trading, portfolio management, and crypto automation.
+
+## 🚀 Perfect For
+
+- **Trading Bots** - Automate your crypto trading strategies
+- **Portfolio Management** - Track and manage multiple wallets
+- **Algorithmic Trading** - Build sophisticated trading algorithms
+- **Market Analysis** - Access real-time market data and order books
+- **DeFi Integration** - Connect VALR to your DeFi applications
+- **Crypto Automation** - Automate deposits, withdrawals, and transfers
+
+## ✨ Features
+
+### Trading & Markets
+- ✅ **Spot Trading** - Buy/sell Bitcoin, Ethereum, and 50+ cryptocurrencies
+- ✅ **Futures Trading** - Perpetual futures contracts with up to 60x leverage
+- ✅ **Margin Trading** - Trade with borrowed funds
+- ✅ **Batch Orders** - Submit up to 10 orders in a single request
+- ✅ **Advanced Orders** - Stop-limit, post-only, reduce-only orders
+- ✅ **Conditional Orders** - Take-profit and stop-loss automation
+
+### TypeScript & Developer Experience
+- ✅ **100% TypeScript** - Complete type definitions for all API endpoints
+- ✅ **IntelliSense Support** - Auto-completion in VS Code and IDEs
+- ✅ **Type-Safe Requests** - Compile-time validation of all API calls
+- ✅ **ESM & CommonJS** - Works with modern and legacy Node.js projects
+- ✅ **Zero Dependencies** - Minimal dependency footprint
+
+### API Coverage
+- ✅ **147+ REST Endpoints** - Complete VALR API implementation
+- ✅ **WebSocket Support** - Real-time market data and account updates
+- ✅ **Public APIs** - Market data, order books, trade history (no auth required)
+- ✅ **Account APIs** - Balances, transaction history, API key management
+- ✅ **Wallet APIs** - Crypto/fiat deposits and withdrawals
+
+### Security & Reliability
+- ✅ **HMAC SHA512 Authentication** - Industry-standard request signing
+- ✅ **Automatic Signature Generation** - No manual crypto operations needed
+- ✅ **Rate Limit Handling** - Built-in rate limit awareness
+- ✅ **Error Types** - Typed error classes for all failure scenarios
+- ✅ **Subaccount Support** - Manage multiple trading accounts
+
+### Package Integrity
+- ✅ **Cryptographic Checksums** - SHA256 verification for all builds
+- ✅ **Reproducible Builds** - Build from source with verification
+- ✅ **Supply Chain Security** - GitHub Actions provenance attestation
+
+## 🪙 Supported Cryptocurrencies
+
+Trade 50+ cryptocurrencies including:
+- **Bitcoin (BTC)** - BTC/ZAR, BTC/USDC, BTC/USDT pairs
+- **Ethereum (ETH)** - ETH/ZAR, ETH/USDC, ETH/BTC pairs
+- **Major Altcoins** - XRP, ADA, DOT, LINK, MATIC, SOL, AVAX, UNI
+- **Stablecoins** - USDC, USDT, DAI
+- **DeFi Tokens** - AAVE, SNX, COMP, MKR, YFI
+- **Meme Coins** - DOGE, SHIB
+- **Perpetual Futures** - BTC-PERP, ETH-PERP, and more
+
+Full list at [VALR Markets](https://www.valr.com/markets)
+
+## 📦 Installation
+
+### npm
 ```bash
 npm install valr-typescript-client
 ```
 
-or
-
+### yarn
 ```bash
 yarn add valr-typescript-client
 ```
 
-or
-
+### pnpm
 ```bash
 pnpm add valr-typescript-client
 ```
 
+### bun
+```bash
+bun add valr-typescript-client
+```
+
+## 📚 Table of Contents
+
+- [Quick Start](#-quick-start)
+  - [Public API (No Authentication)](#public-api-no-authentication-required)
+  - [Authenticated Trading](#authenticated-api)
+  - [Advanced Trading Examples](#advanced-trading)
+- [API Categories](#api-categories)
+- [Authentication & Security](#authentication)
+- [TypeScript Support](#typescript-support)
+- [Error Handling](#error-handling)
+- [Rate Limits](#rate-limits)
+- [Examples](#examples)
+  - [Trading Bots](#trading-bot-example)
+  - [Portfolio Tracking](#portfolio-tracking-example)
+  - [Market Analysis](#market-analysis-example)
+- [Package Verification](#package-integrity--verification)
+- [Development](#development)
+- [Contributing](#contributing)
+
 ## Quick Start
 
 ### Public API (No Authentication Required)
@@ -198,6 +276,122 @@ client.setSubaccountId('different-subaccount-id');
 client.setSubaccountId(undefined); // Back to primary account
 ```
 
+## 💡 Examples
+
+### Trading Bot Example
+
+Build a simple Bitcoin DCA (Dollar Cost Averaging) bot:
+
+```typescript
+import { ValrClient } from 'valr-typescript-client';
+
+const client = new ValrClient({
+  apiKey: process.env.VALR_API_KEY!,
+  apiSecret: process.env.VALR_API_SECRET!,
+});
+
+// DCA Bot - Buy R1000 worth of BTC every day
+async function dcaBot() {
+  try {
+    // Get current BTC price
+    const ticker = await client.public.getMarketSummary('BTCZAR');
+    console.log(`Current BTC price: R${ticker[0].lastTradedPrice}`);
+
+    // Place market buy order for R1000
+    const order = await client.trading.placeMarketOrder({
+      pair: 'BTCZAR',
+      side: 'BUY',
+      quoteAmount: '1000', // Spend R1000
+    });
+
+    console.log(`Bought BTC: Order ID ${order.id}`);
+  } catch (error) {
+    console.error('DCA bot error:', error);
+  }
+}
+
+// Run daily at 9 AM
+setInterval(dcaBot, 24 * 60 * 60 * 1000);
+```
+
+### Portfolio Tracking Example
+
+Track your crypto portfolio value:
+
+```typescript
+import { ValrClient } from 'valr-typescript-client';
+
+const client = new ValrClient({
+  apiKey: process.env.VALR_API_KEY!,
+  apiSecret: process.env.VALR_API_SECRET!,
+});
+
+async function getPortfolioValue() {
+  // Get all balances
+  const balances = await client.account.getBalances();
+
+  // Get ZAR prices for all assets
+  const markets = await client.public.getMarketSummary();
+
+  let totalValue = 0;
+
+  for (const balance of balances) {
+    if (parseFloat(balance.total) === 0) continue;
+
+    if (balance.currency === 'ZAR') {
+      totalValue += parseFloat(balance.total);
+    } else {
+      // Find ZAR pair for this currency
+      const pair = `${balance.currency}ZAR`;
+      const market = markets.find(m => m.currencyPair === pair);
+
+      if (market) {
+        const value = parseFloat(balance.total) * parseFloat(market.lastTradedPrice);
+        totalValue += value;
+        console.log(`${balance.currency}: ${balance.total} = R${value.toFixed(2)}`);
+      }
+    }
+  }
+
+  console.log(`\nTotal Portfolio Value: R${totalValue.toFixed(2)}`);
+  return totalValue;
+}
+
+getPortfolioValue();
+```
+
+### Market Analysis Example
+
+Analyze Bitcoin order book depth:
+
+```typescript
+import { ValrClient } from 'valr-typescript-client';
+
+const client = new ValrClient();
+
+async function analyzeOrderBook() {
+  const orderBook = await client.public.getOrderBook('BTCZAR');
+
+  // Calculate bid/ask depth
+  const bidDepth = orderBook.Bids.reduce((sum, bid) =>
+    sum + parseFloat(bid.quantity), 0
+  );
+  const askDepth = orderBook.Asks.reduce((sum, ask) =>
+    sum + parseFloat(ask.quantity), 0
+  );
+
+  const bidAskRatio = bidDepth / askDepth;
+
+  console.log(`BTC/ZAR Order Book Analysis:`);
+  console.log(`Bid Depth: ${bidDepth.toFixed(4)} BTC`);
+  console.log(`Ask Depth: ${askDepth.toFixed(4)} BTC`);
+  console.log(`Bid/Ask Ratio: ${bidAskRatio.toFixed(2)}`);
+  console.log(`Market Sentiment: ${bidAskRatio > 1 ? 'Bullish' : 'Bearish'}`);
+}
+
+analyzeOrderBook();
+```
+
 ## API Categories
 
 The client organizes endpoints into logical categories:
@@ -442,28 +636,56 @@ npm run test:watch
 npm run type-check
 ```
 
-## Contributing
+## 🤝 Contributing
 
-Contributions are welcome! Please feel free to submit a Pull Request.
+Contributions are welcome! We're looking for:
 
-## License
+- 🐛 Bug fixes and issue reports
+- 📝 Documentation improvements
+- ✨ New feature implementations
+- 🧪 Additional test coverage
+- 🌍 Internationalization support
 
-MIT
+Please feel free to submit a Pull Request or open an issue.
 
-## Links
+### Development Setup
 
-- [VALR Website](https://www.valr.com)
-- [VALR API Documentation](https://docs.valr.com)
-- [GitHub Repository](https://github.com/yourusername/valr-typescript-client)
-- [NPM Package](https://www.npmjs.com/package/valr-typescript-client)
+```bash
+git clone https://github.com/yashutanna/valr-typescript-client.git
+cd valr-typescript-client
+npm install
+npm run build
+npm test
+```
 
-## Disclaimer
+## 🔗 Links & Resources
 
-This is an unofficial client library and is not affiliated with or endorsed by VALR. Use at your own risk.
+- **📦 [NPM Package](https://www.npmjs.com/package/valr-typescript-client)** - Install from npm
+- **💻 [GitHub Repository](https://github.com/yashutanna/valr-typescript-client)** - Source code and issues
+- **📘 [VALR API Documentation](https://docs.valr.com)** - Official VALR API docs
+- **🌐 [VALR Exchange](https://www.valr.com)** - Trade on VALR
+- **📊 [VALR Markets](https://www.valr.com/markets)** - View all trading pairs
+- **💬 [VALR Support](https://support.valr.com)** - Official VALR support
 
-## Support
+## 🆘 Support & Issues
 
 For issues and questions:
 
-- [GitHub Issues](https://github.com/yourusername/valr-typescript-client/issues)
-- [VALR Support](https://support.valr.com)
+- **🐛 [Report a Bug](https://github.com/yashutanna/valr-typescript-client/issues)** - GitHub Issues
+- **💡 [Request a Feature](https://github.com/yashutanna/valr-typescript-client/issues)** - Feature requests
+- **📖 [Documentation](https://github.com/yashutanna/valr-typescript-client#readme)** - Full documentation
+- **💬 [VALR Support](https://support.valr.com)** - Official VALR help
+
+## 📜 License
+
+MIT License - see [LICENSE](LICENSE) file for details
+
+## ⚠️ Disclaimer
+
+This is an **unofficial** TypeScript client library for the VALR API. It is not affiliated with, endorsed by, or officially connected to VALR in any way. Use at your own risk.
+
+**Trading cryptocurrencies carries risk.** Only trade with funds you can afford to lose. This software is provided "as is" without warranty of any kind.
+
+## 🏷️ Keywords
+
+`valr api` `valr typescript` `valr javascript` `valr sdk` `valr client` `cryptocurrency trading` `bitcoin api` `ethereum api` `crypto exchange api` `south africa crypto` `trading bot` `algorithmic trading` `crypto automation` `typescript trading bot` `valr rest api` `valr websocket`

package/dist/index.d.mts

@@ -1,6 +1,5 @@
-import { AxiosRequestConfig, AxiosResponse, AxiosInstance } from 'axios';
 import WebSocket from 'ws';
-import EventEmitter from 'eventemitter3';
+import { EventEmitter } from 'node:events';
 
 /**
  * HTTP client configuration
@@ -11,31 +10,85 @@ interface HttpClientConfig {
     headers?: Record<string, string>;
 }
 /**
- * HTTP client wrapper for VALR API
+ * Request configuration (similar to AxiosRequestConfig for compatibility)
+ */
+interface RequestConfig {
+    headers?: Record<string, string>;
+    params?: Record<string, any>;
+    signal?: AbortSignal;
+    /** Request body data (for DELETE with body) */
+    data?: any;
+}
+/**
+ * Internal request configuration used by interceptors
+ */
+interface InternalRequestConfig {
+    method: string;
+    url: string;
+    headers: Record<string, string>;
+    params?: Record<string, any>;
+    data?: any;
+}
+/**
+ * Request interceptor function type
+ */
+type RequestInterceptor = (config: InternalRequestConfig) => InternalRequestConfig;
+/**
+ * Response wrapper (similar to AxiosResponse for compatibility)
+ */
+interface HttpResponse<T = any> {
+    data: T;
+    status: number;
+    statusText: string;
+    headers: Headers;
+}
+/**
+ * HTTP client wrapper for VALR API using native fetch
+ * Zero dependencies - uses Node.js built-in fetch (Node 18+)
  */
 declare class HttpClient {
-    private axiosInstance;
+    private baseURL;
+    private timeout;
+    private defaultHeaders;
+    private requestInterceptors;
     constructor(config?: HttpClientConfig);
+    /**
+     * Add a request interceptor
+     * Interceptors are called in order before each request
+     */
+    addRequestInterceptor(interceptor: RequestInterceptor): void;
+    /**
+     * Build full URL with query parameters
+     */
+    private buildUrl;
+    /**
+     * Execute HTTP request with error handling
+     */
+    private request;
+    /**
+     * Handle error responses and throw appropriate VALR errors
+     */
+    private handleErrorResponse;
     /**
      * Perform GET request
      */
-    get<T = any>(url: string, config?: AxiosRequestConfig): Promise<AxiosResponse<T>>;
+    get<T = any>(url: string, config?: RequestConfig): Promise<HttpResponse<T>>;
     /**
      * Perform POST request
      */
-    post<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<AxiosResponse<T>>;
+    post<T = any>(url: string, data?: any, config?: RequestConfig): Promise<HttpResponse<T>>;
     /**
      * Perform PUT request
      */
-    put<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<AxiosResponse<T>>;
+    put<T = any>(url: string, data?: any, config?: RequestConfig): Promise<HttpResponse<T>>;
     /**
      * Perform PATCH request
      */
-    patch<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<AxiosResponse<T>>;
+    patch<T = any>(url: string, data?: any, config?: RequestConfig): Promise<HttpResponse<T>>;
     /**
      * Perform DELETE request
      */
-    delete<T = any>(url: string, config?: AxiosRequestConfig): Promise<AxiosResponse<T>>;
+    delete<T = any>(url: string, config?: RequestConfig): Promise<HttpResponse<T>>;
     /**
      * Set default header
      */
@@ -44,10 +97,6 @@ declare class HttpClient {
      * Remove default header
      */
     removeHeader(key: string): void;
-    /**
-     * Get the underlying Axios instance
-     */
-    getInstance(): AxiosInstance;
 }
 
 /**
@@ -3640,6 +3689,10 @@ interface ValrClientConfig {
      * Subaccount ID for impersonating a subaccount (optional)
      */
     subaccountId?: string;
+    /**
+     * enable debug logging for the client requests, responses and configs. (optional default=false)
+      */
+    debug?: boolean;
 }
 /**
  * Main VALR API client
@@ -3663,6 +3716,7 @@ declare class ValrClient {
     private apiKey?;
     private apiSecret?;
     private subaccountId?;
+    private debug?;
     /**
      * Public API methods (no authentication required)
      */
@@ -3745,23 +3799,14 @@ interface WebSocketClientConfig {
     maxReconnectAttempts?: number;
     /** Base URL for WS (defaults to wss://api.valr.com) */
     baseURL?: string;
-}
-/**
- * WebSocket event types
- */
-interface WebSocketEvents {
-    connected: () => void;
-    authenticated: () => void;
-    message: (message: WebSocketMessage) => void;
-    error: (error: Error) => void;
-    close: (code: number, reason: string) => void;
-    disconnected: () => void;
-    reconnecting: (attempt: number) => void;
+    /** Enable debug logging for the client requests, responses and configs. either defined as true or not passed in */
+    debug?: boolean;
 }
 /**
  * Base WebSocket client for VALR API
+ * Uses Node.js native EventEmitter (zero dependencies)
  */
-declare abstract class ValrWebSocketClient<TEvents extends WebSocketEvents = WebSocketEvents> extends EventEmitter<TEvents> {
+declare abstract class ValrWebSocketClient extends EventEmitter {
     protected ws?: WebSocket;
     protected url: string;
     protected path: string;
@@ -3771,6 +3816,7 @@ declare abstract class ValrWebSocketClient<TEvents extends WebSocketEvents = Web
     protected isIntentionalClose: boolean;
     protected isConnected: boolean;
     protected isAuthenticated: boolean;
+    protected debug?: true;
     constructor(path: string, config?: WebSocketClientConfig);
     /**
      * Connect to WebSocket
@@ -3819,19 +3865,6 @@ declare abstract class ValrWebSocketClient<TEvents extends WebSocketEvents = Web
     protected abstract onMessage(message: WebSocketMessage): void;
 }
 
-/**
- * Account WebSocket events (in addition to base events)
- */
-interface AccountWebSocketEvents {
-    'order:processed': (data: OrderProcessed) => void;
-    'order:statusUpdate': (data: OrderStatusUpdate) => void;
-    'balance:update': (data: BalanceUpdate) => void;
-    'trade:new': (data: AccountTrade) => void;
-}
-/**
- * Combined event types for AccountWebSocket
- */
-type AccountWebSocketEventMap = WebSocketEvents & AccountWebSocketEvents;
 /**
  * Account WebSocket client for real-time account updates
  *
@@ -3867,7 +3900,7 @@ type AccountWebSocketEventMap = WebSocketEvents & AccountWebSocketEvents;
  * wsClient.connect();
  * ```
  */
-declare class AccountWebSocket extends ValrWebSocketClient<AccountWebSocketEventMap> {
+declare class AccountWebSocket extends ValrWebSocketClient {
     constructor(config: WebSocketClientConfig);
     /**
      * Subscribe to specific events
@@ -3891,18 +3924,6 @@ declare class AccountWebSocket extends ValrWebSocketClient<AccountWebSocketEvent
     protected onMessage(message: WebSocketMessage): void;
 }
 
-/**
- * Trade WebSocket events (in addition to base events)
- */
-interface TradeWebSocketEvents {
-    'orderbook:update': (data: OrderBookUpdate) => void;
-    'market:summary': (data: MarketSummaryUpdate) => void;
-    'trade:new': (data: NewTrade) => void;
-}
-/**
- * Combined event types for TradeWebSocket
- */
-type TradeWebSocketEventMap = WebSocketEvents & TradeWebSocketEvents;
 /**
  * Trade WebSocket client for real-time market data
  *
@@ -3934,7 +3955,7 @@ type TradeWebSocketEventMap = WebSocketEvents & TradeWebSocketEvents;
  * wsClient.connect();
  * ```
  */
-declare class TradeWebSocket extends ValrWebSocketClient<TradeWebSocketEventMap> {
+declare class TradeWebSocket extends ValrWebSocketClient {
     constructor(config?: WebSocketClientConfig);
     /**
      * Subscribe to aggregated order book updates for currency pairs