@vesper85/strategy-sdk 0.1.16 → 0.1.17

package/dist/clients/polymarket-client.d.ts

@@ -1,6 +1,6 @@
-import { GammaMarket, type Event as GammaEvent, type Tag, type Team, type Sport, type Series, type Comment as GammaComment, type SearchResults, type PaginatedResponse, type MarketFilters, type EventFilters, type EventPaginationFilters, type PaginationParams, type SearchParams } from 'polymarket-gamma';
+import { GammaMarket, type Event as GammaEvent, type Tag, type Team, type Sport, type Series, type Comment as GammaComment, type SearchResults, type PaginatedResponse, type MarketFilters, type EventPaginationFilters, type PaginationParams, type SearchParams } from 'polymarket-gamma';
 import { ethers } from 'ethers';
-import type { PolymarketAPI, PolymarketClientOptions, PolymarketLimitOrderParams, PolymarketMarketOrderParams, PolymarketOrderResponse, PolymarketOpenOrder, PolymarketCancelResponse, PolymarketOrderBook, PolymarketApprovalResult, SignerAPI } from '../types/osiris';
+import type { PolymarketAPI, PolymarketClientOptions, PolymarketLimitOrderParams, PolymarketMarketOrderParams, PolymarketOrderResponse, PolymarketOpenOrder, PolymarketCancelResponse, PolymarketOrderBook, PolymarketApprovalResult, SignerAPI, ExtendedEventFilters } from '../types/osiris';
 import type { Logger } from '../utils/logger';
 export declare class PolymarketClient implements PolymarketAPI {
     private logger;
@@ -111,7 +111,12 @@ export declare class PolymarketClient implements PolymarketAPI {
     }): Promise<GammaMarket[]>;
     getMarketTags(marketId: string): Promise<Tag[]>;
     getEvent(idOrSlug: string): Promise<GammaEvent>;
-    getEvents(filters?: EventFilters): Promise<GammaEvent[]>;
+    /**
+     * Get events with extended filters
+     * Makes a direct API call to support all filter parameters from the Polymarket API
+     * @see https://docs.polymarket.com/api-reference/events/list-events
+     */
+    getEvents(filters?: ExtendedEventFilters): Promise<GammaEvent[]>;
     getEventTags(eventId: string): Promise<Tag[]>;
     getEventsPaginated(filters?: EventPaginationFilters): Promise<PaginatedResponse<GammaEvent>>;
     getTags(params?: PaginationParams): Promise<Tag[]>;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export type { CodeStrategy, } from './types/strategy';
-export type { OsirisContext, OsirisState, PolymarketAPI, HyperliquidAPI, TechnicalAnalysisAPI, SignerAPI, PolymarketOrderSide, PolymarketLimitOrderParams, PolymarketMarketOrderParams, PolymarketOrderResponse, PolymarketOpenOrder, PolymarketCancelResponse, PolymarketOrderBook, PolymarketOrderBookEntry, PolymarketApprovalResult, PolymarketClientOptions, } from './types/osiris';
+export type { OsirisContext, OsirisState, PolymarketAPI, HyperliquidAPI, TechnicalAnalysisAPI, SignerAPI, PolymarketOrderSide, PolymarketLimitOrderParams, PolymarketMarketOrderParams, PolymarketOrderResponse, PolymarketOpenOrder, PolymarketCancelResponse, PolymarketOrderBook, PolymarketOrderBookEntry, PolymarketApprovalResult, PolymarketClientOptions, ExtendedEventFilters, } from './types/osiris';
 export type { EventType, EventSourceType, EventSubscription, EventConditions, StrategyEvent, EventData, EventSourceSubscribeMessage, EventSourceUnsubscribeMessage, EventSourceMessage, MarketSubscription, WalletSubscription, OpportunitySubscription, CustomSubscription, ClobMarketSubscription, ClobUserSubscription, ActivitySubscription, CommentsSubscription, CryptoPricesSubscription, RfqSubscription, } from './types/event-types';
 export { isMarketSubscription, isWalletSubscription, isOpportunitySubscription, isCustomSubscription, isClobMarketSubscription, isClobUserSubscription, isActivitySubscription, isCommentsSubscription, isCryptoPricesSubscription, isRfqSubscription, isPolymarketSubscription, isOsirisSubscription, } from './types/event-types';
 export { PolymarketClient, } from './clients/polymarket-client';

package/dist/index.js

@@ -474,6 +474,12 @@ var PolymarketClient = class {
       );
       this.logger.info("Deriving API credentials...");
       const apiCreds = await tempClient.createOrDeriveApiKey();
+      if (!apiCreds || !apiCreds.key || !apiCreds.secret) {
+        throw new Error(
+          "Failed to obtain API credentials from Polymarket. Please ensure your wallet is registered at polymarket.com and has accepted the Terms of Service."
+        );
+      }
+      this.logger.debug("API credentials obtained successfully");
       const signatureType = 0;
       this.clobClient = new ClobClient(
         this.options.clobHost,
@@ -1270,7 +1276,7 @@ var PolymarketClient = class {
       return Number(data.price);
     } catch (error) {
       this.logger.error(`Error fetching price for ${clobTokenId}`, error);
-      return 0;
+      throw error;
     }
   }
   async getAskPrice(clobTokenId) {
@@ -1365,8 +1371,84 @@ var PolymarketClient = class {
   async getEvent(idOrSlug) {
     return this.gammaClient.getEvent(idOrSlug);
   }
+  /**
+   * Get events with extended filters
+   * Makes a direct API call to support all filter parameters from the Polymarket API
+   * @see https://docs.polymarket.com/api-reference/events/list-events
+   */
   async getEvents(filters) {
-    return this.gammaClient.getEvents(filters);
+    if (!filters) {
+      return this.gammaClient.getEvents();
+    }
+    const extendedKeys = [
+      "exclude_tag_id",
+      "tag_id",
+      "tag_slug",
+      "related_tags",
+      "include_chat",
+      "include_template",
+      "recurrence",
+      "liquidity_min",
+      "liquidity_max",
+      "volume_min",
+      "volume_max",
+      "start_date_min",
+      "start_date_max",
+      "end_date_min",
+      "end_date_max",
+      "cyom"
+    ];
+    const hasExtendedFilters = extendedKeys.some((key) => filters[key] !== void 0);
+    if (!hasExtendedFilters) {
+      return this.gammaClient.getEvents(filters);
+    }
+    const baseUrl = "https://gamma-api.polymarket.com/events";
+    const params = new URLSearchParams();
+    const appendParam = (key, value) => {
+      if (value === void 0) return;
+      if (Array.isArray(value)) {
+        value.forEach((v) => params.append(key, v.toString()));
+      } else {
+        params.append(key, value.toString());
+      }
+    };
+    if (filters.limit !== void 0) params.append("limit", filters.limit.toString());
+    if (filters.offset !== void 0) params.append("offset", filters.offset.toString());
+    if (filters.order !== void 0) params.append("order", filters.order);
+    if (filters.ascending !== void 0) params.append("ascending", filters.ascending.toString());
+    appendParam("id", filters.id);
+    appendParam("tag_id", filters.tag_id);
+    appendParam("exclude_tag_id", filters.exclude_tag_id);
+    if (filters.slug !== void 0) params.append("slug", filters.slug);
+    if (filters.tag_slug !== void 0) params.append("tag_slug", filters.tag_slug);
+    if (filters.related_tags !== void 0) params.append("related_tags", filters.related_tags.toString());
+    if (filters.active !== void 0) params.append("active", filters.active.toString());
+    if (filters.archived !== void 0) params.append("archived", filters.archived.toString());
+    if (filters.featured !== void 0) params.append("featured", filters.featured.toString());
+    if (filters.cyom !== void 0) params.append("cyom", filters.cyom.toString());
+    if (filters.include_chat !== void 0) params.append("include_chat", filters.include_chat.toString());
+    if (filters.include_template !== void 0) params.append("include_template", filters.include_template.toString());
+    if (filters.recurrence !== void 0) params.append("recurrence", filters.recurrence);
+    if (filters.closed !== void 0) params.append("closed", filters.closed.toString());
+    if (filters.liquidity_min !== void 0) params.append("liquidity_min", filters.liquidity_min.toString());
+    if (filters.liquidity_max !== void 0) params.append("liquidity_max", filters.liquidity_max.toString());
+    if (filters.volume_min !== void 0) params.append("volume_min", filters.volume_min.toString());
+    if (filters.volume_max !== void 0) params.append("volume_max", filters.volume_max.toString());
+    if (filters.start_date_min !== void 0) params.append("start_date_min", filters.start_date_min);
+    if (filters.start_date_max !== void 0) params.append("start_date_max", filters.start_date_max);
+    if (filters.end_date_min !== void 0) params.append("end_date_min", filters.end_date_min);
+    if (filters.end_date_max !== void 0) params.append("end_date_max", filters.end_date_max);
+    const url = `${baseUrl}?${params.toString()}`;
+    try {
+      const response = await fetch(url);
+      if (!response.ok) {
+        throw new Error(`Failed to fetch events: ${response.statusText}`);
+      }
+      return await response.json();
+    } catch (error) {
+      this.logger.error("Error fetching events with extended filters", error);
+      throw error;
+    }
   }
   async getEventTags(eventId) {
     return this.gammaClient.getEventTags(eventId);

package/dist/types/osiris.d.ts

@@ -1,11 +1,69 @@
 import type { OHLCV, TAParams } from '@vesper85/technical-indicators';
 import type { BigNumber } from 'ethers';
-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 { Event as GammaEvent, Tag, Team, Sport, Series, Comment as GammaComment, SearchResults, PaginatedResponse, MarketFilters, 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>;
     set(key: string, value: any): Promise<void>;
 }
+/**
+ * Extended filters for Polymarket events API
+ * Includes all query parameters from https://docs.polymarket.com/api-reference/events/list-events
+ */
+export interface ExtendedEventFilters {
+    /** Maximum number of results to return */
+    limit?: number;
+    /** Number of results to skip */
+    offset?: number;
+    /** Comma-separated list of fields to order by */
+    order?: string;
+    /** Sort in ascending order */
+    ascending?: boolean;
+    /** Filter by event ID(s) - can be single ID or array */
+    id?: string | string[];
+    /** Filter by tag ID(s) - can be single ID or array of IDs */
+    tag_id?: number | number[];
+    /** Exclude events with tag ID(s) - can be single ID or array of IDs */
+    exclude_tag_id?: number | number[];
+    /** Filter by event slug */
+    slug?: string;
+    /** Filter by tag slug */
+    tag_slug?: string;
+    /** Include related tags */
+    related_tags?: boolean;
+    /** Filter by active status */
+    active?: boolean;
+    /** Filter by archived status */
+    archived?: boolean;
+    /** Filter by featured status */
+    featured?: boolean;
+    /** Filter by CYOM (Create Your Own Market) status */
+    cyom?: boolean;
+    /** Include chat data */
+    include_chat?: boolean;
+    /** Include template data */
+    include_template?: boolean;
+    /** Filter by recurrence */
+    recurrence?: string;
+    /** Filter by closed status */
+    closed?: boolean;
+    /** Minimum liquidity filter */
+    liquidity_min?: number;
+    /** Maximum liquidity filter */
+    liquidity_max?: number;
+    /** Minimum volume filter */
+    volume_min?: number;
+    /** Maximum volume filter */
+    volume_max?: number;
+    /** Minimum start date (ISO 8601 format) */
+    start_date_min?: string;
+    /** Maximum start date (ISO 8601 format) */
+    start_date_max?: string;
+    /** Minimum end date (ISO 8601 format) */
+    end_date_min?: string;
+    /** Maximum end date (ISO 8601 format) */
+    end_date_max?: string;
+}
 /**
  * Order side for Polymarket trades
  */
@@ -174,7 +232,12 @@ export interface PolymarketAPI {
     }): Promise<GammaMarket[]>;
     getMarketTags(marketId: string): Promise<Tag[]>;
     getEvent(idOrSlug: string): Promise<GammaEvent>;
-    getEvents(filters?: EventFilters): Promise<GammaEvent[]>;
+    /**
+     * Get events with optional filters
+     * @param filters - Extended event filters including exclude_tag_id, liquidity_min, volume_min, date filters, etc.
+     * @see https://docs.polymarket.com/api-reference/events/list-events
+     */
+    getEvents(filters?: ExtendedEventFilters): Promise<GammaEvent[]>;
     getEventTags(eventId: string): Promise<Tag[]>;
     getEventsPaginated(filters?: EventPaginationFilters): Promise<PaginatedResponse<GammaEvent>>;
     getTags(params?: PaginationParams): Promise<Tag[]>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vesper85/strategy-sdk",
-  "version": "0.1.16",
+  "version": "0.1.17",
   "type": "module",
   "description": "SDK for writing and running trading strategies with Polymarket and Hyperliquid integrations",
   "keywords": [