@catalyst-team/poly-sdk 0.3.0 → 0.4.3

package/dist/src/services/dip-arb-types.js

@@ -0,0 +1,164 @@
+/**
+ * Dip Arbitrage Service Types
+ *
+ * 暴跌套利服务类型定义
+ *
+ * 策略原理：
+ * 在 Polymarket 的 BTC/ETH/SOL/XRP UP/DOWN 短期市场中：
+ *
+ * 1. 每个市场有一个 "price to beat"（开盘时的 Chainlink 价格）
+ * 2. 结算规则：
+ *    - UP 赢：结束时价格 >= price to beat
+ *    - DOWN 赢：结束时价格 < price to beat
+ *
+ * 3. 套利流程：
+ *    - Leg1：检测暴跌 → 买入暴跌侧
+ *    - Leg2：等待对冲条件 → 买入另一侧
+ *    - 利润：总成本 < $1 时获得无风险利润
+ */
+/**
+ * 默认配置
+ */
+export const DEFAULT_DIP_ARB_CONFIG = {
+    shares: 20,
+    sumTarget: 0.92, // ✅ 放宽到 0.92 提高 Leg2 成交率 (8%+ 利润)
+    dipThreshold: 0.15,
+    windowMinutes: 2,
+    slidingWindowMs: 3000, // 3秒滑动窗口 - 核心参数！
+    maxSlippage: 0.02,
+    minProfitRate: 0.03,
+    leg2TimeoutSeconds: 180, // ✅ 缩短到 3 分钟，更快退出未对冲仓位
+    enableSurge: true,
+    surgeThreshold: 0.15,
+    autoMerge: true,
+    autoExecute: false,
+    executionCooldown: 3000,
+    splitOrders: 1, // ✅ 默认不拆分，避免份额误差
+    orderIntervalMs: 500, // 拆分订单间隔 500ms
+    debug: false,
+};
+/**
+ * 默认自动轮换配置
+ */
+export const DEFAULT_AUTO_ROTATE_CONFIG = {
+    enabled: false,
+    underlyings: ['BTC'],
+    duration: '15m',
+    preloadMinutes: 2,
+    autoSettle: true,
+    settleStrategy: 'redeem',
+    redeemWaitMinutes: 5,
+    redeemRetryIntervalSeconds: 30,
+};
+// ============= Helper Functions =============
+/**
+ * 创建初始统计
+ */
+export function createDipArbInitialStats() {
+    return {
+        startTime: Date.now(),
+        runningTimeMs: 0,
+        roundsMonitored: 0,
+        roundsCompleted: 0,
+        roundsSuccessful: 0,
+        roundsExpired: 0,
+        signalsDetected: 0,
+        leg1Filled: 0,
+        leg2Filled: 0,
+        totalSpent: 0,
+        totalProfit: 0,
+        avgProfitRate: 0,
+    };
+}
+/**
+ * 创建新轮次状态
+ */
+export function createDipArbRoundState(roundId, priceToBeat, upPrice, downPrice, durationMinutes = 15) {
+    const now = Date.now();
+    return {
+        roundId,
+        startTime: now,
+        endTime: now + durationMinutes * 60 * 1000,
+        priceToBeat,
+        openPrices: {
+            up: upPrice,
+            down: downPrice,
+        },
+        phase: 'waiting',
+    };
+}
+/**
+ * 计算利润率
+ */
+export function calculateDipArbProfitRate(totalCost) {
+    if (totalCost >= 1 || totalCost <= 0)
+        return 0;
+    return (1 - totalCost) / totalCost;
+}
+/**
+ * 计算基于底层资产价格变化的"真实"胜率
+ *
+ * @param currentPrice - 当前价格
+ * @param priceToBeat - 开盘价格
+ * @returns UP 的真实胜率估计 (0-1)
+ */
+export function estimateUpWinRate(currentPrice, priceToBeat) {
+    if (priceToBeat <= 0)
+        return 0.5;
+    const priceChange = (currentPrice - priceToBeat) / priceToBeat;
+    // 简单模型：价格变化 1% 对应胜率变化约 10%
+    const sensitivity = 10;
+    const winRateShift = priceChange * sensitivity;
+    // 限制在 [0.05, 0.95] 范围内
+    return Math.max(0.05, Math.min(0.95, 0.5 + winRateShift));
+}
+/**
+ * 检测定价偏差
+ *
+ * @param tokenPrice - token 当前价格（隐含胜率）
+ * @param estimatedWinRate - 基于价格估计的真实胜率
+ * @returns 偏差程度（正数 = 被低估，负数 = 被高估）
+ */
+export function detectMispricing(tokenPrice, estimatedWinRate) {
+    return estimatedWinRate - tokenPrice;
+}
+/**
+ * 从 slug 解析底层资产
+ * e.g., 'btc-updown-15m-1767165300' → 'BTC'
+ */
+export function parseUnderlyingFromSlug(slug) {
+    const lower = slug.toLowerCase();
+    if (lower.startsWith('btc'))
+        return 'BTC';
+    if (lower.startsWith('eth'))
+        return 'ETH';
+    if (lower.startsWith('sol'))
+        return 'SOL';
+    if (lower.startsWith('xrp'))
+        return 'XRP';
+    return 'BTC'; // default
+}
+/**
+ * 从 slug 解析时长
+ * e.g., 'btc-updown-15m-1767165300' → 15
+ */
+export function parseDurationFromSlug(slug) {
+    if (slug.includes('-5m-'))
+        return 5;
+    if (slug.includes('-15m-'))
+        return 15;
+    return 15; // default
+}
+/**
+ * 类型守卫：检查是否为 Leg1 信号
+ */
+export function isDipArbLeg1Signal(signal) {
+    return signal.type === 'leg1';
+}
+/**
+ * 类型守卫：检查是否为 Leg2 信号
+ */
+export function isDipArbLeg2Signal(signal) {
+    return signal.type === 'leg2';
+}
+//# sourceMappingURL=dip-arb-types.js.map

package/dist/src/services/dip-arb-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dip-arb-types.js","sourceRoot":"","sources":["../../../src/services/dip-arb-types.ts"],"names":[],"mappings":"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"}

package/dist/src/services/market-service.d.ts

@@ -0,0 +1,431 @@
+/**
+ * Market Service
+ *
+ * Provides market data and analysis:
+ * - Market info and discovery
+ * - Orderbook data and analysis
+ * - K-Line aggregation from trade data
+ * - Spread analysis
+ * - Arbitrage detection
+ */
+import { DataApiClient } from '../clients/data-api.js';
+import { GammaApiClient, GammaMarket } from '../clients/gamma-api.js';
+import type { UnifiedCache } from '../core/unified-cache.js';
+import { RateLimiter } from '../core/rate-limiter.js';
+import type { UnifiedMarket, ProcessedOrderbook, ArbitrageOpportunity, KLineInterval, KLineCandle, DualKLineData, RealtimeSpreadAnalysis, Side, Orderbook, UnderlyingAsset, TokenUnderlyingCorrelation } from '../core/types.js';
+import type { BinanceService } from './binance-service.js';
+export declare const POLYGON_MAINNET = 137;
+export type { Side, Orderbook } from '../core/types.js';
+export type PriceHistoryIntervalString = '1h' | '6h' | '1d' | '1w' | 'max';
+export interface PriceHistoryParams {
+    tokenId: string;
+    interval?: PriceHistoryIntervalString;
+    startTs?: number;
+    endTs?: number;
+    fidelity?: number;
+}
+export interface PricePoint {
+    timestamp: number;
+    price: number;
+}
+export interface MarketServiceConfig {
+    /** Private key for CLOB client auth (optional, for authenticated endpoints) */
+    privateKey?: string;
+    /** Chain ID (default: Polygon mainnet 137) */
+    chainId?: number;
+}
+/**
+ * CLOB Market type (from CLOB API)
+ *
+ * This represents the raw market data from the CLOB API.
+ * For merged market data with volume/liquidity, use UnifiedMarket from core/types.ts.
+ */
+export interface Market {
+    conditionId: string;
+    questionId?: string;
+    marketSlug: string;
+    question: string;
+    description?: string;
+    tokens: MarketToken[];
+    active: boolean;
+    closed: boolean;
+    acceptingOrders: boolean;
+    endDateIso?: string | null;
+    negRisk?: boolean;
+    minimumOrderSize?: number;
+    minimumTickSize?: number;
+}
+/**
+ * Token in a CLOB market
+ * Same structure as MarketToken in core/types.ts
+ */
+export interface MarketToken {
+    tokenId: string;
+    outcome: string;
+    price: number;
+    winner?: boolean;
+}
+/**
+ * Resolved market tokens with outcome names
+ *
+ * Uses `primary`/`secondary` naming to be market-agnostic:
+ * - Yes/No markets: primary=Yes, secondary=No
+ * - Up/Down markets: primary=Up, secondary=Down
+ * - Team markets: primary=Team1, secondary=Team2
+ *
+ * This follows the BinaryTokens pattern in core/types.ts
+ */
+export interface ResolvedMarketTokens {
+    /** Primary outcome token ID (index 0: Yes/Up/Team1) */
+    primaryTokenId: string;
+    /** Secondary outcome token ID (index 1: No/Down/Team2) */
+    secondaryTokenId: string;
+    /** Outcome names for display [primary, secondary] */
+    outcomes: [string, string];
+    /** Primary outcome name (e.g., "Yes", "Up") */
+    primaryOutcome: string;
+    /** Secondary outcome name (e.g., "No", "Down") */
+    secondaryOutcome: string;
+}
+export declare class MarketService {
+    private gammaApi;
+    private dataApi;
+    private rateLimiter;
+    private cache;
+    private config?;
+    private binanceService?;
+    private clobClient;
+    private initialized;
+    constructor(gammaApi: GammaApiClient | undefined, dataApi: DataApiClient | undefined, rateLimiter: RateLimiter, cache: UnifiedCache, config?: MarketServiceConfig | undefined, binanceService?: BinanceService | undefined);
+    private ensureInitialized;
+    /**
+     * Get market from CLOB by condition ID
+     */
+    getClobMarket(conditionId: string): Promise<Market | null>;
+    /**
+     * Resolve market tokens from CLOB API
+     *
+     * This method fetches the actual token IDs from the CLOB API,
+     * which are different from the calculated positionIds in standard CTF.
+     *
+     * ## Why This Method Exists
+     *
+     * Polymarket CLOB markets use custom ERC-1155 token IDs that are different
+     * from the standard CTF calculated positionIds:
+     *
+     * ```
+     * Standard CTF:  positionId = keccak256(USDC + keccak256(0x0 + conditionId + indexSet))
+     * Polymarket:    tokenId = custom value from CLOB API (e.g., "25064375110792...")
+     * ```
+     *
+     * This method provides the actual tokenIds needed for CTF operations
+     * (split, merge, redeem) on Polymarket markets.
+     *
+     * ## Usage with CTFClient
+     *
+     * Since CTFClient uses legacy `yesTokenId`/`noTokenId` naming,
+     * you need to convert when calling CTF methods:
+     *
+     * ```typescript
+     * const resolved = await sdk.markets.resolveMarketTokens(conditionId);
+     * if (resolved) {
+     *   const tokenIds = {
+     *     yesTokenId: resolved.primaryTokenId,
+     *     noTokenId: resolved.secondaryTokenId,
+     *   };
+     *   await ctfClient.redeemByTokenIds(conditionId, tokenIds);
+     * }
+     * ```
+     *
+     * @param conditionId - Market condition ID (0x...)
+     * @returns Resolved token IDs with outcome names, or null if not found
+     */
+    resolveMarketTokens(conditionId: string): Promise<ResolvedMarketTokens | null>;
+    /**
+     * Get multiple markets from CLOB
+     */
+    getClobMarkets(nextCursor?: string): Promise<{
+        markets: Market[];
+        nextCursor: string;
+    }>;
+    /**
+     * Get orderbook for a single token
+     */
+    getTokenOrderbook(tokenId: string): Promise<Orderbook>;
+    /**
+     * Get orderbooks for multiple tokens
+     */
+    getTokenOrderbooks(params: Array<{
+        tokenId: string;
+        side: Side;
+    }>): Promise<Map<string, Orderbook>>;
+    /**
+     * Get processed orderbook with arbitrage analysis for a market
+     */
+    getProcessedOrderbook(conditionId: string): Promise<ProcessedOrderbook>;
+    /**
+     * Get price history for a token
+     */
+    getPricesHistory(params: PriceHistoryParams): Promise<PricePoint[]>;
+    /**
+     * Get midpoint price for a token
+     */
+    getMidpoint(tokenId: string): Promise<number>;
+    /**
+     * Get spread for a token
+     */
+    getSpread(tokenId: string): Promise<number>;
+    /**
+     * Get last trade price for a token
+     */
+    getLastTradePrice(tokenId: string): Promise<number>;
+    /**
+     * Get market by slug or condition ID
+     */
+    getMarket(identifier: string): Promise<UnifiedMarket>;
+    private getMarketBySlug;
+    private getMarketByConditionId;
+    /**
+     * Get K-Line candles for a market (single token)
+     *
+     * @param conditionId - Market condition ID
+     * @param interval - K-line interval (1s, 5s, 15s, 30s, 1m, 5m, 15m, 30m, 1h, 4h, 12h, 1d)
+     * @param options - Query options
+     * @param options.limit - Maximum number of trades to fetch for aggregation (default: 1000)
+     * @param options.tokenId - Filter by specific token ID
+     * @param options.outcomeIndex - Filter by outcome index (0 = primary, 1 = secondary)
+     * @param options.startTimestamp - Start timestamp (Unix ms) - filter trades after this time
+     * @param options.endTimestamp - End timestamp (Unix ms) - filter trades before this time
+     *
+     * @example
+     * ```typescript
+     * // Get 5s candles for the last 15 minutes
+     * const now = Date.now();
+     * const candles = await sdk.markets.getKLines(conditionId, '5s', {
+     *   startTimestamp: now - 15 * 60 * 1000,
+     *   endTimestamp: now,
+     * });
+     * ```
+     */
+    getKLines(conditionId: string, interval: KLineInterval, options?: {
+        limit?: number;
+        tokenId?: string;
+        outcomeIndex?: number;
+        startTimestamp?: number;
+        endTimestamp?: number;
+    }): Promise<KLineCandle[]>;
+    /**
+     * Get dual K-Lines (YES + NO tokens)
+     *
+     * @param conditionId - Market condition ID
+     * @param interval - K-line interval (1s, 5s, 15s, 30s, 1m, 5m, 15m, 30m, 1h, 4h, 12h, 1d)
+     * @param options - Query options
+     * @param options.limit - Maximum number of trades to fetch for aggregation (default: 1000)
+     * @param options.startTimestamp - Start timestamp (Unix ms) - filter trades after this time
+     * @param options.endTimestamp - End timestamp (Unix ms) - filter trades before this time
+     *
+     * @example
+     * ```typescript
+     * // Get 15s dual K-lines for a 15-minute market
+     * const now = Date.now();
+     * const data = await sdk.markets.getDualKLines(conditionId, '15s', {
+     *   startTimestamp: now - 15 * 60 * 1000,
+     *   endTimestamp: now,
+     * });
+     * console.log(`Up candles: ${data.yes.length}, Down candles: ${data.no.length}`);
+     * ```
+     */
+    getDualKLines(conditionId: string, interval: KLineInterval, options?: {
+        limit?: number;
+        startTimestamp?: number;
+        endTimestamp?: number;
+    }): Promise<DualKLineData>;
+    /**
+     * Get aligned K-line data for token and underlying asset
+     *
+     * This method fetches K-line data from both Polymarket (token prices)
+     * and Binance (underlying asset prices), aligns them by timestamp,
+     * and optionally calculates Pearson correlation coefficients.
+     *
+     * @param conditionId - Market condition ID
+     * @param underlying - Underlying asset (BTC, ETH, SOL)
+     * @param interval - K-line interval (must be supported by both Poly and Binance)
+     * @param options - Optional parameters
+     * @returns Aligned data with optional correlation coefficients
+     *
+     * @example
+     * ```typescript
+     * const data = await marketService.getTokenUnderlyingData(
+     *   '0x123...',
+     *   'BTC',
+     *   '1h',
+     *   { limit: 100, calculateCorrelation: true }
+     * );
+     *
+     * // Access aligned data
+     * for (const point of data.data) {
+     *   console.log(`${point.timestamp}: Up=${point.upPrice}, BTC=${point.underlyingPrice}`);
+     * }
+     *
+     * // Check correlation
+     * if (data.correlation) {
+     *   console.log(`Correlation: ${data.correlation.upVsUnderlying}`);
+     * }
+     * ```
+     */
+    getTokenUnderlyingData(conditionId: string, underlying: UnderlyingAsset, interval: KLineInterval, options?: {
+        limit?: number;
+        calculateCorrelation?: boolean;
+    }): Promise<TokenUnderlyingCorrelation>;
+    /**
+     * Find the nearest available price for a timestamp
+     */
+    private findNearestPrice;
+    /**
+     * Calculate Pearson correlation coefficients
+     */
+    private calculatePearsonCorrelation;
+    /**
+     * Calculate Pearson correlation coefficient between two arrays
+     * Returns a value between -1 and 1
+     */
+    private pearson;
+    /**
+     * Aggregate trades into K-Line candles
+     *
+     * Note: Polymarket API may return timestamps in seconds or milliseconds.
+     * This function normalizes all timestamps to milliseconds for consistent handling.
+     */
+    private aggregateToKLines;
+    /**
+     * Analyze historical spread from trade close prices (for backtesting)
+     *
+     * This uses trade close prices, not orderbook bid/ask.
+     * Useful for:
+     * - Historical analysis / backtesting
+     * - Understanding past price movements
+     * - Identifying patterns when orderbook data unavailable
+     */
+    private analyzeHistoricalSpread;
+    /**
+     * Calculate real-time spread from orderbook (for live trading)
+     *
+     * This uses orderbook bid/ask prices for accurate arbitrage detection.
+     * Useful for:
+     * - Real-time arbitrage execution
+     * - Live trading decisions
+     * - Accurate profit calculations
+     */
+    private calculateRealtimeSpread;
+    /**
+     * Get real-time spread analysis only (without K-lines)
+     * Use this for quick arbitrage checks
+     */
+    getRealtimeSpread(conditionId: string): Promise<RealtimeSpreadAnalysis>;
+    /**
+     * Get processed orderbook with analytics (alias for getProcessedOrderbook)
+     */
+    getOrderbook(conditionId: string): Promise<ProcessedOrderbook>;
+    /**
+     * Detect arbitrage opportunity
+     *
+     * 使用有效价格（考虑镜像订单）计算套利机会
+     * 详细原理见: docs/01-polymarket-orderbook-arbitrage.md
+     */
+    detectArbitrage(conditionId: string, threshold?: number): Promise<ArbitrageOpportunity | null>;
+    /**
+     * Get trending markets
+     */
+    getTrendingMarkets(limit?: number): Promise<GammaMarket[]>;
+    /**
+     * Search markets
+     */
+    searchMarkets(params: {
+        active?: boolean;
+        closed?: boolean;
+        limit?: number;
+        offset?: number;
+        order?: string;
+    }): Promise<GammaMarket[]>;
+    /**
+     * Scan for short-term crypto markets (Up/Down markets ending soon)
+     *
+     * ## Market Types
+     * Polymarket has short-term crypto markets in two durations:
+     * - **5-minute markets**: slug pattern `{coin}-updown-5m-{timestamp}`
+     * - **15-minute markets**: slug pattern `{coin}-updown-15m-{timestamp}`
+     *
+     * ## Slug Pattern
+     * The timestamp in the slug is the START time of the time window:
+     * - 15-minute markets: `{coin}-updown-15m-{Math.floor(startTime / 900) * 900}`
+     * - 5-minute markets: `{coin}-updown-5m-{Math.floor(startTime / 300) * 300}`
+     *
+     * Example: `btc-updown-15m-1767456000` starts at 1767456000 (16:00:00 UTC)
+     * and ends 15 minutes later at 1767456900 (16:15:00 UTC)
+     *
+     * ## Supported Coins
+     * - BTC (Bitcoin)
+     * - ETH (Ethereum)
+     * - SOL (Solana)
+     * - XRP (Ripple)
+     *
+     * ## Market Lifecycle Rules
+     * 1. Markets are created ahead of time (before they become tradeable)
+     * 2. New markets may not have prices yet (show 0.5/0.5)
+     * 3. When one market ends, the next one is already open for trading
+     * 4. A market ending doesn't mean no price - it means resolution is pending
+     *
+     * ## Outcomes
+     * All crypto short-term markets have:
+     * - outcomes: ["Up", "Down"]
+     * - Resolution based on price movement during the time window
+     *
+     * @param options - Scan options
+     * @param options.minMinutesUntilEnd - Minimum minutes until market ends (default: 5)
+     * @param options.maxMinutesUntilEnd - Maximum minutes until market ends (default: 60)
+     * @param options.limit - Maximum number of markets to return (default: 20)
+     * @param options.sortBy - Sort field: 'endDate' | 'volume' | 'liquidity' (default: 'endDate')
+     * @param options.duration - Filter by duration: '5m' | '15m' | 'all' (default: 'all')
+     * @param options.coin - Filter by coin: 'BTC' | 'ETH' | 'SOL' | 'XRP' | 'all' (default: 'all')
+     * @returns Array of crypto short-term markets
+     *
+     * @example
+     * ```typescript
+     * // Find all 15-minute markets ending in 5-30 minutes
+     * const markets = await sdk.markets.scanCryptoShortTermMarkets({
+     *   minMinutesUntilEnd: 5,
+     *   maxMinutesUntilEnd: 30,
+     *   duration: '15m',
+     * });
+     *
+     * // Find BTC 5-minute markets only
+     * const btcMarkets = await sdk.markets.scanCryptoShortTermMarkets({
+     *   coin: 'BTC',
+     *   duration: '5m',
+     * });
+     * ```
+     */
+    scanCryptoShortTermMarkets(options?: {
+        minMinutesUntilEnd?: number;
+        maxMinutesUntilEnd?: number;
+        limit?: number;
+        sortBy?: 'endDate' | 'volume' | 'liquidity';
+        duration?: '5m' | '15m' | 'all';
+        coin?: 'BTC' | 'ETH' | 'SOL' | 'XRP' | 'all';
+    }): Promise<GammaMarket[]>;
+    /**
+     * Detect market signals (volume surge, depth imbalance, whale trades)
+     */
+    detectMarketSignals(conditionId: string): Promise<Array<{
+        type: 'volume_surge' | 'depth_imbalance' | 'whale_trade' | 'momentum';
+        severity: 'low' | 'medium' | 'high';
+        details: Record<string, unknown>;
+    }>>;
+    private normalizeClobMarket;
+    private processOrderbooks;
+    private mergeMarkets;
+    private fromGammaMarket;
+    private fromClobMarket;
+}
+export declare function getIntervalMs(interval: KLineInterval): number;
+//# sourceMappingURL=market-service.d.ts.map

package/dist/src/services/market-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"market-service.d.ts","sourceRoot":"","sources":["../../../src/services/market-service.ts"],"names":[],"mappings":"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"}