@alango/dr-manhattan 0.1.4 → 0.1.6

package/README.md

@@ -16,6 +16,7 @@ CCXT-style unified API for prediction markets in TypeScript.
 | [Limitless](https://limitless.exchange) | ✅ | ✅ | Base |
 | [Opinion](https://opinion.trade) | ✅ | ❌ | BNB |
 | [Kalshi](https://kalshi.com) | ✅ | ❌ | - |
+| [Predict.fun](https://predict.fun) | ✅ | ❌ | BNB |
 
 ## Installation
 
@@ -33,7 +34,7 @@ yarn add @alango/dr-manhattan
 import { createExchange, listExchanges, MarketUtils } from '@alango/dr-manhattan';
 
 // List available exchanges
-console.log(listExchanges()); // ['polymarket', 'limitless', 'opinion', 'kalshi']
+console.log(listExchanges()); // ['polymarket', 'limitless', 'opinion', 'kalshi', 'predictfun']
 
 // Create exchange instance (no auth required for public data)
 const polymarket = createExchange('polymarket');
@@ -139,6 +140,47 @@ const order = await kalshi.createOrder({
 });
 ```
 
+### Predict.fun
+
+```typescript
+import { PredictFun } from '@alango/dr-manhattan';
+
+// Mainnet
+const predictfun = new PredictFun({
+  apiKey: process.env.PREDICTFUN_API_KEY,
+  privateKey: process.env.PRIVATE_KEY,
+});
+
+// Testnet
+const predictfunTestnet = new PredictFun({
+  apiKey: process.env.PREDICTFUN_API_KEY,
+  privateKey: process.env.PRIVATE_KEY,
+  testnet: true,
+});
+
+// Fetch markets (no auth required for public data)
+const markets = await predictfun.fetchMarkets({ limit: 10 });
+
+// Get orderbook
+const orderbook = await predictfun.getOrderbook(marketId);
+
+// Create order (auth required)
+const order = await predictfun.createOrder({
+  marketId: '123',
+  outcome: 'Yes',
+  side: OrderSide.BUY,
+  price: 0.55,
+  size: 100,
+});
+
+// Fetch positions
+const positions = await predictfun.fetchPositions();
+
+// Fetch balance
+const balance = await predictfun.fetchBalance();
+console.log(`USDT: ${balance.USDT}`);
+```
+
 ## API Reference
 
 ### Exchange Methods
@@ -381,15 +423,53 @@ interface ExchangeConfig {
 
 See the [examples/](examples/) directory:
 
-- **list-markets.ts** - Fetch and display markets
-- **websocket-orderbook.ts** - Real-time orderbook streaming
-- **spread-strategy.ts** - Market making strategy with inventory management
+| Example | Description | Exchanges |
+|---------|-------------|-----------|
+| **list-markets.ts** | Fetch and display markets from all exchanges | All |
+| **websocket-orderbook.ts** | Real-time orderbook streaming via WebSocket | Polymarket |
+| **spread-strategy.ts** | Market making strategy with inventory management | All |
+| **spike-strategy.ts** | Mean reversion strategy - buys price spikes | All |
+| **weather-bot-strategy.ts** | London temperature bucket mispricing strategy | Polymarket |
+
+### Running Examples
 
 ```bash
-# Run examples
+# List markets from all exchanges
 npx tsx examples/list-markets.ts
+
+# WebSocket orderbook streaming (Polymarket)
 npx tsx examples/websocket-orderbook.ts
-npx tsx examples/spread-strategy.ts  # Requires PRIVATE_KEY env var for real trades
+
+# Spread strategy - works with any exchange
+# Polymarket (WebSocket)
+EXCHANGE=polymarket PRIVATE_KEY=0x... npx tsx examples/spread-strategy.ts
+
+# Limitless (WebSocket)
+EXCHANGE=limitless PRIVATE_KEY=0x... npx tsx examples/spread-strategy.ts
+
+# Kalshi (REST polling)
+EXCHANGE=kalshi KALSHI_API_KEY_ID=... KALSHI_PRIVATE_KEY_PATH=./key.pem npx tsx examples/spread-strategy.ts
+
+# Predict.fun (REST polling)
+EXCHANGE=predictfun PREDICTFUN_API_KEY=... PRIVATE_KEY=0x... npx tsx examples/spread-strategy.ts
+
+# Opinion (REST polling)
+EXCHANGE=opinion OPINION_API_KEY=... PRIVATE_KEY=0x... npx tsx examples/spread-strategy.ts
+
+# Simulation mode (no credentials = no real trades)
+EXCHANGE=polymarket npx tsx examples/spread-strategy.ts
+
+# Spike strategy - mean reversion (buys dips)
+EXCHANGE=polymarket PRIVATE_KEY=0x... npx tsx examples/spike-strategy.ts
+
+# Spike strategy with custom parameters
+npx tsx examples/spike-strategy.ts --spike-threshold 0.02 --profit-target 0.03 --stop-loss 0.02
+
+# Weather bot strategy - London temperature bucket mispricing
+npx tsx examples/weather-bot-strategy.ts --dry-run
+
+# Weather bot with live trading
+PRIVATE_KEY=0x... npx tsx examples/weather-bot-strategy.ts --order-size 5
 ```
 
 ## Requirements

package/dist/index.d.ts

@@ -694,6 +694,8 @@ declare class Polymarket extends Exchange {
     private clobClient;
     private wallet;
     private address;
+    private clobClientAuthenticated;
+    private authConfig;
     constructor(config?: PolymarketConfig);
     describe(): {
         has: {
@@ -711,6 +713,7 @@ declare class Polymarket extends Exchange {
         name: string;
     };
     private initializeClobClient;
+    private ensureAuthenticated;
     fetchMarkets(params?: FetchMarketsParams): Promise<Market[]>;
     fetchMarket(marketId: string): Promise<Market>;
     fetchMarketsBySlug(slugOrUrl: string): Promise<Market[]>;
@@ -732,6 +735,7 @@ declare class Polymarket extends Exchange {
     }>;
     private parseMarketIdentifier;
     private parseSamplingMarket;
+    private parseClobMarket;
     private parseGammaMarket;
     private parseOrder;
     private parseOrderStatus;
@@ -780,17 +784,96 @@ interface PolymarketWsConfig extends WebSocketConfig {
 }
 declare class PolymarketWebSocket extends OrderBookWebSocket {
     readonly wsUrl = "wss://ws-subscriptions-clob.polymarket.com/ws/market";
-    private apiKey?;
     private assetSubscriptions;
+    private initialSubscriptionSent;
     constructor(config?: PolymarketWsConfig);
     protected authenticate(): Promise<void>;
     protected subscribeOrderbook(marketId: string): Promise<void>;
     protected unsubscribeOrderbook(marketId: string): Promise<void>;
+    protected startPingTimer(): void;
+    protected handleMessage(data: WebSocket.RawData): void;
     protected parseOrderbookMessage(message: Record<string, unknown>): OrderbookUpdate | null;
     watchOrderbookWithAsset(marketId: string, assetId: string, callback: (marketId: string, orderbook: OrderbookUpdate) => void | Promise<void>): Promise<void>;
     private findMarketIdByAsset;
 }
 
+/**
+ * Predict.fun Exchange implementation for dr-manhattan.
+ *
+ * Predict.fun is a prediction market on BNB Chain with CLOB-style orderbook.
+ * Uses REST API for communication and EIP-712 for order signing.
+ *
+ * API Documentation: https://dev.predict.fun/
+ */
+
+interface PredictFunConfig extends ExchangeConfig {
+    /** Use testnet API */
+    testnet?: boolean;
+    /** Custom API host */
+    host?: string;
+}
+declare class PredictFun extends Exchange {
+    readonly id = "predictfun";
+    readonly name = "Predict.fun";
+    private readonly host;
+    private readonly chainId;
+    private readonly testnet;
+    private wallet;
+    private address;
+    private jwtToken;
+    private authenticated;
+    private readonly yieldBearingCtfExchange;
+    private readonly yieldBearingNegRiskCtfExchange;
+    private readonly ctfExchange;
+    private readonly negRiskCtfExchange;
+    constructor(config?: PredictFunConfig);
+    private getHeaders;
+    private authenticate;
+    private ensureAuth;
+    private request;
+    private parseMarket;
+    private parseOrder;
+    private parseOrderStatus;
+    private parsePosition;
+    fetchMarkets(params?: FetchMarketsParams): Promise<Market[]>;
+    fetchMarket(marketId: string): Promise<Market>;
+    getOrderbook(marketId: string): Promise<{
+        bids: Array<{
+            price: string;
+            size: string;
+        }>;
+        asks: Array<{
+            price: string;
+            size: string;
+        }>;
+    }>;
+    fetchTokenIds(marketId: string): Promise<string[]>;
+    createOrder(params: CreateOrderParams): Promise<Order>;
+    private buildSignedOrder;
+    private signOrderEip712;
+    cancelOrder(orderId: string, marketId?: string): Promise<Order>;
+    fetchOrder(orderId: string, _marketId?: string): Promise<Order>;
+    fetchOpenOrders(marketId?: string): Promise<Order[]>;
+    fetchPositions(marketId?: string): Promise<Position[]>;
+    fetchBalance(): Promise<Record<string, number>>;
+    get walletAddress(): string | null;
+    describe(): {
+        id: string;
+        name: string;
+        has: {
+            fetchMarkets: boolean;
+            fetchMarket: boolean;
+            createOrder: boolean;
+            cancelOrder: boolean;
+            fetchOrder: boolean;
+            fetchOpenOrders: boolean;
+            fetchPositions: boolean;
+            fetchBalance: boolean;
+            websocket: boolean;
+        };
+    };
+}
+
 declare function listExchanges(): string[];
 declare function createExchange(exchangeId: string, config?: ExchangeConfig): Exchange;
 
@@ -812,4 +895,4 @@ declare function clampPrice(price: number, min?: number, max?: number): number;
 declare function formatPrice(price: number, decimals?: number): string;
 declare function formatUsd(amount: number): string;
 
-export { AuthenticationError, Colors, type CreateOrderParams, type DeltaInfo, DrManhattanError, Exchange, type ExchangeCapabilities, type ExchangeConfig, ExchangeError, type FetchMarketsParams, InsufficientFunds, InvalidOrder, Kalshi, Limitless, LimitlessWebSocket, type Market, MarketNotFound, MarketUtils, NetworkError, Opinion, type Order, OrderBookWebSocket, OrderSide, OrderStatus, OrderUtils, type Orderbook, type OrderbookCallback, OrderbookManager, type OrderbookUpdate, OrderbookUtils, type OutcomeToken, Polymarket, PolymarketWebSocket, type Position, PositionUtils, type PriceLevel, RateLimitError, Strategy, type StrategyConfig, StrategyState, type WebSocketConfig, WebSocketState, calculateDelta, clampPrice, createExchange, createLogger, formatPrice, formatUsd, listExchanges, logger, roundToTickSize };
+export { AuthenticationError, Colors, type CreateOrderParams, type DeltaInfo, DrManhattanError, Exchange, type ExchangeCapabilities, type ExchangeConfig, ExchangeError, type FetchMarketsParams, InsufficientFunds, InvalidOrder, Kalshi, Limitless, LimitlessWebSocket, type Market, MarketNotFound, MarketUtils, NetworkError, Opinion, type Order, OrderBookWebSocket, OrderSide, OrderStatus, OrderUtils, type Orderbook, type OrderbookCallback, OrderbookManager, type OrderbookUpdate, OrderbookUtils, type OutcomeToken, Polymarket, PolymarketWebSocket, type Position, PositionUtils, PredictFun, type PriceLevel, RateLimitError, Strategy, type StrategyConfig, StrategyState, type WebSocketConfig, WebSocketState, calculateDelta, clampPrice, createExchange, createLogger, formatPrice, formatUsd, listExchanges, logger, roundToTickSize };