@pipsend/sdk 0.3.0 → 0.3.2

package/README.md

@@ -36,12 +36,12 @@ pnpm add @pipsend/sdk
 The SDK uses JWT-based authentication with automatic token refresh.
 
 ```typescript
-import { createClient } from '@pipsend/sdk';
+import { createClient } from "@pipsend/sdk";
 
 const client = createClient({
-  server: 'http://localhost:8080',
-  login: '1000',              // Your admin/API login
-  password: 'YourPassword'    // Your admin/API password
+  server: "http://localhost:8080",
+  login: "1000", // Your admin/API login
+  password: "YourPassword", // Your admin/API password
 });
 
 // The SDK automatically:
@@ -69,7 +69,7 @@ await client.logout();
 
 // Get current token info
 const tokenInfo = client.getTokenInfo();
-console.log('Token expires at:', tokenInfo?.expiresAt);
+console.log("Token expires at:", tokenInfo?.expiresAt);
 ```
 
 ---
@@ -77,45 +77,45 @@ console.log('Token expires at:', tokenInfo?.expiresAt);
 ## 🔧 Quick Start
 
 ```typescript
-import { createClient } from '@pipsend/sdk';
+import { createClient } from "@pipsend/sdk";
 
 // Create authenticated client
 const client = createClient({
-  server: 'http://localhost:8080',
-  login: '1000',
-  password: 'DemoMaster'
+  server: "http://localhost:8080",
+  login: "1000",
+  password: "DemoMaster",
 });
 
 const login = 50001;
 
 // List accounts with filters
 const accounts = await client.accounts.list({
-  state: 'active',
-  country: 'Mexico',
-  min_balance: 1000
+  state: "active",
+  country: "Mexico",
+  min_balance: 1000,
 });
 
 // Open a trade
 const trade = await client.trades.open({
   login,
-  symbol: 'EURUSD',
-  action: 'buy',
-  type: 'market',
+  symbol: "EURUSD",
+  action: "buy",
+  type: "market",
   volume: 1.0,
-  stop_loss: 1.0850,
-  take_profit: 1.0950
+  stop_loss: 1.085,
+  take_profit: 1.095,
 });
 
 // Get market data
 const candles = await client.marketData.getCandles({
-  symbol: 'BTCUSD',
-  timeframe: '1h',
-  limit: 100
+  symbol: "BTCUSD",
+  timeframe: "1h",
+  limit: 100,
 });
 
 // WebSocket real-time updates
 client.stream.onPriceUpdate((price) => {
-  console.log('Price update:', price);
+  console.log("Price update:", price);
 });
 
 await client.stream.connect();
@@ -130,32 +130,32 @@ Manage accounts with advanced filtering and statistics.
 ```typescript
 // Create a new trading account
 const newAccount = await client.accounts.create({
-  trading_group: 'Premium',
-  country: 'MX',
-  master_password: 'SecurePass123!',
-  investor_password: 'InvestorPass123!',
-  email: 'trader@example.com',
-  first_name: 'John',
-  last_name: 'Doe',
+  trading_group: "Premium",
+  country: "MX",
+  master_password: "SecurePass123!",
+  investor_password: "InvestorPass123!",
+  email: "trader@example.com",
+  first_name: "John",
+  last_name: "Doe",
   leverage: 100,
-  state: 'active'
+  state: "active",
 });
 
 // List accounts with filters
 const accounts = await client.accounts.list({
-  state: 'active',
-  country: 'Mexico,United States',
-  trading_group: 'Premium',
+  state: "active",
+  country: "Mexico,United States",
+  trading_group: "Premium",
   min_balance: 1000,
   max_balance: 50000,
   page: 1,
-  per_page: 20
+  per_page: 20,
 });
 
 // Get statistics with filters
 const stats = await client.accounts.getStatistics({
-  country: 'Mexico',
-  state: 'active'
+  country: "Mexico",
+  state: "active",
 });
 
 // Get all account logins
@@ -163,18 +163,15 @@ const logins = await client.accounts.getLogins();
 
 // Get account status/metrics (balance, equity, credit, margin)
 const status = await client.accounts.getStatus(50001);
-console.log('Balance:', status.data.balance);
-console.log('Equity:', status.data.equity);
-console.log('Credit:', status.data.credit);
-console.log('Margin:', status.data.margin);
+console.log("Balance:", status.data.balance);
+console.log("Equity:", status.data.equity);
+console.log("Credit:", status.data.credit);
+console.log("Margin:", status.data.margin);
 
-// Change passwords
-await client.accounts.changeMasterPassword(50001, {
-  new_password: 'NewPass123!'
-});
-
-await client.accounts.changeInvestorPassword(50001, {
-  new_password: 'InvestorPass123!'
+// Change passwords (master and/or investor)
+await client.accounts.changePassword(50001, {
+  master: "NewMasterPass123!",
+  investor: "NewInvestorPass123!",
 });
 
 // Archive/Unarchive
@@ -183,30 +180,30 @@ await client.accounts.unarchive(50001);
 
 // Update account information (partial update)
 await client.accounts.update(50001, {
-  email: 'newemail@example.com',
+  email: "newemail@example.com",
   leverage: 200,
-  city: 'Los Angeles',
-  trading_group: 'Premium'
+  city: "Los Angeles",
+  trading_group: "Premium",
 });
 
 // Adjust balance or credit
 await client.accounts.balance(50001, {
-  type: 'balance',
-  amount: 500.00,
-  comment: 'Client deposit'
+  type: "balance",
+  amount: 500.0,
+  comment: "Client deposit",
 });
 
 await client.accounts.balance(50001, {
-  type: 'credit',
-  amount: 1000.00,
-  comment: 'Credit line increase'
+  type: "credit",
+  amount: 1000.0,
+  comment: "Credit line increase",
 });
 
 // Subtract balance
 await client.accounts.balance(50001, {
-  type: 'balance',
-  amount: -200.00,
-  comment: 'Withdrawal request'
+  type: "balance",
+  amount: -200.0,
+  comment: "Withdrawal request",
 });
 ```
 
@@ -217,35 +214,35 @@ Manage pending orders with statistics and validation.
 ```typescript
 // List orders with advanced filters
 const orders = await client.orders.list({
-  login: '50001',
-  symbol: 'EURUSD,GBPUSD',
-  order_type: 'limit',
-  status: 'new,partial',
-  created_from: '2025-01-01T00:00:00Z',
-  created_to: '2025-01-31T23:59:59Z',
+  login: "50001",
+  symbol: "EURUSD,GBPUSD",
+  order_type: "limit",
+  status: "new,partial",
+  created_from: "2025-01-01T00:00:00Z",
+  created_to: "2025-01-31T23:59:59Z",
   price_min: 1.08,
-  price_max: 1.10,
-  sort_by: 'created_at',
-  sort_order: 'desc'
+  price_max: 1.1,
+  sort_by: "created_at",
+  sort_order: "desc",
 });
 
 // Get statistics grouped by symbol
 const stats = await client.orders.getStats({
-  login: '50001',
-  group_by: 'symbol'
+  login: "50001",
+  group_by: "symbol",
 });
 
 // Get totals by order type
 const totals = await client.orders.getTotals({
-  login: '50001',
-  group_by: 'order_type'
+  login: "50001",
+  group_by: "order_type",
 });
 
 // Update order
 await client.orders.update(12345, {
   login: 50001,
-  stop_loss: 1.0800,
-  take_profit: 1.0950
+  stop_loss: 1.08,
+  take_profit: 1.095,
 });
 
 // Delete order
@@ -255,8 +252,8 @@ await client.orders.delete(12345, { login: 50001 });
 const checkResult = await client.orders.check({
   filters: {
     logins: [50001],
-    statuses: ['new']
-  }
+    statuses: ["new"],
+  },
 });
 ```
 
@@ -267,31 +264,31 @@ Manage open positions with recalculation support.
 ```typescript
 // List positions with filters
 const positions = await client.positions.list({
-  login: '50001',
-  symbol: 'EURUSD',
-  state: 'open',
+  login: "50001",
+  symbol: "EURUSD",
+  state: "open",
   profit_min: 100,
-  profit_max: 1000
+  profit_max: 1000,
 });
 
 // Get statistics grouped by type
 const stats = await client.positions.getStats({
-  login: '50001',
-  state: 'open',
-  group_by: 'type'
+  login: "50001",
+  state: "open",
+  group_by: "type",
 });
 
 // Get totals by symbol
 const totals = await client.positions.getTotals({
-  login: '50001',
-  group_by: 'symbol'
+  login: "50001",
+  group_by: "symbol",
 });
 
 // Update position
 await client.positions.update(1, {
   login: 50001,
   stop_loss: 1.0875,
-  take_profit: 1.0975
+  take_profit: 1.0975,
 });
 
 // Delete position
@@ -301,8 +298,8 @@ await client.positions.delete(1, { login: 50001 });
 const checkResult = await client.positions.check({
   filters: {
     logins: [50001],
-    states: ['open']
-  }
+    states: ["open"],
+  },
 });
 ```
 
@@ -314,22 +311,22 @@ Execute trading operations with margin checking.
 // Check margin before trading
 const marginCheck = await client.trades.checkMargin({
   login: 50001,
-  symbol: 'EURUSD',
-  action: 'buy',
-  volume: 1.0
+  symbol: "EURUSD",
+  action: "buy",
+  volume: 1.0,
 });
 
 if (marginCheck.can_execute) {
   // Open trade
   const trade = await client.trades.open({
     login: 50001,
-    symbol: 'EURUSD',
-    action: 'buy',
-    type: 'market',
+    symbol: "EURUSD",
+    action: "buy",
+    type: "market",
     volume: 1.0,
-    stop_loss: 1.0850,
-    take_profit: 1.0950,
-    comment: 'API Trade'
+    stop_loss: 1.085,
+    take_profit: 1.095,
+    comment: "API Trade",
   });
 
   // Modify trade
@@ -337,17 +334,17 @@ if (marginCheck.can_execute) {
     login: 50001,
     position_id: trade.position_id,
     stop_loss: 1.0875,
-    take_profit: 1.0975
+    take_profit: 1.0975,
   });
 
   // Calculate potential profit
   const profitCalc = await client.trades.calculateProfit({
     login: 50001,
-    symbol: 'EURUSD',
-    action: 'buy',
+    symbol: "EURUSD",
+    action: "buy",
     volume: 1.0,
-    open_price: 1.0900,
-    close_price: 1.0950
+    open_price: 1.09,
+    close_price: 1.095,
   });
 
   // Close trade (partial or full)
@@ -355,20 +352,20 @@ if (marginCheck.can_execute) {
     login: 50001,
     position_id: trade.position_id,
     volume: 0.5, // Partial close
-    comment: 'Taking profit'
+    comment: "Taking profit",
   });
 }
 
 // Force price (for historical data import)
 const historicalTrade = await client.trades.open({
   login: 50001,
-  symbol: 'EURUSD',
-  action: 'buy',
-  type: 'market',
+  symbol: "EURUSD",
+  action: "buy",
+  type: "market",
   volume: 1.0,
-  price: 1.0850,
+  price: 1.085,
   force_price: true,
-  force_timestamp: '2025-01-15T10:30:00Z'
+  force_timestamp: "2025-01-15T10:30:00Z",
 });
 ```
 
@@ -379,37 +376,37 @@ Query historical market data (minimum 1 hour old).
 ```typescript
 // Get candles with filters
 const candles = await client.marketData.getCandles({
-  symbol: 'BTCUSD,ETHUSD',
-  timeframe: '1h',
-  from: '2025-01-01T00:00:00Z',
-  to: '2025-01-02T00:00:00Z',
+  symbol: "BTCUSD,ETHUSD",
+  timeframe: "1h",
+  from: "2025-01-01T00:00:00Z",
+  to: "2025-01-02T00:00:00Z",
   min_volume: 1000,
   max_volume: 50000,
-  sort: 'volume',
-  order: 'desc',
-  limit: 100
+  sort: "volume",
+  order: "desc",
+  limit: 100,
 });
 
 // Get last 100 candles
 const recentCandles = await client.marketData.getCandles({
-  symbol: 'BTCUSD',
-  timeframe: '1m',
+  symbol: "BTCUSD",
+  timeframe: "1m",
   limit: 100,
-  order: 'desc'
+  order: "desc",
 });
 
 // Get symbols with filters
 const symbols = await client.marketData.getSymbols({
-  group: 'CRYPTO_MAJOR',
+  group: "CRYPTO_MAJOR",
   has_data: true,
-  search: 'bitcoin'
+  search: "bitcoin",
 });
 
 // Get groups hierarchy
 const groups = await client.marketData.getGroups({
   root_only: true,
-  sort: 'symbol_count',
-  order: 'desc'
+  sort: "symbol_count",
+  order: "desc",
 });
 ```
 
@@ -425,7 +422,7 @@ Manage trading groups and their statistics.
 // List trading groups
 const groups = await client.tradingGroups.list({
   page: 1,
-  per_page: 20
+  per_page: 20,
 });
 
 // Get statistics
@@ -439,13 +436,13 @@ Real-time updates for positions and balance with manual channel subscription.
 ```typescript
 // Enable WebSocket in config
 const client = createClient({
-  server: 'http://localhost:8080',
-  login: '1000',
-  password: 'DemoMaster',
+  server: "http://localhost:8080",
+  login: "1000",
+  password: "DemoMaster",
   websocket: {
     enabled: true,
-    autoConnect: false
-  }
+    autoConnect: false,
+  },
 });
 
 // Connect to WebSocket
@@ -453,49 +450,56 @@ await client.stream.connect();
 
 // Subscribe to channels
 client.stream.subscribe([
-  'positions:new',      // New positions opened
-  'positions:closed',   // Positions closed (total and partial)
-  'positions:updated',  // Position PnL updates (throttled to 1 per 2s)
-  'accounts:balance'    // Balance updates
+  "positions:new", // New positions opened
+  "positions:closed", // Positions closed (total and partial)
+  "positions:updated", // Position PnL updates (throttled to 1 per 2s)
+  "accounts:balance", // Balance updates
 ]);
 
 // Listen to position opened events
 client.stream.onPositionOpened((event) => {
   const pos = event.position;
-  console.log('Position opened:', pos.symbol, pos.side === 1 ? 'LONG' : 'SHORT', pos.qty);
+  console.log(
+    "Position opened:",
+    pos.symbol,
+    pos.side === 1 ? "LONG" : "SHORT",
+    pos.qty,
+  );
 });
 
 // Listen to position closed events
 client.stream.onPositionClosed((event) => {
   const pos = event.position;
-  console.log('Position closed:', pos.symbol, 'PnL:', pos.net_pnl);
+  console.log("Position closed:", pos.symbol, "PnL:", pos.net_pnl);
 });
 
 // Listen to position updated events (throttled)
 client.stream.onPositionUpdated((event) => {
   const pos = event.position;
-  console.log('Position update:', pos.position_id, 'PnL:', pos.unrealized_pnl);
+  console.log("Position update:", pos.position_id, "PnL:", pos.unrealized_pnl);
 });
 
 // Listen to balance updates
 client.stream.onBalanceUpdated((event) => {
-  console.log('Balance:', event.balance, 'Equity:', event.equity);
+  console.log("Balance:", event.balance, "Equity:", event.equity);
 });
 
 // Unsubscribe from channels
-client.stream.unsubscribe(['positions:updated']);
+client.stream.unsubscribe(["positions:updated"]);
 
 // Disconnect
 client.stream.disconnect();
 ```
 
 **Available Channels**:
+
 - `positions:new` - New position opened
 - `positions:closed` - Position closed (total or partial)
 - `positions:updated` - PnL updates (throttled to max 1 per 2 seconds)
 - `accounts:balance` - Balance changes
 
 **Features**:
+
 - Manual subscription to specific channels
 - Auto-reconnect with exponential backoff
 - Heartbeat/ping-pong mechanism
@@ -504,15 +508,21 @@ client.stream.disconnect();
 
 See [WebSocket API Documentation](docs/WEBSOCKET_API.md) for complete guide.
 
-## 🔧 Configuration
+## � Documentation
+
+- **[Positions & Trading Guide](docs/POSITIONS_TRADING.md)** - Complete guide for opening, closing, and modifying positions (SL/TP)
+- **[WebSocket API](docs/WEBSOCKET_API.md)** - Real-time updates and streaming data
+- **[Authentication](AUTHENTICATION.md)** - Authentication system and token management
+
+## �🔧 Configuration
 
 ### Basic Configuration
 
 ```typescript
 const client = createClient({
-  server: 'http://localhost:8080',  // Required: API server URL
-  login: '1000',                     // Required: Admin/API login
-  password: 'YourPassword'           // Required: Admin/API password
+  server: "http://localhost:8080", // Required: API server URL
+  login: "1000", // Required: Admin/API login
+  password: "YourPassword", // Required: Admin/API password
 });
 ```
 
@@ -520,39 +530,40 @@ const client = createClient({
 
 ```typescript
 const client = createClient({
-  server: 'http://localhost:8080',
-  login: '1000',
-  password: 'YourPassword',
-  
+  server: "http://localhost:8080",
+  login: "1000",
+  password: "YourPassword",
+
   // WebSocket configuration (optional)
   websocket: {
-    enabled: true,              // Enable WebSocket support
-    autoConnect: false,         // Auto-connect on client creation
-    autoReconnect: true,        // Auto-reconnect on disconnect
-    maxReconnectAttempts: 5,    // Max reconnection attempts
-    heartbeatInterval: 30000    // Heartbeat interval in ms
-  }
+    enabled: true, // Enable WebSocket support
+    autoConnect: false, // Auto-connect on client creation
+    autoReconnect: true, // Auto-reconnect on disconnect
+    maxReconnectAttempts: 5, // Max reconnection attempts
+    heartbeatInterval: 30000, // Heartbeat interval in ms
+  },
 });
 ```
 
 ### Configuration Options
 
-| Option | Type | Required | Default | Description |
-|--------|------|----------|---------|-------------|
-| `server` | string | ✅ Yes | - | Pipsend API server URL |
-| `login` | string | ✅ Yes | - | Admin/API login for authentication |
-| `password` | string | ✅ Yes | - | Admin/API password |
-| `websocket.enabled` | boolean | No | `false` | Enable WebSocket support |
-| `websocket.autoConnect` | boolean | No | `false` | Auto-connect on creation |
-| `websocket.autoReconnect` | boolean | No | `true` | Auto-reconnect on disconnect |
-| `websocket.maxReconnectAttempts` | number | No | `5` | Max reconnection attempts |
-| `websocket.heartbeatInterval` | number | No | `30000` | Heartbeat interval (ms) |
+| Option                           | Type    | Required | Default | Description                        |
+| -------------------------------- | ------- | -------- | ------- | ---------------------------------- |
+| `server`                         | string  | ✅ Yes   | -       | Pipsend API server URL             |
+| `login`                          | string  | ✅ Yes   | -       | Admin/API login for authentication |
+| `password`                       | string  | ✅ Yes   | -       | Admin/API password                 |
+| `websocket.enabled`              | boolean | No       | `false` | Enable WebSocket support           |
+| `websocket.autoConnect`          | boolean | No       | `false` | Auto-connect on creation           |
+| `websocket.autoReconnect`        | boolean | No       | `true`  | Auto-reconnect on disconnect       |
+| `websocket.maxReconnectAttempts` | number  | No       | `5`     | Max reconnection attempts          |
+| `websocket.heartbeatInterval`    | number  | No       | `30000` | Heartbeat interval (ms)            |
 
 ## 📦 API Response Structure
 
 All API endpoints return a consistent response structure:
 
 ### Success Response (without pagination)
+
 ```typescript
 {
   status: "success",
@@ -562,6 +573,7 @@ All API endpoints return a consistent response structure:
 ```
 
 ### Success Response (with pagination)
+
 ```typescript
 {
   status: "success",
@@ -579,6 +591,7 @@ All API endpoints return a consistent response structure:
 ```
 
 ### Error Response
+
 ```typescript
 {
   status: "error",
@@ -596,10 +609,12 @@ All API endpoints return a consistent response structure:
 ### Common Status Codes
 
 **Success:**
+
 - `SUCCESS` - Operation successful
 - `CREATED` - Resource created successfully
 
 **Errors:**
+
 - `VALIDATION_ERROR` (400) - Invalid parameters
 - `BAD_REQUEST` (400) - Invalid request
 - `UNAUTHORIZED` (401) - Authentication required
@@ -609,6 +624,7 @@ All API endpoints return a consistent response structure:
 - `INTERNAL_ERROR` (500) - Server error
 
 **Market Data Specific:**
+
 - `SYMBOL_NOT_FOUND` (404) - Symbol not found
 - `INVALID_TIMEFRAME` (400) - Invalid timeframe
 - `TIME_RANGE_TOO_LARGE` (400) - Time range exceeds maximum
@@ -619,21 +635,23 @@ All API endpoints return a consistent response structure:
 ### Pagination
 
 **Option 1: Get all results (no pagination)**
+
 ```typescript
 // Returns all results in a single array
 const accounts = await client.accounts.list({
-  state: 'active'
+  state: "active",
 });
 // Response: { status, status_code, data: [...] }
 ```
 
 **Option 2: Paginated results**
+
 ```typescript
 // Returns paginated results with metadata
 const accounts = await client.accounts.list({
-  state: 'active',
+  state: "active",
   page: 1,
-  per_page: 20
+  per_page: 20,
 });
 // Response: { status, status_code, data: [...], meta: {...} }
 
@@ -643,26 +661,27 @@ let hasMore = true;
 
 while (hasMore) {
   const response = await client.accounts.list({
-    state: 'active',
+    state: "active",
     page,
-    per_page: 50
+    per_page: 50,
   });
-  
+
   // Process response.data
   console.log(`Page ${page}:`, response.data.length);
-  
+
   hasMore = response.meta.has_next;
   page++;
 }
 ```
 
 **Option 3: Limit results (ignores pagination)**
+
 ```typescript
 // Get specific number of results
 const candles = await client.marketData.getCandles({
-  symbol: 'BTCUSD',
-  timeframe: '1h',
-  limit: 100  // Max: 10,000 for candles
+  symbol: "BTCUSD",
+  timeframe: "1h",
+  limit: 100, // Max: 10,000 for candles
 });
 ```
 
@@ -673,17 +692,17 @@ Many filters accept comma-separated values:
 ```typescript
 // Multiple symbols (OR logic)
 const positions = await client.positions.list({
-  symbol: 'EURUSD,GBPUSD,USDJPY'  // Positions in ANY of these symbols
+  symbol: "EURUSD,GBPUSD,USDJPY", // Positions in ANY of these symbols
 });
 
 // Multiple countries
 const accounts = await client.accounts.list({
-  country: 'Mexico,United States,Canada'
+  country: "Mexico,United States,Canada",
 });
 
 // Multiple states
 const orders = await client.orders.list({
-  status: 'new,partial'  // Orders with status new OR partial
+  status: "new,partial", // Orders with status new OR partial
 });
 ```
 
@@ -694,16 +713,16 @@ All date parameters must be in **ISO 8601 / RFC3339 format** (UTC):
 ```typescript
 // Correct format
 const positions = await client.positions.list({
-  opened_from: '2025-01-01T00:00:00Z',
-  opened_to: '2025-01-31T23:59:59Z'
+  opened_from: "2025-01-01T00:00:00Z",
+  opened_to: "2025-01-31T23:59:59Z",
 });
 
 // Also valid
 const candles = await client.marketData.getCandles({
-  symbol: 'BTCUSD',
-  timeframe: '1h',
-  from: '2025-01-15T10:30:00Z',
-  to: '2025-01-15T18:30:00Z'
+  symbol: "BTCUSD",
+  timeframe: "1h",
+  from: "2025-01-15T10:30:00Z",
+  to: "2025-01-15T18:30:00Z",
 });
 ```
 
@@ -717,21 +736,21 @@ Use `min_*` and `max_*` for numeric ranges:
 // Balance range
 const accounts = await client.accounts.list({
   min_balance: 1000,
-  max_balance: 50000
+  max_balance: 50000,
 });
 
 // Profit range
 const positions = await client.positions.list({
   profit_min: 100,
-  profit_max: 1000
+  profit_max: 1000,
 });
 
 // Volume range
 const candles = await client.marketData.getCandles({
-  symbol: 'BTCUSD',
-  timeframe: '1h',
+  symbol: "BTCUSD",
+  timeframe: "1h",
   min_volume: 1000,
-  max_volume: 50000
+  max_volume: 50000,
 });
 ```
 
@@ -741,16 +760,16 @@ Most list endpoints support sorting:
 
 ```typescript
 const orders = await client.orders.list({
-  login: '50001',
-  sort_by: 'created_at',    // Field to sort by
-  sort_order: 'desc'         // 'asc' or 'desc'
+  login: "50001",
+  sort_by: "created_at", // Field to sort by
+  sort_order: "desc", // 'asc' or 'desc'
 });
 
 const candles = await client.marketData.getCandles({
-  symbol: 'BTCUSD',
-  timeframe: '1h',
-  sort: 'volume',            // Some endpoints use 'sort'
-  order: 'desc'              // instead of 'sort_by'/'sort_order'
+  symbol: "BTCUSD",
+  timeframe: "1h",
+  sort: "volume", // Some endpoints use 'sort'
+  order: "desc", // instead of 'sort_by'/'sort_order'
 });
 ```
 
@@ -761,28 +780,27 @@ All errors thrown by the SDK are instances of `PipsendError` with detailed infor
 ### Basic Error Handling
 
 ```typescript
-import { PipsendError } from '@pipsend/sdk';
+import { PipsendError } from "@pipsend/sdk";
 
 try {
   const trade = await client.trades.open({
     login: 50001,
-    symbol: 'EURUSD',
-    action: 'buy',
-    type: 'market',
-    volume: 1.0
+    symbol: "EURUSD",
+    action: "buy",
+    type: "market",
+    volume: 1.0,
   });
-  
-  console.log('Trade opened:', trade.position_id);
-  
+
+  console.log("Trade opened:", trade.position_id);
 } catch (error) {
   if (error instanceof PipsendError) {
-    console.error('Error code:', error.code);
-    console.error('Status code:', error.statusCode);
-    console.error('Message:', error.message);
-    
+    console.error("Error code:", error.code);
+    console.error("Status code:", error.statusCode);
+    console.error("Message:", error.message);
+
     // Check if it's a validation error
     if (error.isValidationError()) {
-      console.error('Validation errors:', error.errors);
+      console.error("Validation errors:", error.errors);
       // Get formatted message with all details
       console.error(error.getDetailedMessage());
     }
@@ -797,26 +815,26 @@ When the API returns validation errors, the SDK provides detailed field-level in
 ```typescript
 try {
   const account = await client.accounts.create({
-    trading_group: 'InvalidGroup',
-    country: 'XYZ',
-    master_password: 'short',
-    investor_password: 'short',
-    email: 'invalid-email',
-    first_name: 'John',
-    last_name: 'Doe'
+    trading_group: "InvalidGroup",
+    country: "XYZ",
+    master_password: "short",
+    investor_password: "short",
+    email: "invalid-email",
+    first_name: "John",
+    last_name: "Doe",
   });
 } catch (error) {
   if (error instanceof PipsendError && error.isValidationError()) {
-    console.log('Validation failed:');
-    
+    console.log("Validation failed:");
+
     // Access individual validation errors
-    error.errors?.forEach(err => {
+    error.errors?.forEach((err) => {
       console.log(`  - ${err.field}: ${err.message}`);
     });
-    
+
     // Or get formatted message
     console.log(error.getDetailedMessage());
-    
+
     // Output:
     // The provided data is not valid.
     //   - trading_group: Trading group 'InvalidGroup' not found
@@ -831,20 +849,20 @@ try {
 
 ```typescript
 interface PipsendError {
-  message: string;              // Error message
-  code: string;                 // Error code (e.g., 'VALIDATION_ERROR', 'NOT_FOUND')
-  statusCode: number;           // HTTP status code (e.g., 422, 404, 500)
-  errors?: ValidationError[];   // Validation errors (for 422 responses)
-  response?: any;               // Full error response from server
-  
+  message: string; // Error message
+  code: string; // Error code (e.g., 'VALIDATION_ERROR', 'NOT_FOUND')
+  statusCode: number; // HTTP status code (e.g., 422, 404, 500)
+  errors?: ValidationError[]; // Validation errors (for 422 responses)
+  response?: any; // Full error response from server
+
   // Helper methods
-  isValidationError(): boolean;      // Check if it's a validation error
-  getDetailedMessage(): string;      // Get formatted message with details
+  isValidationError(): boolean; // Check if it's a validation error
+  getDetailedMessage(): string; // Get formatted message with details
 }
 
 interface ValidationError {
-  field: string;    // Field name that failed validation
-  message: string;  // Validation error message
+  field: string; // Field name that failed validation
+  message: string; // Validation error message
 }
 ```
 
@@ -912,8 +930,8 @@ import type {
   Candle,
   Symbol,
   OpenTradeRequest,
-  OpenTradeResponse
-} from '@pipsend/sdk';
+  OpenTradeResponse,
+} from "@pipsend/sdk";
 ```
 
 ## 🧪 Testing