create-polymarket-strategy 0.1.0

package/templates/worker/src/strategies/{{strategy-name}}.ts

@@ -0,0 +1,119 @@
+/**
+ * {{StrategyName}} Strategy
+ *
+ * A trading strategy for Polymarket.
+ * Implement the scan() and calculatePrice() methods to define your trading logic.
+ */
+
+import type { Env } from "../types.js";
+import {
+  type Strategy,
+  type StrategyContext,
+  type Signal,
+  type MarketData,
+  type StrategyConfig,
+  registerStrategy,
+} from "polymarket-trading-sdk";
+
+/**
+ * Strategy configuration type.
+ * Add your custom config fields here.
+ */
+interface {{StrategyName}}Config extends StrategyConfig {
+  tokenIds: string[];
+  orderSize: number;
+  // Add your config fields here
+}
+
+/**
+ * {{StrategyName}} Strategy Implementation
+ */
+export const {{strategyName}}Strategy: Strategy<Env> = {
+  name: "{{strategy-name}}",
+
+  /**
+   * Scan for trading opportunities.
+   *
+   * This method is called periodically by the scheduler.
+   * Return an array of signals for markets you want to trade.
+   */
+  async scan(ctx: StrategyContext<Env>): Promise<Signal[]> {
+    const config = ctx.config as {{StrategyName}}Config;
+    const signals: Signal[] = [];
+
+    for (const tokenId of config.tokenIds) {
+      // Get market data
+      const data = await ctx.marketData.getMarketData(tokenId);
+
+      // Example: Generate a signal if conditions are met
+      // TODO: Implement your trading logic here
+      if (data.midpoint && data.spread) {
+        // Example condition - customize this
+        const shouldTrade = false; // Your logic here
+
+        if (shouldTrade) {
+          signals.push({
+            slug: "your-market-slug",
+            label: "YES",
+            tokenId,
+            side: "buy",
+            metadata: {
+              midpoint: data.midpoint,
+              spread: data.spread,
+            },
+          });
+        }
+      }
+    }
+
+    return signals;
+  },
+
+  /**
+   * Calculate the limit price for a signal.
+   *
+   * Return a price (0-1) to place an order at that price.
+   * Return null to skip this signal.
+   */
+  calculatePrice(
+    signal: Signal,
+    data: MarketData,
+    config: StrategyConfig
+  ): number | null {
+    // Example: Bid slightly below the midpoint
+    if (!data.midpoint || !data.bid) {
+      return null;
+    }
+
+    // TODO: Implement your pricing logic here
+    // Example: bid 1 cent below midpoint
+    const price = Math.max(0.01, data.midpoint - 0.01);
+
+    // Ensure price is between 0.01 and 0.99
+    return Math.min(0.99, Math.max(0.01, price));
+  },
+
+  /**
+   * Get strategy configuration.
+   *
+   * Configure your strategy here. You can read from env vars
+   * or hardcode values.
+   */
+  getConfig(env: Env): {{StrategyName}}Config {
+    return {
+      // Token IDs to monitor
+      // Find these using the Gamma API or Polymarket UI
+      tokenIds: [
+        // "your-token-id-here",
+      ],
+
+      // Order size in USDC
+      orderSize: 5,
+
+      // Add your custom config here
+    };
+  },
+};
+
+// Register the strategy
+registerStrategy({{strategyName}}Strategy);

package/templates/worker/src/types.ts

@@ -0,0 +1,29 @@
+/**
+ * Worker environment types.
+ *
+ * This file contains Cloudflare-specific types that extend the SDK types.
+ */
+
+/**
+ * Environment bindings for the worker.
+ */
+export interface Env {
+  // Durable Objects
+  ORDERS: DurableObjectNamespace;
+  POSITIONS: DurableObjectNamespace;
+  SCHEDULER: DurableObjectNamespace;
+
+  // Config
+  STRATEGY_NAME: string;
+  MODE: "paper" | "live";
+  CLOB_API: string;
+  GAMMA_API: string;
+
+  // Order Executor Lambda (Seoul) - bypasses geo-blocking
+  EXECUTOR_URL?: string;
+  EXECUTOR_WALLET_ID?: string;
+
+  // Secrets (set via wrangler secret put)
+  WORKER_API_KEY?: string; // API key to access this worker (security)
+  EXECUTOR_API_KEY?: string; // API key for executor Lambda
+}

package/templates/worker/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "lib": ["ES2022"],
+    "types": ["@cloudflare/workers-types"]
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules"]
+}

package/templates/worker/wrangler.jsonc

@@ -0,0 +1,42 @@
+{
+  "$schema": "https://raw.githubusercontent.com/cloudflare/workers-sdk/main/packages/wrangler/schemas/config.schema.json",
+  "name": "{{name}}",
+  "main": "src/index.ts",
+  "compatibility_date": "2024-01-01",
+  "compatibility_flags": ["nodejs_compat"],
+
+  // Durable Objects (all SQL-backed)
+  "durable_objects": {
+    "bindings": [
+      { "name": "ORDERS", "class_name": "OrdersDO" },
+      { "name": "POSITIONS", "class_name": "PositionsDO" },
+      { "name": "SCHEDULER", "class_name": "SchedulerDO" }
+    ]
+  },
+
+  // Migrations for SQL schema
+  "migrations": [
+    { "tag": "v1", "new_sqlite_classes": ["OrdersDO", "PositionsDO", "SchedulerDO"] }
+  ],
+
+  // Environment variables (non-secret)
+  "vars": {
+    "STRATEGY_NAME": "{{strategy-name}}",
+    "MODE": "paper",
+    "CLOB_API": "https://clob.polymarket.com",
+    "GAMMA_API": "https://gamma-api.polymarket.com",
+
+    // Order Executor Lambda (Seoul) - bypasses geo-blocking for order placement
+    // Set these when deploying in live mode
+    "EXECUTOR_URL": "",
+    "EXECUTOR_WALLET_ID": ""
+  }
+
+  // Secrets (set via `wrangler secret put`):
+  //
+  // SECURITY (required for production):
+  // - WORKER_API_KEY: API key to access this worker - generate with `openssl rand -hex 32`
+  //
+  // LIVE TRADING:
+  // - EXECUTOR_API_KEY: API key for executor Lambda (exk_...) - REQUIRED for live mode
+}