@ebowwa/polymarket-client 1.0.0

package/dist/client.d.ts

@@ -0,0 +1,135 @@
+/**
+ * @codespaces/polymarket/client
+ *
+ * Polymarket API client wrapper for prediction markets integration.
+ * Provides access to Gamma API, CLOB API, and Data API.
+ */
+/**
+ * Polymarket market data structure
+ */
+export interface PolymarketMarket {
+    condition_id: string;
+    markets: Array<{
+        market_id: string;
+        question: string;
+        description: string;
+        end_date: string;
+        active: boolean;
+        closed: boolean;
+        volume: number;
+        liquidity: number;
+        token_id: string;
+        outcome_prices: number[];
+    }>;
+}
+/**
+ * Polymarket event data structure
+ */
+export interface PolymarketEvent {
+    id: string;
+    slug: string;
+    title: string;
+    description: string;
+    start_date: string;
+    end_date?: string;
+    image: string;
+    markets: string[];
+    tags: string[];
+}
+/**
+ * Polymarket profile data structure
+ */
+export interface PolymarketProfile {
+    wallet_address: string;
+    username?: string;
+    profit_loss?: number;
+    volume?: number;
+    trades?: number;
+    markets_traded?: number;
+    biggest_win?: number;
+}
+/**
+ * Polymarket order book data structure
+ */
+export interface PolymarketOrderBook {
+    market_id: string;
+    bids: Array<{
+        price: number;
+        size: number;
+    }>;
+    asks: Array<{
+        price: number;
+        size: number;
+    }>;
+    last_updated: number;
+}
+/**
+ * Polymarket client configuration
+ */
+export interface PolymarketClientConfig {
+    gammaApiBase?: string;
+    clobApiBase?: string;
+    dataApiBase?: string;
+    debug?: boolean;
+}
+/**
+ * Polymarket API client
+ */
+export declare class PolymarketClient {
+    private gammaApiBase;
+    private clobApiBase;
+    private dataApiBase;
+    private debug;
+    constructor(config?: PolymarketClientConfig);
+    private debugLog;
+    listMarkets(params?: {
+        limit?: number;
+        offset?: number;
+        archived?: boolean;
+        closed?: boolean;
+        active?: boolean;
+        order?: 'volume' | 'liquidity' | 'createdAt';
+        order_dir?: 'asc' | 'desc';
+    }): Promise<{
+        markets: PolymarketMarket[];
+    }>;
+    getMarket(conditionId: string): Promise<{
+        market: PolymarketMarket;
+    }>;
+    listEvents(params?: {
+        limit?: number;
+        offset?: number;
+        archived?: boolean;
+        closed?: boolean;
+        tag_id?: string;
+    }): Promise<{
+        events: PolymarketEvent[];
+    }>;
+    getEvent(eventSlug: string): Promise<{
+        event: PolymarketEvent;
+    }>;
+    getProfile(walletAddress: string): Promise<{
+        profile: PolymarketProfile;
+    }>;
+    search(query: string, params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<any>;
+    getOrderbook(tokenId: string): Promise<{
+        orderbook: PolymarketOrderBook;
+    }>;
+    getTrades(tokenId: string, limit?: number): Promise<any>;
+    getPrice(tokenId: string): Promise<{
+        price: number;
+    }>;
+    getPositions(walletAddress: string): Promise<any>;
+    getWalletTrades(walletAddress: string, params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<any>;
+}
+/**
+ * Create a new Polymarket client
+ */
+export declare function createPolymarketClient(config?: PolymarketClientConfig): PolymarketClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @codespaces/polymarket
+ *
+ * Polymarket prediction markets SDK wrapper and utilities.
+ */
+export * from './client.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,170 @@
+// src/client.ts
+class PolymarketClient {
+  gammaApiBase;
+  clobApiBase;
+  dataApiBase;
+  debug;
+  constructor(config = {}) {
+    this.gammaApiBase = config.gammaApiBase || "https://gamma-api.polymarket.com";
+    this.clobApiBase = config.clobApiBase || "https://clob.polymarket.com";
+    this.dataApiBase = config.dataApiBase || "https://data-api.polymarket.com";
+    this.debug = config.debug || false;
+  }
+  debugLog(...args) {
+    if (this.debug) {
+      console.log("[Polymarket Client]", ...args);
+    }
+  }
+  async listMarkets(params = {}) {
+    const searchParams = new URLSearchParams;
+    if (params.limit)
+      searchParams.set("limit", params.limit.toString());
+    if (params.offset)
+      searchParams.set("offset", params.offset.toString());
+    if (params.archived !== undefined)
+      searchParams.set("archived", params.archived.toString());
+    if (params.closed !== undefined)
+      searchParams.set("closed", params.closed.toString());
+    if (params.active !== undefined)
+      searchParams.set("active", params.active.toString());
+    if (params.order)
+      searchParams.set("order", params.order);
+    if (params.order_dir)
+      searchParams.set("order_dir", params.order_dir);
+    const response = await fetch(`${this.gammaApiBase}/markets?${searchParams.toString()}`);
+    if (!response.ok) {
+      throw new Error(`Gamma API error: ${response.status} ${response.statusText}`);
+    }
+    const data = await response.json();
+    return { markets: Array.isArray(data) ? data : [] };
+  }
+  async getMarket(conditionId) {
+    const response = await fetch(`${this.gammaApiBase}/markets/${conditionId}`);
+    if (!response.ok) {
+      throw new Error(`Gamma API error: ${response.status} ${response.statusText}`);
+    }
+    const data = await response.json();
+    return { market: data };
+  }
+  async listEvents(params = {}) {
+    const searchParams = new URLSearchParams;
+    if (params.limit)
+      searchParams.set("limit", params.limit.toString());
+    if (params.offset)
+      searchParams.set("offset", params.offset.toString());
+    if (params.archived !== undefined)
+      searchParams.set("archived", params.archived.toString());
+    if (params.closed !== undefined)
+      searchParams.set("closed", params.closed.toString());
+    if (params.tag_id)
+      searchParams.set("tag_id", params.tag_id);
+    const response = await fetch(`${this.gammaApiBase}/events?${searchParams.toString()}`);
+    if (!response.ok) {
+      throw new Error(`Gamma API error: ${response.status} ${response.statusText}`);
+    }
+    const data = await response.json();
+    return { events: Array.isArray(data) ? data : [] };
+  }
+  async getEvent(eventSlug) {
+    const response = await fetch(`${this.gammaApiBase}/events/${eventSlug}`);
+    if (!response.ok) {
+      throw new Error(`Gamma API error: ${response.status} ${response.statusText}`);
+    }
+    const data = await response.json();
+    return { event: data };
+  }
+  async getProfile(walletAddress) {
+    const response = await fetch(`${this.gammaApiBase}/profiles/${walletAddress}`);
+    if (!response.ok) {
+      throw new Error(`Gamma API error: ${response.status} ${response.statusText}`);
+    }
+    const data = await response.json();
+    return { profile: data };
+  }
+  async search(query, params = {}) {
+    const searchLower = query.toLowerCase();
+    const limit = params.limit || 20;
+    const offset = params.offset || 0;
+    try {
+      const searchParams = new URLSearchParams;
+      searchParams.set("query", query);
+      if (params.limit)
+        searchParams.set("limit", params.limit.toString());
+      if (params.offset)
+        searchParams.set("offset", params.offset.toString());
+      const response = await fetch(`${this.gammaApiBase}/search?${searchParams.toString()}`);
+      if (response.ok) {
+        return response.json();
+      }
+      this.debugLog(`Search endpoint returned ${response.status}, falling back to client-side`);
+    } catch (error) {
+      this.debugLog("Search endpoint error:", error);
+    }
+    const fetchResult = await this.listMarkets({ limit: 500 });
+    const allMarkets = fetchResult.markets || [];
+    const filtered = allMarkets.filter((m) => {
+      const question = (m.question || "").toLowerCase();
+      const description = (m.description || "").toLowerCase();
+      const slug = (m.slug || "").toLowerCase();
+      const tags = (m.tags || []).join(" ").toLowerCase();
+      return question.includes(searchLower) || description.includes(searchLower) || slug.includes(searchLower) || tags.includes(searchLower);
+    });
+    const paginated = filtered.slice(offset, offset + limit);
+    return {
+      markets: paginated,
+      total: filtered.length,
+      query,
+      note: "Results filtered client-side"
+    };
+  }
+  async getOrderbook(tokenId) {
+    const response = await fetch(`${this.clobApiBase}/orderbook?token_id=${tokenId}`);
+    if (!response.ok) {
+      throw new Error(`CLOB API error: ${response.status} ${response.statusText}`);
+    }
+    const data = await response.json();
+    return { orderbook: data };
+  }
+  async getTrades(tokenId, limit = 100) {
+    const response = await fetch(`${this.clobApiBase}/history?token_id=${tokenId}&limit=${limit}`);
+    if (!response.ok) {
+      throw new Error(`CLOB API error: ${response.status} ${response.statusText}`);
+    }
+    return response.json();
+  }
+  async getPrice(tokenId) {
+    const response = await fetch(`${this.clobApiBase}/price?token_id=${tokenId}`);
+    if (!response.ok) {
+      throw new Error(`CLOB API error: ${response.status} ${response.statusText}`);
+    }
+    const data = await response.json();
+    return { price: data.price };
+  }
+  async getPositions(walletAddress) {
+    const response = await fetch(`${this.dataApiBase}/positions?wallet=${walletAddress}`);
+    if (!response.ok) {
+      throw new Error(`Data API error: ${response.status} ${response.statusText}`);
+    }
+    return response.json();
+  }
+  async getWalletTrades(walletAddress, params = {}) {
+    const searchParams = new URLSearchParams;
+    searchParams.set("wallet", walletAddress);
+    if (params.limit)
+      searchParams.set("limit", params.limit.toString());
+    if (params.offset)
+      searchParams.set("offset", params.offset.toString());
+    const response = await fetch(`${this.dataApiBase}/trades?${searchParams.toString()}`);
+    if (!response.ok) {
+      throw new Error(`Data API error: ${response.status} ${response.statusText}`);
+    }
+    return response.json();
+  }
+}
+function createPolymarketClient(config) {
+  return new PolymarketClient(config);
+}
+export {
+  createPolymarketClient,
+  PolymarketClient
+};

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@ebowwa/polymarket-client",
+  "version": "1.0.0",
+  "description": "Polymarket prediction markets SDK wrapper and utilities",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js"
+    },
+    "./gamma": {
+      "types": "./dist/gamma.d.ts",
+      "import": "./dist/gamma.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "bun build src/index.ts --outdir dist --target node && tsc --emitDeclarationOnly",
+    "dev": "bun --watch src/index.ts",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test",
+    "prepublishOnly": "bun run build"
+  },
+  "keywords": [
+    "polymarket",
+    "prediction-markets",
+    "trading",
+    "clob",
+    "gamma-api"
+  ],
+  "author": "ebowwa",
+  "license": "MIT",
+  "dependencies": {
+    "@polymarket/clob-client": "^2.0.0"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.8",
+    "typescript": "^5.7.2"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}

package/src/client.ts

@@ -0,0 +1,304 @@
+/**
+ * @codespaces/polymarket/client
+ *
+ * Polymarket API client wrapper for prediction markets integration.
+ * Provides access to Gamma API, CLOB API, and Data API.
+ */
+
+/**
+ * Polymarket market data structure
+ */
+export interface PolymarketMarket {
+  condition_id: string;
+  markets: Array<{
+    market_id: string;
+    question: string;
+    description: string;
+    end_date: string;
+    active: boolean;
+    closed: boolean;
+    volume: number;
+    liquidity: number;
+    token_id: string;
+    outcome_prices: number[];
+  }>;
+}
+
+/**
+ * Polymarket event data structure
+ */
+export interface PolymarketEvent {
+  id: string;
+  slug: string;
+  title: string;
+  description: string;
+  start_date: string;
+  end_date?: string;
+  image: string;
+  markets: string[];
+  tags: string[];
+}
+
+/**
+ * Polymarket profile data structure
+ */
+export interface PolymarketProfile {
+  wallet_address: string;
+  username?: string;
+  profit_loss?: number;
+  volume?: number;
+  trades?: number;
+  markets_traded?: number;
+  biggest_win?: number;
+}
+
+/**
+ * Polymarket order book data structure
+ */
+export interface PolymarketOrderBook {
+  market_id: string;
+  bids: Array<{ price: number; size: number }>;
+  asks: Array<{ price: number; size: number }>;
+  last_updated: number;
+}
+
+/**
+ * Polymarket client configuration
+ */
+export interface PolymarketClientConfig {
+  gammaApiBase?: string;
+  clobApiBase?: string;
+  dataApiBase?: string;
+  debug?: boolean;
+}
+
+/**
+ * Polymarket API client
+ */
+export class PolymarketClient {
+  private gammaApiBase: string;
+  private clobApiBase: string;
+  private dataApiBase: string;
+  private debug: boolean;
+
+  constructor(config: PolymarketClientConfig = {}) {
+    this.gammaApiBase = config.gammaApiBase || 'https://gamma-api.polymarket.com';
+    this.clobApiBase = config.clobApiBase || 'https://clob.polymarket.com';
+    this.dataApiBase = config.dataApiBase || 'https://data-api.polymarket.com';
+    this.debug = config.debug || false;
+  }
+
+  private debugLog(...args: unknown[]) {
+    if (this.debug) {
+      console.log('[Polymarket Client]', ...args);
+    }
+  }
+
+  // ============================================================================
+  // GAMMA API (Market Discovery)
+  // ============================================================================
+
+  async listMarkets(params: {
+    limit?: number;
+    offset?: number;
+    archived?: boolean;
+    closed?: boolean;
+    active?: boolean;
+    order?: 'volume' | 'liquidity' | 'createdAt';
+    order_dir?: 'asc' | 'desc';
+  } = {}): Promise<{ markets: PolymarketMarket[] }> {
+    const searchParams = new URLSearchParams();
+    if (params.limit) searchParams.set('limit', params.limit.toString());
+    if (params.offset) searchParams.set('offset', params.offset.toString());
+    if (params.archived !== undefined) searchParams.set('archived', params.archived.toString());
+    if (params.closed !== undefined) searchParams.set('closed', params.closed.toString());
+    if (params.active !== undefined) searchParams.set('active', params.active.toString());
+    if (params.order) searchParams.set('order', params.order);
+    if (params.order_dir) searchParams.set('order_dir', params.order_dir);
+
+    const response = await fetch(`${this.gammaApiBase}/markets?${searchParams.toString()}`);
+    if (!response.ok) {
+      throw new Error(`Gamma API error: ${response.status} ${response.statusText}`);
+    }
+
+    const data = await response.json();
+    return { markets: Array.isArray(data) ? data : [] };
+  }
+
+  async getMarket(conditionId: string): Promise<{ market: PolymarketMarket }> {
+    const response = await fetch(`${this.gammaApiBase}/markets/${conditionId}`);
+    if (!response.ok) {
+      throw new Error(`Gamma API error: ${response.status} ${response.statusText}`);
+    }
+
+    const data = await response.json() as PolymarketMarket;
+    return { market: data };
+  }
+
+  async listEvents(params: {
+    limit?: number;
+    offset?: number;
+    archived?: boolean;
+    closed?: boolean;
+    tag_id?: string;
+  } = {}): Promise<{ events: PolymarketEvent[] }> {
+    const searchParams = new URLSearchParams();
+    if (params.limit) searchParams.set('limit', params.limit.toString());
+    if (params.offset) searchParams.set('offset', params.offset.toString());
+    if (params.archived !== undefined) searchParams.set('archived', params.archived.toString());
+    if (params.closed !== undefined) searchParams.set('closed', params.closed.toString());
+    if (params.tag_id) searchParams.set('tag_id', params.tag_id);
+
+    const response = await fetch(`${this.gammaApiBase}/events?${searchParams.toString()}`);
+    if (!response.ok) {
+      throw new Error(`Gamma API error: ${response.status} ${response.statusText}`);
+    }
+
+    const data = await response.json();
+    return { events: Array.isArray(data) ? data : [] };
+  }
+
+  async getEvent(eventSlug: string): Promise<{ event: PolymarketEvent }> {
+    const response = await fetch(`${this.gammaApiBase}/events/${eventSlug}`);
+    if (!response.ok) {
+      throw new Error(`Gamma API error: ${response.status} ${response.statusText}`);
+    }
+
+    const data = await response.json() as PolymarketEvent;
+    return { event: data };
+  }
+
+  async getProfile(walletAddress: string): Promise<{ profile: PolymarketProfile }> {
+    const response = await fetch(`${this.gammaApiBase}/profiles/${walletAddress}`);
+    if (!response.ok) {
+      throw new Error(`Gamma API error: ${response.status} ${response.statusText}`);
+    }
+
+    const data = await response.json() as PolymarketProfile;
+    return { profile: data };
+  }
+
+  async search(query: string, params: {
+    limit?: number;
+    offset?: number;
+  } = {}): Promise<any> {
+    const searchLower = query.toLowerCase();
+    const limit = params.limit || 20;
+    const offset = params.offset || 0;
+
+    // Try API search first (may require auth)
+    try {
+      const searchParams = new URLSearchParams();
+      searchParams.set('query', query);
+      if (params.limit) searchParams.set('limit', params.limit.toString());
+      if (params.offset) searchParams.set('offset', params.offset.toString());
+
+      const response = await fetch(`${this.gammaApiBase}/search?${searchParams.toString()}`);
+
+      if (response.ok) {
+        return response.json();
+      }
+
+      this.debugLog(`Search endpoint returned ${response.status}, falling back to client-side`);
+    } catch (error) {
+      this.debugLog('Search endpoint error:', error);
+    }
+
+    // Client-side fallback
+    const fetchResult = await this.listMarkets({ limit: 500 });
+    const allMarkets = fetchResult.markets || [];
+
+    const filtered = allMarkets.filter((m: any) => {
+      const question = (m.question || '').toLowerCase();
+      const description = (m.description || '').toLowerCase();
+      const slug = (m.slug || '').toLowerCase();
+      const tags = ((m.tags || []) as string[]).join(' ').toLowerCase();
+
+      return (
+        question.includes(searchLower) ||
+        description.includes(searchLower) ||
+        slug.includes(searchLower) ||
+        tags.includes(searchLower)
+      );
+    });
+
+    const paginated = filtered.slice(offset, offset + limit);
+
+    return {
+      markets: paginated,
+      total: filtered.length,
+      query,
+      note: 'Results filtered client-side',
+    };
+  }
+
+  // ============================================================================
+  // CLOB API (Order Book & Trading)
+  // ============================================================================
+
+  async getOrderbook(tokenId: string): Promise<{ orderbook: PolymarketOrderBook }> {
+    const response = await fetch(`${this.clobApiBase}/orderbook?token_id=${tokenId}`);
+    if (!response.ok) {
+      throw new Error(`CLOB API error: ${response.status} ${response.statusText}`);
+    }
+
+    const data = await response.json() as PolymarketOrderBook;
+    return { orderbook: data };
+  }
+
+  async getTrades(tokenId: string, limit: number = 100): Promise<any> {
+    const response = await fetch(`${this.clobApiBase}/history?token_id=${tokenId}&limit=${limit}`);
+    if (!response.ok) {
+      throw new Error(`CLOB API error: ${response.status} ${response.statusText}`);
+    }
+
+    return response.json();
+  }
+
+  async getPrice(tokenId: string): Promise<{ price: number }> {
+    const response = await fetch(`${this.clobApiBase}/price?token_id=${tokenId}`);
+    if (!response.ok) {
+      throw new Error(`CLOB API error: ${response.status} ${response.statusText}`);
+    }
+
+    const data = await response.json() as { price: number };
+    return { price: data.price };
+  }
+
+  // ============================================================================
+  // DATA API (User Data)
+  // ============================================================================
+
+  async getPositions(walletAddress: string): Promise<any> {
+    const response = await fetch(`${this.dataApiBase}/positions?wallet=${walletAddress}`);
+    if (!response.ok) {
+      throw new Error(`Data API error: ${response.status} ${response.statusText}`);
+    }
+
+    return response.json();
+  }
+
+  async getWalletTrades(walletAddress: string, params: {
+    limit?: number;
+    offset?: number;
+  } = {}): Promise<any> {
+    const searchParams = new URLSearchParams();
+    searchParams.set('wallet', walletAddress);
+    if (params.limit) searchParams.set('limit', params.limit.toString());
+    if (params.offset) searchParams.set('offset', params.offset.toString());
+
+    const response = await fetch(`${this.dataApiBase}/trades?${searchParams.toString()}`);
+    if (!response.ok) {
+      throw new Error(`Data API error: ${response.status} ${response.statusText}`);
+    }
+
+    return response.json();
+  }
+}
+
+/**
+ * Create a new Polymarket client
+ */
+export function createPolymarketClient(config?: PolymarketClientConfig): PolymarketClient {
+  return new PolymarketClient(config);
+}

package/src/index.ts

@@ -0,0 +1,8 @@
+/**
+ * @codespaces/polymarket
+ *
+ * Polymarket prediction markets SDK wrapper and utilities.
+ */
+
+// Export client
+export * from './client.js';