@vesper85/strategy-sdk 0.1.0 → 0.1.3

package/dist/types/event-types.d.ts

@@ -4,7 +4,7 @@
 /**
  * Supported event types
  */
-export type EventType = 'price' | 'orderbook' | 'time' | 'trade' | 'fill' | 'liquidation' | 'custom';
+export type EventType = 'price' | 'orderbook' | 'time' | 'trade' | 'fill' | 'liquidation' | 'wallet' | 'opportunity' | 'custom';
 /**
  * Conditions for filtering events
  */
@@ -25,22 +25,241 @@ export interface EventConditions {
     spreadBelow?: number;
     /** Trigger when volume exceeds this value */
     volumeAbove?: number;
+    /** Minimum smart score for wallet events */
+    minSmartScore?: number;
+    /** Minimum win rate for wallet events */
+    minWinRate?: number;
+    /** Minimum trade count for wallet events */
+    minTradeCount?: number;
+    /** Minimum conviction rate for wallet events */
+    minConvictionRate?: number;
+    /** Minimum opportunity score */
+    minScore?: number;
+    /** Filter by strategy type */
+    strategyType?: string;
+    /** Filter by status */
+    status?: 'active' | 'dismissed';
     [key: string]: any;
 }
 /**
- * Event subscription configuration
- * Defines what events a strategy wants to receive
+ * Event source type - determines which WebSocket server to connect to
  */
-export interface EventSubscription {
-    /** Type of event to subscribe to */
-    type: EventType;
-    /** Market/asset identifier (e.g., token ID, trading pair like "BTC-USD") */
-    market?: string;
+export type EventSourceType = 'osiris' | 'polymarket';
+/**
+ * Base subscription properties shared by all subscription types
+ */
+interface BaseSubscription {
+    /** Event source type (default: 'osiris') */
+    eventSource?: EventSourceType;
     /** Optional filter conditions */
     conditions?: EventConditions;
-    /** Optional custom channel name for the event source */
-    channel?: string;
 }
+/**
+ * Market subscription for price, orderbook, trade, and fill events
+ * Maps to Osiris topic: market:{market}
+ * Maps to Polymarket RTDS topics: crypto_prices, trades, orders
+ */
+export interface MarketSubscription extends BaseSubscription {
+    /** Type of market event to subscribe to */
+    type: 'price' | 'orderbook' | 'trade' | 'fill';
+    /** Market/asset identifier (e.g., market slug, token ID, trading pair like "BTC-USD") */
+    market: string;
+}
+/**
+ * Wallet subscription for wallet analysis events (Osiris only)
+ * Maps to Osiris topic: wallet:{wallet}
+ * Not supported by Polymarket RTDS
+ */
+export interface WalletSubscription extends BaseSubscription {
+    /** Wallet subscription type */
+    type: 'wallet';
+    /** Wallet address to subscribe to */
+    wallet: string;
+}
+/**
+ * Opportunity subscription for trading opportunity events (Osiris only)
+ * Maps to Osiris topic: opps:{filter}
+ * Not supported by Polymarket RTDS
+ */
+export interface OpportunitySubscription extends BaseSubscription {
+    /** Opportunity subscription type */
+    type: 'opportunity';
+    /**
+     * Optional filter for opportunities:
+     * - 'all' - All opportunities (default)
+     * - Strategy type (e.g., 'wide_spread_markets', 'closing_soon')
+     * - Market slug for specific market opportunities
+     */
+    filter?: string;
+}
+/**
+ * Custom subscription for user-defined event topics
+ * Allows direct topic specification for advanced use cases
+ */
+export interface CustomSubscription extends BaseSubscription {
+    /** Custom subscription type */
+    type: 'custom';
+    /** Full topic string (e.g., 'custom:my-topic' or any valid topic) */
+    topic: string;
+}
+/**
+ * CLOB Market subscription for Polymarket-specific market events
+ * Connects to the clob_market topic for real-time orderbook and price data
+ *
+ * @example
+ * ```typescript
+ * { type: 'clob_market', marketId: 'condition-id', messageType: 'agg_orderbook' }
+ * ```
+ */
+export interface ClobMarketSubscription extends BaseSubscription {
+    /** CLOB market subscription type */
+    type: 'clob_market';
+    /** Token ID or condition ID for CLOB market events */
+    marketId: string;
+    /**
+     * Specific message types:
+     * - 'price_change' - Price changes for the market
+     * - 'agg_orderbook' - Aggregated orderbook updates
+     * - 'last_trade_price' - Last trade price updates
+     * - 'tick_size_change' - Tick size changes
+     * - 'market_created' - New market creation events
+     * - 'market_resolved' - Market resolution events
+     * - '*' - All message types (default)
+     */
+    messageType?: 'price_change' | 'agg_orderbook' | 'last_trade_price' | 'tick_size_change' | 'market_created' | 'market_resolved' | '*';
+}
+/**
+ * CLOB User subscription for authenticated user-specific events
+ * Requires CLOB API credentials for authentication
+ *
+ * @example
+ * ```typescript
+ * { type: 'clob_user', messageType: 'order' }
+ * ```
+ */
+export interface ClobUserSubscription extends BaseSubscription {
+    /** CLOB user subscription type */
+    type: 'clob_user';
+    /**
+     * Specific message types:
+     * - 'order' - Order updates (placement, cancellation, fill)
+     * - 'trade' - Trade execution events
+     * - '*' - All message types (default)
+     */
+    messageType?: 'order' | 'trade' | '*';
+}
+/**
+ * Activity subscription for trade activity feed events
+ *
+ * @example
+ * ```typescript
+ * { type: 'activity', eventSlug: 'will-bitcoin-hit-100k' }
+ * ```
+ */
+export interface ActivitySubscription extends BaseSubscription {
+    /** Activity subscription type */
+    type: 'activity';
+    /** Event slug to filter trades (optional) */
+    eventSlug?: string;
+    /** Market slug to filter trades (optional) */
+    marketSlug?: string;
+    /**
+     * Specific message types:
+     * - 'trades' - Trade events
+     * - 'orders_matched' - Order match events
+     * - '*' - All message types (default)
+     */
+    messageType?: 'trades' | 'orders_matched' | '*';
+}
+/**
+ * Comments subscription for comment and reaction events
+ *
+ * @example
+ * ```typescript
+ * { type: 'comments', parentEntityId: 100, parentEntityType: 'Event' }
+ * ```
+ */
+export interface CommentsSubscription extends BaseSubscription {
+    /** Comments subscription type */
+    type: 'comments';
+    /** Parent entity ID to filter comments */
+    parentEntityId?: number;
+    /** Parent entity type */
+    parentEntityType?: 'Event' | 'Series';
+    /**
+     * Specific message types:
+     * - 'comment_created' - New comment events
+     * - 'comment_removed' - Comment removal events
+     * - 'reaction_created' - Reaction added events
+     * - 'reaction_removed' - Reaction removed events
+     * - '*' - All message types (default)
+     */
+    messageType?: 'comment_created' | 'comment_removed' | 'reaction_created' | 'reaction_removed' | '*';
+}
+/**
+ * Crypto prices subscription for real-time cryptocurrency price updates
+ *
+ * @example
+ * ```typescript
+ * { type: 'crypto_prices', symbol: 'btcusdt' }
+ * ```
+ */
+export interface CryptoPricesSubscription extends BaseSubscription {
+    /** Crypto prices subscription type */
+    type: 'crypto_prices';
+    /** Symbol to filter (e.g., 'btcusdt', 'ethusdt') */
+    symbol?: string;
+}
+/**
+ * RFQ subscription for Request for Quote events
+ *
+ * @example
+ * ```typescript
+ * { type: 'rfq', messageType: 'request_created' }
+ * ```
+ */
+export interface RfqSubscription extends BaseSubscription {
+    /** RFQ subscription type */
+    type: 'rfq';
+    /**
+     * Specific message types:
+     * - 'request_created' - New RFQ request
+     * - 'request_edited' - RFQ request edited
+     * - 'request_canceled' - RFQ request canceled
+     * - 'request_expired' - RFQ request expired
+     * - 'quote_created' - New quote
+     * - 'quote_edited' - Quote edited
+     * - 'quote_canceled' - Quote canceled
+     * - 'quote_expired' - Quote expired
+     * - '*' - All message types (default)
+     */
+    messageType?: 'request_created' | 'request_edited' | 'request_canceled' | 'request_expired' | 'quote_created' | 'quote_edited' | 'quote_canceled' | 'quote_expired' | '*';
+}
+/**
+ * Event subscription configuration (discriminated union)
+ * Defines what events a strategy wants to receive
+ *
+ * @example Market subscription
+ * ```typescript
+ * { type: 'price', market: 'BTC-USD' }
+ * ```
+ *
+ * @example Wallet subscription (Osiris only)
+ * ```typescript
+ * { type: 'wallet', wallet: '0x123...', conditions: { minWinRate: 60 } }
+ * ```
+ *
+ * @example Opportunity subscription (Osiris only)
+ * ```typescript
+ * { type: 'opportunity', filter: 'wide_spread_markets' }
+ * ```
+ *
+ * @example CLOB Market subscription (Polymarket only)
+ * ```typescript
+ * { type: 'clob_market', marketId: 'condition-id', messageType: 'agg_orderbook' }
+ * ```
+ */
+export type EventSubscription = MarketSubscription | WalletSubscription | OpportunitySubscription | CustomSubscription | ClobMarketSubscription | ClobUserSubscription | ActivitySubscription | CommentsSubscription | CryptoPricesSubscription | RfqSubscription;
 /**
  * Data payload for strategy events
  */
@@ -82,8 +301,10 @@ export interface StrategyEvent {
     type: EventType;
     /** Timestamp when event occurred (Unix milliseconds) */
     timestamp: number;
-    /** Market/asset this event relates to */
+    /** Market/asset this event relates to (for market events) */
     market?: string;
+    /** Wallet address this event relates to (for wallet events) */
+    wallet?: string;
     /** Event-specific data payload */
     data: EventData;
 }
@@ -99,4 +320,53 @@ export interface EventSourceUnsubscribeMessage {
     subscriptions: EventSubscription[];
 }
 export type EventSourceMessage = EventSourceSubscribeMessage | EventSourceUnsubscribeMessage;
+/**
+ * Check if subscription is a MarketSubscription
+ */
+export declare function isMarketSubscription(sub: EventSubscription): sub is MarketSubscription;
+/**
+ * Check if subscription is a WalletSubscription
+ */
+export declare function isWalletSubscription(sub: EventSubscription): sub is WalletSubscription;
+/**
+ * Check if subscription is an OpportunitySubscription
+ */
+export declare function isOpportunitySubscription(sub: EventSubscription): sub is OpportunitySubscription;
+/**
+ * Check if subscription is a CustomSubscription
+ */
+export declare function isCustomSubscription(sub: EventSubscription): sub is CustomSubscription;
+/**
+ * Check if subscription is a ClobMarketSubscription
+ */
+export declare function isClobMarketSubscription(sub: EventSubscription): sub is ClobMarketSubscription;
+/**
+ * Check if subscription is a ClobUserSubscription
+ */
+export declare function isClobUserSubscription(sub: EventSubscription): sub is ClobUserSubscription;
+/**
+ * Check if subscription is an ActivitySubscription
+ */
+export declare function isActivitySubscription(sub: EventSubscription): sub is ActivitySubscription;
+/**
+ * Check if subscription is a CommentsSubscription
+ */
+export declare function isCommentsSubscription(sub: EventSubscription): sub is CommentsSubscription;
+/**
+ * Check if subscription is a CryptoPricesSubscription
+ */
+export declare function isCryptoPricesSubscription(sub: EventSubscription): sub is CryptoPricesSubscription;
+/**
+ * Check if subscription is an RfqSubscription
+ */
+export declare function isRfqSubscription(sub: EventSubscription): sub is RfqSubscription;
+/**
+ * Check if subscription is a Polymarket-specific subscription
+ */
+export declare function isPolymarketSubscription(sub: EventSubscription): boolean;
+/**
+ * Check if subscription is an Osiris-specific subscription
+ */
+export declare function isOsirisSubscription(sub: EventSubscription): boolean;
+export {};
 //# sourceMappingURL=event-types.d.ts.map

package/dist/types/gamma.d.ts

@@ -0,0 +1,135 @@
+export interface GammaMarket {
+    id: string;
+    conditionId: string;
+    slug: string;
+    question: string;
+    description: string;
+    category: string;
+    image: string;
+    icon: string;
+    twitterCardImage: string;
+    active: boolean;
+    closed: boolean;
+    archived: boolean;
+    ready: boolean;
+    restricted: boolean;
+    endDate: string;
+    endDateIso: string;
+    createdAt: string;
+    updatedAt: string;
+    closedTime?: string;
+    hasReviewedDates: boolean;
+    readyForCron: boolean;
+    marketType: string;
+    liquidity: string;
+    volume: string;
+    volumeNum: number;
+    liquidityNum: number;
+    volume24hr: number;
+    volume1wk: number;
+    volume1mo: number;
+    volume1yr: number;
+    bestBid: number;
+    bestAsk: number;
+    lastTradePrice: number;
+    spread: number;
+    oneDayPriceChange: number;
+    oneHourPriceChange: number;
+    oneWeekPriceChange: number;
+    oneMonthPriceChange: number;
+    oneYearPriceChange: number;
+    outcomes: string;
+    outcomePrices: string;
+    clobTokenIds: string;
+    umaResolutionStatuses: string;
+    marketMakerAddress: string;
+    updatedBy: number;
+    mailchimpTag?: string;
+    fpmmLive: boolean;
+    creator: string;
+    funded: boolean;
+    cyom: boolean;
+    competitive: number;
+    pagerDutyNotificationEnabled: boolean;
+    approved: boolean;
+    rewardsMinSize: number;
+    rewardsMaxSpread: number;
+    clearBookOnStart: boolean;
+    manualActivation: boolean;
+    negRiskOther: boolean;
+    pendingDeployment: boolean;
+    deploying: boolean;
+    rfqEnabled: boolean;
+    holdingRewardsEnabled: boolean;
+    feesEnabled: boolean;
+    requiresTranslation: boolean;
+    volume1wkAmm: number;
+    volume1moAmm: number;
+    volume1yrAmm: number;
+    volume1wkClob: number;
+    volume1moClob: number;
+    volume1yrClob: number;
+    events: any[];
+}
+export interface Event {
+    id?: string;
+    slug?: string;
+    title?: string;
+    description?: string;
+    start_date?: string;
+    end_date?: string;
+    image?: string;
+    icon?: string;
+    created_at?: string;
+    updated_at?: string;
+    archived?: boolean;
+    active?: boolean;
+    closed?: boolean;
+    restricted?: boolean;
+    liquidity?: number;
+    volume?: string;
+    markets?: GammaMarket[];
+    tags?: Tag[];
+    categories?: Category[];
+    series?: Series[];
+    comment_count?: number;
+    enable_comment?: boolean;
+    ticker?: string;
+}
+export interface Series {
+    id?: string;
+    slug?: string;
+    title?: string;
+    description?: string;
+    image?: string;
+    created_at?: string;
+    updated_at?: string;
+    events?: Event[];
+    categories?: Category[];
+}
+export interface Category {
+    id?: string;
+    label?: string;
+    slug?: string;
+}
+export interface Tag {
+    id?: string;
+    label?: string;
+    slug?: string;
+    description?: string;
+    event_count?: number;
+    market_count?: number;
+    parent_id?: string;
+    children?: Tag[];
+}
+export interface ClobReward {
+    id?: string;
+    market_id?: string;
+    event_id?: string;
+    reward_epoch?: number;
+    asset_address?: string;
+    reward_amount?: string;
+    start_date?: string;
+    end_date?: string;
+}
+//# sourceMappingURL=gamma.d.ts.map

package/dist/types/osiris.d.ts

@@ -1,5 +1,5 @@
-import type { OHLCV, TAParams } from "@vesper85/technical-indicators";
-import type { GammaMarket, Event as GammaEvent, Tag, Team, Sport, Series, Comment as GammaComment, SearchResults, PaginatedResponse, MarketFilters, EventFilters, EventPaginationFilters, PaginationParams, SearchParams } from "polymarket-gamma";
+import type { OHLCV, TAParams } from "@osiris-ai/technical-indicators";
+import type { Event as GammaEvent, Tag, Team, Sport, Series, Comment as GammaComment, SearchResults, PaginatedResponse, MarketFilters, EventFilters, EventPaginationFilters, PaginationParams, SearchParams, GammaMarket } from "polymarket-gamma";
 import type { ClearinghouseState, SpotMeta, SpotClearinghouseState, SpotMetaAndAssetCtxs, Meta, MetaAndAssetCtxs, UserFunding, UserNonFundingLedgerUpdates, FundingHistory, PredictedFundings, PerpsAtOpenInterestCap, PerpDexLimits, AllMids, UserOpenOrders, FrontendOpenOrders, UserFills, UserRateLimit, OrderStatus, L2Book, CandleSnapshot, HistoricalOrder, TwapSliceFill, SubAccount, VaultDetails, VaultEquity, UserRole, Delegation, DelegatorSummary, DelegatorHistoryEntry, DelegatorReward, ValidatorSummary, VaultSummary, UserFees, PortfolioPeriods, PreTransferCheck, Referral, ExtraAgent, LegalCheck, TwapHistory, MultiSigSigners, BuilderFeeApproval, UserOrderHistory } from "hyperliquid";
 export interface OsirisState {
     get(key: string): Promise<any>;
@@ -128,10 +128,7 @@ export interface PolymarketClientOptions {
     mcpUrl?: string;
     /**
      * MCP OAuth access token for authenticated MCP calls.
-     * IMPORTANT: This must be an MCP-specific token obtained through the Osiris Hub
-     * OAuth flow for MCP packages (via /hub/authorize endpoint with MCP scopes).
-     * This is NOT the same as the general backend access token.
-     * Required scopes: osiris:auth, osiris:auth:action
+     * Required when using MCP mode for order placement.
      */
     mcpAccessToken?: string;
     /**
@@ -278,50 +275,16 @@ export interface PolymarketAPI {
      * @returns Order book data
      */
     getOrderBook(tokenId: string): Promise<PolymarketOrderBook>;
-    /**
-     * Place a limit buy order
-     * @param tokenId Token ID of the outcome
-     * @param price Price per share (0-1 range)
-     * @param size Number of shares to buy
-     * @returns Order response
-     */
-    buyLimit(tokenId: string, price: number, size: number): Promise<PolymarketOrderResponse>;
-    /**
-     * Place a limit sell order
-     * @param tokenId Token ID of the outcome
-     * @param price Price per share (0-1 range)
-     * @param size Number of shares to sell
-     * @returns Order response
-     */
-    sellLimit(tokenId: string, price: number, size: number): Promise<PolymarketOrderResponse>;
-    /**
-     * Place a market buy order (executes immediately at best price)
-     * @param tokenId Token ID of the outcome
-     * @param amount Amount in USDC to spend
-     * @param slippage Slippage tolerance as decimal (e.g., 0.05 for 5%). Default: 0.05
-     * @returns Order response
-     */
-    buyMarket(tokenId: string, amount: number, slippage?: number): Promise<PolymarketOrderResponse>;
-    /**
-     * Place a market sell order (executes immediately at best price)
-     * @param tokenId Token ID of the outcome
-     * @param size Number of shares to sell
-     * @param slippage Slippage tolerance as decimal (e.g., 0.05 for 5%). Default: 0.05
-     * @returns Order response
-     */
-    sellMarket(tokenId: string, size: number, slippage?: number): Promise<PolymarketOrderResponse>;
     /**
      * Buy shares of an outcome token (uses market order)
      * @param tokenId Token ID of the outcome
      * @param size Amount in USDC to spend
-     * @deprecated Use buyMarket() instead
      */
     buy(tokenId: string, size: number): Promise<void>;
     /**
      * Sell shares of an outcome token (uses market order)
      * @param tokenId Token ID of the outcome
      * @param size Number of shares to sell
-     * @deprecated Use sellMarket() instead
      */
     sell(tokenId: string, size: number): Promise<void>;
 }

package/dist/utils/index.d.ts

@@ -0,0 +1,3 @@
+import { GammaMarket } from "polymarket-gamma";
+export declare function mapToGammaMarket(raw: any): GammaMarket;
+//# sourceMappingURL=index.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vesper85/strategy-sdk",
-  "version": "0.1.0",
+  "version": "0.1.3",
   "type": "module",
   "description": "SDK for writing and running trading strategies with Polymarket and Hyperliquid integrations",
   "keywords": [
@@ -15,8 +15,9 @@
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
+      "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "default": "./dist/index.js"
     },
     "./package.json": "./package.json"
   },
@@ -43,8 +44,9 @@
     "release": "npm run build && changeset publish"
   },
   "dependencies": {
-    "@vesper85/technical-indicators": "^0.1.0",
     "@polymarket/clob-client": "^4.6.0",
+    "@polymarket/real-time-data-client": "^1.0.0",
+    "@vesper85/technical-indicators": "^0.1.0",
     "axios": "^1.7.9",
     "ethers": "^6.13.4",
     "hyperliquid": "^1.7.7",
@@ -73,4 +75,4 @@
     "url": "https://github.com/FetcchX/legion-sdk/issues"
   },
   "homepage": "https://github.com/FetcchX/legion-sdk#readme"
-}
+}