@catalyst-team/poly-sdk 0.2.0 → 0.3.0

package/examples/06-services-demo.ts

@@ -1,124 +0,0 @@
-/**
- * Example 6: Services Demo
- *
- * This example demonstrates the new service layer:
- * - WalletService for smart money analysis
- * - MarketService for K-Line and market signals
- *
- * Run: npx tsx examples/06-services-demo.ts
- */
-
-import { PolymarketSDK, type KLineInterval } from '../src/index.js';
-
-async function main() {
-  console.log('=== Services Demo ===\n');
-
-  const sdk = new PolymarketSDK();
-
-  // ===== WalletService Demo =====
-  console.log('--- WalletService Demo ---\n');
-
-  // 1. Get top traders
-  console.log('1. Getting top traders...');
-  const topTraders = await sdk.wallets.getTopTraders(5);
-  console.log(`   Found ${topTraders.length} top traders\n`);
-
-  for (const trader of topTraders.slice(0, 3)) {
-    console.log(`   Rank #${trader.rank}: ${trader.address.slice(0, 10)}...`);
-    console.log(`   PnL: $${trader.pnl.toLocaleString()}`);
-    console.log(`   Volume: $${trader.volume.toLocaleString()}\n`);
-  }
-
-  // 2. Get wallet profile
-  if (topTraders.length > 0) {
-    console.log('2. Getting wallet profile for top trader...');
-    const profile = await sdk.wallets.getWalletProfile(topTraders[0].address);
-    console.log(`   Address: ${profile.address.slice(0, 10)}...`);
-    console.log(`   Total PnL: $${profile.totalPnL.toFixed(2)}`);
-    console.log(`   Smart Score: ${profile.smartScore}/100`);
-    console.log(`   Position Count: ${profile.positionCount}`);
-    console.log(`   Last Active: ${profile.lastActiveAt.toLocaleString()}\n`);
-  }
-
-  // 3. Discover active wallets
-  console.log('3. Discovering active wallets from recent trades...');
-  const activeWallets = await sdk.wallets.discoverActiveWallets(5);
-  console.log(`   Found ${activeWallets.length} active wallets:\n`);
-  for (const wallet of activeWallets) {
-    console.log(`   - ${wallet.address.slice(0, 10)}...: ${wallet.tradeCount} trades`);
-  }
-
-  // ===== MarketService Demo =====
-  console.log('\n--- MarketService Demo ---\n');
-
-  // 4. Get trending market
-  console.log('4. Getting trending market...');
-  const trendingMarkets = await sdk.markets.getTrendingMarkets(1);
-  if (trendingMarkets.length === 0) {
-    console.log('No trending markets found');
-    return;
-  }
-
-  const market = trendingMarkets[0];
-  console.log(`   Market: ${market.question.slice(0, 60)}...`);
-  console.log(`   Condition ID: ${market.conditionId}\n`);
-
-  // 5. Get unified market data
-  console.log('5. Getting unified market data...');
-  const unifiedMarket = await sdk.markets.getMarket(market.conditionId);
-  console.log(`   Source: ${unifiedMarket.source}`);
-  console.log(`   YES Price: ${unifiedMarket.tokens.yes.price}`);
-  console.log(`   NO Price: ${unifiedMarket.tokens.no.price}`);
-  console.log(`   Volume 24hr: $${unifiedMarket.volume24hr?.toLocaleString() || 'N/A'}\n`);
-
-  // 6. Get K-Lines
-  console.log('6. Getting K-Line data...');
-  const interval: KLineInterval = '1h';
-  const klines = await sdk.markets.getKLines(market.conditionId, interval, { limit: 100 });
-  console.log(`   Generated ${klines.length} candles (${interval} interval)\n`);
-
-  if (klines.length > 0) {
-    console.log('   Last 3 candles:');
-    for (const candle of klines.slice(-3)) {
-      const date = new Date(candle.timestamp).toLocaleString();
-      console.log(`   [${date}] O:${candle.open.toFixed(3)} H:${candle.high.toFixed(3)} L:${candle.low.toFixed(3)} C:${candle.close.toFixed(3)} V:$${candle.volume.toFixed(0)}`);
-    }
-  }
-
-  // 7. Get Dual K-Lines
-  console.log('\n7. Getting dual K-Lines (YES + NO)...');
-  const dualKlines = await sdk.markets.getDualKLines(market.conditionId, interval, { limit: 100 });
-  console.log(`   YES Candles: ${dualKlines.yes.length}`);
-  console.log(`   NO Candles: ${dualKlines.no.length}`);
-
-  if (dualKlines.spreadAnalysis && dualKlines.spreadAnalysis.length > 0) {
-    console.log('\n   Spread Analysis (last 3):');
-    for (const point of dualKlines.spreadAnalysis.slice(-3)) {
-      const date = new Date(point.timestamp).toLocaleString();
-      console.log(`   [${date}] YES:${point.yesPrice.toFixed(3)} + NO:${point.noPrice.toFixed(3)} = ${point.spread.toFixed(4)} ${point.arbOpportunity}`);
-    }
-  }
-
-  // 8. Detect market signals
-  console.log('\n8. Detecting market signals...');
-  const signals = await sdk.markets.detectMarketSignals(market.conditionId);
-  console.log(`   Found ${signals.length} signals:\n`);
-  for (const signal of signals.slice(0, 5)) {
-    console.log(`   - Type: ${signal.type}, Severity: ${signal.severity}`);
-  }
-
-  // 9. Check for arbitrage
-  console.log('\n9. Checking for arbitrage...');
-  const arb = await sdk.markets.detectArbitrage(market.conditionId, 0.001);
-  if (arb) {
-    console.log(`   Arbitrage found!`);
-    console.log(`   Type: ${arb.type}, Profit: ${(arb.profit * 100).toFixed(3)}%`);
-    console.log(`   Action: ${arb.action}`);
-  } else {
-    console.log('   No arbitrage opportunity found');
-  }
-
-  console.log('\n=== Done ===');
-}
-
-main().catch(console.error);

package/examples/07-realtime-websocket.ts

@@ -1,117 +0,0 @@
-/**
- * Example 7: Real-time WebSocket
- *
- * This example demonstrates real-time price updates:
- * - WebSocketManager for low-level access
- * - RealtimeService for subscription management
- *
- * Run: npx tsx examples/07-realtime-websocket.ts
- */
-
-import { PolymarketSDK } from '../src/index.js';
-import { WebSocketManager } from '../src/clients/websocket-manager.js';
-import { RealtimeService } from '../src/services/realtime-service.js';
-
-async function main() {
-  console.log('=== Real-time WebSocket Demo ===\n');
-
-  const sdk = new PolymarketSDK();
-
-  // 1. Get a trending market to subscribe to
-  console.log('1. Getting trending market...');
-  const trendingMarkets = await sdk.markets.getTrendingMarkets(1);
-  if (trendingMarkets.length === 0) {
-    console.log('No trending markets found');
-    return;
-  }
-
-  const market = trendingMarkets[0];
-  console.log(`   Market: ${market.question.slice(0, 60)}...`);
-  console.log(`   Condition ID: ${market.conditionId}\n`);
-
-  // 2. Get market details for token IDs
-  console.log('2. Getting market details...');
-  const unifiedMarket = await sdk.markets.getMarket(market.conditionId);
-  const yesTokenId = unifiedMarket.tokens.yes.tokenId;
-  const noTokenId = unifiedMarket.tokens.no.tokenId;
-  console.log(`   YES Token: ${yesTokenId.slice(0, 20)}...`);
-  console.log(`   NO Token: ${noTokenId.slice(0, 20)}...`);
-  console.log(`   Current YES Price: ${unifiedMarket.tokens.yes.price}`);
-  console.log(`   Current NO Price: ${unifiedMarket.tokens.no.price}\n`);
-
-  if (!yesTokenId || !noTokenId) {
-    console.log('No token IDs available for this market');
-    return;
-  }
-
-  // 3. Create RealtimeService and subscribe
-  console.log('3. Subscribing to real-time updates...');
-  const wsManager = new WebSocketManager({ enableLogging: true });
-  const realtime = new RealtimeService(wsManager);
-
-  let updateCount = 0;
-  const maxUpdates = 10;
-
-  const subscription = await realtime.subscribeMarket(yesTokenId, noTokenId, {
-    onPriceUpdate: (update) => {
-      updateCount++;
-      const side = update.assetId === yesTokenId ? 'YES' : 'NO';
-      console.log(`   [${new Date().toLocaleTimeString()}] ${side} Price: ${update.price.toFixed(4)} (mid: ${update.midpoint.toFixed(4)}, spread: ${update.spread.toFixed(4)})`);
-    },
-    onBookUpdate: (update) => {
-      const side = update.assetId === yesTokenId ? 'YES' : 'NO';
-      const bestBid = update.bids[0];
-      const bestAsk = update.asks[0];
-      console.log(`   [${new Date().toLocaleTimeString()}] ${side} Book: Bid ${bestBid?.price.toFixed(4)} (${bestBid?.size.toFixed(0)}) | Ask ${bestAsk?.price.toFixed(4)} (${bestAsk?.size.toFixed(0)})`);
-    },
-    onLastTrade: (trade) => {
-      const side = trade.assetId === yesTokenId ? 'YES' : 'NO';
-      console.log(`   [${new Date().toLocaleTimeString()}] ${side} Trade: ${trade.side} ${trade.size} @ ${trade.price.toFixed(4)}`);
-    },
-    onPairUpdate: (update) => {
-      const spread = update.spread;
-      const arbSignal = spread < 0.99 ? '🔴 ARB!' : spread > 1.01 ? '🔴 ARB!' : '✅';
-      console.log(`   [${new Date().toLocaleTimeString()}] PAIR: YES ${update.yes.price.toFixed(4)} + NO ${update.no.price.toFixed(4)} = ${spread.toFixed(4)} ${arbSignal}`);
-    },
-    onError: (error) => {
-      console.error(`   Error: ${error.message}`);
-    },
-  });
-
-  console.log(`   Subscription ID: ${subscription.id}`);
-  console.log(`   Subscribed to: ${subscription.assetIds.length} assets`);
-  console.log(`\n   Waiting for updates (max ${maxUpdates})...\n`);
-
-  // 4. Wait for some updates
-  await new Promise<void>((resolve) => {
-    const interval = setInterval(() => {
-      if (updateCount >= maxUpdates) {
-        clearInterval(interval);
-        resolve();
-      }
-    }, 500);
-
-    // Timeout after 30 seconds
-    setTimeout(() => {
-      clearInterval(interval);
-      resolve();
-    }, 30000);
-  });
-
-  // 5. Check cached prices
-  console.log('\n4. Cached prices:');
-  const prices = realtime.getAllPrices();
-  for (const [assetId, price] of prices) {
-    const side = assetId === yesTokenId ? 'YES' : 'NO';
-    console.log(`   ${side}: ${price.price.toFixed(4)}`);
-  }
-
-  // 6. Cleanup
-  console.log('\n5. Cleaning up...');
-  await subscription.unsubscribe();
-  console.log('   Unsubscribed');
-
-  console.log('\n=== Done ===');
-}
-
-main().catch(console.error);

package/examples/08-trading-orders.ts

@@ -1,278 +0,0 @@
-/**
- * Example 08: Trading Orders
- *
- * Demonstrates all trading functionality:
- * - Limit orders (GTC, GTD)
- * - Market orders (FOK, FAK)
- * - Order management
- * - Price utilities
- * - Rewards tracking
- *
- * NOTE: This example does NOT execute real trades.
- * Uncomment the order sections to test with real funds.
- */
-
-import {
-  TradingClient,
-  RateLimiter,
-  PolymarketSDK,
-  roundPrice,
-  validatePrice,
-  calculateBuyAmount,
-  checkArbitrage,
-  formatUSDC,
-  type TickSize,
-} from '../src/index.js';
-
-// Test wallet private key (empty wallet for safety)
-const PRIVATE_KEY = process.env.POLYMARKET_PRIVATE_KEY || '0xYOUR_PRIVATE_KEY_HERE';
-
-async function main() {
-  console.log('=== Polymarket Trading Examples ===\n');
-
-  // Initialize SDK and TradingClient
-  const sdk = new PolymarketSDK();
-  const rateLimiter = new RateLimiter();
-  const tradingClient = new TradingClient(rateLimiter, {
-    privateKey: PRIVATE_KEY,
-  });
-
-  // ===== 1. Find an Active Market =====
-  console.log('1. Finding active markets...\n');
-
-  const markets = await sdk.gammaApi.getMarkets({
-    closed: false,
-    active: true,
-    limit: 5,
-  });
-
-  if (markets.length === 0) {
-    console.log('   No active markets found');
-    return;
-  }
-
-  const market = markets[0];
-  console.log(`   Market: ${market.question?.slice(0, 60)}...`);
-  console.log(`   Condition ID: ${market.conditionId}`);
-
-  // Get market details from CLOB
-  const clobMarket = await sdk.clobApi.getMarket(market.conditionId);
-  const yesToken = clobMarket.tokens.find((t) => t.outcome === 'Yes');
-  const noToken = clobMarket.tokens.find((t) => t.outcome === 'No');
-
-  if (!yesToken || !noToken) {
-    console.log('   Could not find tokens');
-    return;
-  }
-
-  console.log(`   YES Token: ${yesToken.tokenId.slice(0, 20)}...`);
-  console.log(`   NO Token: ${noToken.tokenId.slice(0, 20)}...`);
-  console.log(`   YES Price: $${yesToken.price}`);
-  console.log(`   NO Price: $${noToken.price}`);
-
-  // ===== 2. Price Utilities Demo =====
-  console.log('\n2. Price Utilities Demo\n');
-
-  // Get tick size for the market
-  const tickSize: TickSize = '0.01'; // Most markets use 0.01
-
-  // Round prices to tick size
-  const rawPrice = 0.523;
-  console.log(`   Raw price: ${rawPrice}`);
-  console.log(`   Rounded (floor): ${roundPrice(rawPrice, tickSize, 'floor')}`);
-  console.log(`   Rounded (ceil): ${roundPrice(rawPrice, tickSize, 'ceil')}`);
-  console.log(`   Rounded (round): ${roundPrice(rawPrice, tickSize, 'round')}`);
-
-  // Validate prices
-  const validation = validatePrice(0.525, tickSize);
-  console.log(`   Price 0.525 valid: ${validation.valid}`);
-
-  const invalidValidation = validatePrice(0.5233, tickSize);
-  console.log(`   Price 0.5233 valid: ${invalidValidation.valid}`);
-  if (!invalidValidation.valid) {
-    console.log(`   Error: ${invalidValidation.error}`);
-  }
-
-  // Calculate order amounts
-  const price = 0.52;
-  const size = 100;
-  const amount = calculateBuyAmount(price, size);
-  console.log(`\n   Order: BUY ${size} YES @ $${price}`);
-  console.log(`   Cost: ${formatUSDC(amount)}`);
-
-  // ===== 3. Arbitrage Detection =====
-  console.log('\n3. Arbitrage Detection\n');
-
-  // Get current orderbook
-  const orderbook = await sdk.clobApi.getProcessedOrderbook(market.conditionId);
-
-  console.log(`   YES: Bid $${orderbook.yes.bid} / Ask $${orderbook.yes.ask}`);
-  console.log(`   NO:  Bid $${orderbook.no.bid} / Ask $${orderbook.no.ask}`);
-
-  const arb = checkArbitrage(
-    orderbook.yes.ask,
-    orderbook.no.ask,
-    orderbook.yes.bid,
-    orderbook.no.bid
-  );
-
-  if (arb) {
-    console.log(`\n   ARBITRAGE DETECTED!`);
-    console.log(`   Type: ${arb.type}`);
-    console.log(`   Profit: ${formatUSDC(arb.profit)}`);
-  } else {
-    console.log(`   No arbitrage opportunity`);
-    console.log(`   Long cost: $${(orderbook.yes.ask + orderbook.no.ask).toFixed(4)}`);
-    console.log(`   Short revenue: $${(orderbook.yes.bid + orderbook.no.bid).toFixed(4)}`);
-  }
-
-  // ===== 4. Initialize Trading Client =====
-  console.log('\n4. Initializing Trading Client...\n');
-
-  try {
-    await tradingClient.initialize();
-    console.log(`   Wallet: ${tradingClient.getAddress()}`);
-    console.log(`   Initialized: ${tradingClient.isInitialized()}`);
-
-    const creds = tradingClient.getCredentials();
-    if (creds) {
-      console.log(`   API Key: ${creds.key.slice(0, 20)}...`);
-    }
-  } catch (error) {
-    console.log(`   Initialization skipped (no valid private key)`);
-    console.log(`   Set POLYMARKET_PRIVATE_KEY to test trading`);
-    return;
-  }
-
-  // ===== 5. Get Existing Orders and Trades =====
-  console.log('\n5. Getting existing orders and trades...\n');
-
-  const openOrders = await tradingClient.getOpenOrders();
-  console.log(`   Open orders: ${openOrders.length}`);
-
-  const trades = await tradingClient.getTrades();
-  console.log(`   Total trades: ${trades.length}`);
-
-  if (trades.length > 0) {
-    console.log('\n   Recent trades:');
-    for (const t of trades.slice(0, 3)) {
-      console.log(`   - ${t.side} ${t.size} @ $${t.price.toFixed(4)}`);
-    }
-  }
-
-  // ===== 6. Order Types Demo =====
-  console.log('\n6. Order Types (Not Executed)\n');
-
-  console.log('   --- LIMIT ORDERS ---');
-  console.log('   GTC (Good-Til-Cancelled):');
-  console.log('   - Stays on book until filled or cancelled');
-  console.log('   - Best for passive orders at your target price');
-  console.log(`
-   tradingClient.createOrder({
-     tokenId: '${yesToken.tokenId.slice(0, 20)}...',
-     side: 'BUY',
-     price: 0.45,
-     size: 10,
-     orderType: 'GTC',
-   });
-`);
-
-  console.log('   GTD (Good-Til-Date):');
-  console.log('   - Auto-expires at specified timestamp');
-  console.log('   - Good for time-sensitive strategies');
-  console.log(`
-   tradingClient.createOrder({
-     tokenId: '${yesToken.tokenId.slice(0, 20)}...',
-     side: 'BUY',
-     price: 0.45,
-     size: 10,
-     orderType: 'GTD',
-     expiration: Math.floor(Date.now() / 1000) + 3600, // 1 hour
-   });
-`);
-
-  console.log('   --- MARKET ORDERS ---');
-  console.log('   FOK (Fill-Or-Kill):');
-  console.log('   - Must fill entirely or not at all');
-  console.log('   - Best for guaranteed execution');
-  console.log(`
-   tradingClient.createMarketOrder({
-     tokenId: '${yesToken.tokenId.slice(0, 20)}...',
-     side: 'BUY',
-     amount: 10, // $10 USDC for BUY
-     orderType: 'FOK',
-   });
-`);
-
-  console.log('   FAK (Fill-And-Kill):');
-  console.log('   - Fill what you can, cancel the rest');
-  console.log('   - Good for partial fills');
-  console.log(`
-   tradingClient.createMarketOrder({
-     tokenId: '${yesToken.tokenId.slice(0, 20)}...',
-     side: 'SELL',
-     amount: 10, // 10 shares for SELL
-     orderType: 'FAK',
-   });
-`);
-
-  // ===== 7. Rewards Demo =====
-  console.log('\n7. Rewards (Market Making Incentives)\n');
-
-  try {
-    // Get current reward programs
-    const rewards = await tradingClient.getCurrentRewards();
-    console.log(`   Active reward programs: ${rewards.length}`);
-
-    if (rewards.length > 0) {
-      const reward = rewards[0];
-      console.log(`\n   Example reward market:`);
-      console.log(`   - Question: ${reward.question?.slice(0, 50)}...`);
-      console.log(`   - Max Spread: ${reward.rewardsMaxSpread}`);
-      console.log(`   - Min Size: ${reward.rewardsMinSize}`);
-
-      if (reward.rewardsConfig.length > 0) {
-        const config = reward.rewardsConfig[0];
-        console.log(`   - Rate/Day: ${config.ratePerDay}`);
-        console.log(`   - Total Pool: ${config.totalRewards}`);
-      }
-    }
-
-    // Check if orders are scoring (need actual order IDs)
-    if (openOrders.length > 0) {
-      const orderId = openOrders[0].id;
-      const isScoring = await tradingClient.isOrderScoring(orderId);
-      console.log(`\n   Order ${orderId.slice(0, 20)}... scoring: ${isScoring}`);
-    }
-
-    // Get yesterday's earnings
-    const yesterday = new Date();
-    yesterday.setDate(yesterday.getDate() - 1);
-    const dateStr = yesterday.toISOString().split('T')[0];
-
-    const earnings = await tradingClient.getTotalEarningsForDay(dateStr);
-    console.log(`\n   Earnings for ${dateStr}:`);
-    console.log(`   Total: ${formatUSDC(earnings.totalEarnings)}`);
-  } catch (error) {
-    console.log(`   Rewards data not available (requires valid trading history)`);
-  }
-
-  // ===== 8. Balance Check =====
-  console.log('\n8. Balance Check\n');
-
-  try {
-    const balance = await tradingClient.getBalanceAllowance('COLLATERAL');
-    console.log(`   USDC Balance: ${balance.balance}`);
-    console.log(`   USDC Allowance: ${balance.allowance}`);
-  } catch (error) {
-    console.log(`   Balance check failed (requires initialized wallet)`);
-  }
-
-  console.log('\n=== Example Complete ===');
-  console.log('\nTo execute real trades:');
-  console.log('1. Set POLYMARKET_PRIVATE_KEY environment variable');
-  console.log('2. Deposit USDC to your Polymarket proxy wallet');
-  console.log('3. Uncomment the order placement code in this file');
-}
-
-main().catch(console.error);