@varla/polymarket 2.2.6 → 2.4.0

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # @varla/polymarket
 
+## 2.4.0
+
+### Minor Changes
+
+- fd7f6c8: Added configurable proactive rate limiting for GammaClient requests.
+
+  - add optional rateLimit settings to GammaClient to shape general and /markets request throughput
+  - introduce default Gamma API rate limit constants and apply sliding-window limiting before requests
+
+- 99ae9fd: Add optional concurrency control for resolving Gamma market chunks.
+
+  - Added `maxConcurrentRequests` option to `resolveBinaryMarketsByConditionId` to limit concurrent Gamma requests.
+
+## 2.3.0
+
+### Minor Changes
+
+- 70422c9: Added Polymarket event URL utilities and enriched resolved market data with event slug and URL fields.
+
+  - export polymarketEventUrl for constructing Polymarket event links,- include eventSlug and url on ResolvedBinaryMarket results using event slug when available
+
 ## 2.2.6
 
 ### Patch Changes

package/dist/gamma-client.d.ts

@@ -1,3 +1,4 @@
+import { SlidingWindowLimiter } from "./rate-limits.js";
 import type { GammaBuilderLeaderboardEntry, GammaBuilderVolumePoint, GammaComment, GammaEvent, GammaMarket, GammaPublicProfile, GammaSearchResult, GammaSeries, GammaSport, GammaSportsMarketType, GammaTag, GammaTagRelationship, GammaTeam } from "./types.js";
 export type GammaClientOpts = {
     /** Optional override for Gamma base URL. */
@@ -11,6 +12,13 @@ export type GammaClientOpts = {
         multiplier?: number;
         jitterFactor?: number;
     };
+    rateLimit?: {
+        enabled?: boolean;
+        windowMs?: number;
+        generalMaxPerWindow?: number;
+        marketsMaxPerWindow?: number;
+        now?: () => number;
+    };
     log?: (level: "debug" | "info" | "warn" | "error", msg: string, fields?: Record<string, unknown>) => void;
 };
 export declare class GammaClient {
@@ -19,8 +27,12 @@ export declare class GammaClient {
     readonly maxAttempts: number;
     readonly fetchFn: typeof fetch;
     readonly retry: Required<NonNullable<GammaClientOpts["retry"]>>;
+    readonly rateLimitEnabled: boolean;
+    readonly generalLimiter: SlidingWindowLimiter;
+    readonly marketsLimiter: SlidingWindowLimiter;
     readonly log?: GammaClientOpts["log"];
     constructor(opts?: GammaClientOpts);
+    private acquireRateLimitPermit;
     private isRetryable;
     private request;
     listMarkets(params: {

package/dist/gamma-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gamma-client.d.ts","sourceRoot":"","sources":["../src/gamma-client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"gamma-client.d.ts","sourceRoot":"","sources":["../src/gamma-client.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,oBAAoB,EACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EACV,4BAA4B,EAC5B,uBAAuB,EACvB,YAAY,EACZ,UAAU,EACV,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,WAAW,EACX,UAAU,EACV,qBAAqB,EACrB,QAAQ,EACR,oBAAoB,EACpB,SAAS,EACV,MAAM,YAAY,CAAC;AAmBpB,MAAM,MAAM,eAAe,GAAG;IAC5B,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB,KAAK,CAAC,EAAE;QACN,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,SAAS,CAAC,EAAE;QACV,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;KACpB,CAAC;IACF,GAAG,CAAC,EAAE,CACJ,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,EAC1C,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,IAAI,CAAC;CACX,CAAC;AAEF,qBAAa,WAAW;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,KAAK,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,WAAW,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAChE,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,cAAc,EAAE,oBAAoB,CAAC;IAC9C,QAAQ,CAAC,cAAc,EAAE,oBAAoB,CAAC;IAC9C,QAAQ,CAAC,GAAG,CAAC,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC;gBAE1B,IAAI,GAAE,eAAoB;YAgCxB,sBAAsB;IAcpC,OAAO,CAAC,WAAW;YASL,OAAO;IA0Bf,WAAW,CAAC,MAAM,EAAE;QACxB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAWpB,wBAAwB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAO9E;;;OAGG;IACG,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAKrD;;;OAGG;IACG,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IASzD;;;OAGG;IACG,UAAU,CACd,MAAM,GAAE;QACN,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,OAAO,CAAC;KAChB,GACL,OAAO,CAAC,UAAU,EAAE,CAAC;IAcxB;;;OAGG;IACG,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAKnD;;;OAGG;IACG,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IASvD;;;OAGG;IACG,QAAQ,CACZ,MAAM,GAAE;QACN,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACZ,GACL,OAAO,CAAC,QAAQ,EAAE,CAAC;IAQtB;;;OAGG;IACG,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAK/C;;;OAGG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAKnD;;;OAGG;IACG,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAKzD;;;OAGG;IACG,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAS7D;;;OAGG;IACG,SAAS,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAKxC;;;OAGG;IACG,SAAS,CACb,MAAM,GAAE;QACN,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACZ,GACL,OAAO,CAAC,SAAS,EAAE,CAAC;IAavB;;;OAGG;IACG,UAAU,CACd,MAAM,GAAE;QACN,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACZ,GACL,OAAO,CAAC,WAAW,EAAE,CAAC;IAQzB;;;OAGG;IACG,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IASrD;;;OAGG;IACG,MAAM,CACV,KAAK,EAAE,MAAM,EACb,MAAM,GAAE;QACN,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACZ,GACL,OAAO,CAAC,iBAAiB,CAAC;IAa7B;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAShD;;;OAGG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAKxD;;;OAGG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAK1D;;;OAGG;IACG,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAK1E;;;OAGG;IACG,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAK9E;;;OAGG;IACG,yBAAyB,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC;IASnE;;;OAGG;IACG,YAAY,CAChB,MAAM,GAAE;QACN,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACZ,GACL,OAAO,CAAC,YAAY,EAAE,CAAC;IAU1B;;;OAGG;IACG,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAKvD;;;OAGG;IACG,iBAAiB,CACrB,OAAO,EAAE,MAAM,EACf,MAAM,GAAE;QACN,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACZ,GACL,OAAO,CAAC,YAAY,EAAE,CAAC;IAY1B;;;OAGG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IASpE;;;OAGG;IACG,qBAAqB,CACzB,MAAM,GAAE;QACN,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;QAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACZ,GACL,OAAO,CAAC,4BAA4B,EAAE,CAAC;IAS1C;;;OAGG;IACG,gBAAgB,CACpB,MAAM,GAAE;QACN,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;KACb,GACL,OAAO,CAAC,uBAAuB,EAAE,CAAC;CAQtC;AAED,wBAAgB,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,EAAE,EAAE,CAK9D"}

package/dist/index.d.ts

@@ -19,5 +19,6 @@ export * from "./rate-limits.js";
 export { parseDecimalToBigint } from "./utils/decimal.js";
 export { twapFromHistory } from "./utils/twap.js";
 export { probToE8, collateralPriceFromMarkets } from "./utils/pricing.js";
+export { polymarketEventUrl } from "./utils/url.js";
 export * from "./bridge-client.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,mBAAmB,CAAC;AAMlC,cAAc,gBAAgB,CAAC;AAM/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAM9B,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AAMjC,cAAc,sBAAsB,CAAC;AAMrC,cAAc,UAAU,CAAC;AAMzB,cAAc,kBAAkB,CAAC;AAMjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAM1E,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,mBAAmB,CAAC;AAMlC,cAAc,gBAAgB,CAAC;AAM/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAM9B,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AAMjC,cAAc,sBAAsB,CAAC;AAMrC,cAAc,UAAU,CAAC;AAMzB,cAAc,kBAAkB,CAAC;AAMjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAMpD,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -825,6 +825,8 @@ var KEEPER_CLOB_DELETE_ORDER_MAX_PER_10S = 15;
 var KEEPER_CLOB_DELETE_ORDER_MAX_PER_10MIN = 150;
 var KEEPER_CLOB_CANCEL_ALL_MAX_PER_10S = 3;
 var KEEPER_CLOB_CANCEL_ALL_MAX_PER_10MIN = 30;
+var KEEPER_GAMMA_GENERAL_MAX_PER_10S = 800;
+var KEEPER_GAMMA_MARKETS_MAX_PER_10S = 120;
 
 class SlidingWindowLimiter {
   maxRequests;
@@ -1372,6 +1374,9 @@ class GammaClient {
   maxAttempts;
   fetchFn;
   retry;
+  rateLimitEnabled;
+  generalLimiter;
+  marketsLimiter;
   log;
   constructor(opts = {}) {
     this.baseUrl = opts.baseUrl ?? POLYMARKET_ENDPOINTS.gammaBaseUrl;
@@ -1384,8 +1389,26 @@ class GammaClient {
       multiplier: opts.retry?.multiplier ?? 2,
       jitterFactor: opts.retry?.jitterFactor ?? 0.3
     };
+    const rateLimitWindowMs = Math.max(100, opts.rateLimit?.windowMs ?? 1e4);
+    this.rateLimitEnabled = opts.rateLimit?.enabled ?? true;
+    this.generalLimiter = new SlidingWindowLimiter(Math.max(1, Math.floor(opts.rateLimit?.generalMaxPerWindow ?? KEEPER_GAMMA_GENERAL_MAX_PER_10S)), rateLimitWindowMs, opts.rateLimit?.now ?? Date.now);
+    this.marketsLimiter = new SlidingWindowLimiter(Math.max(1, Math.floor(opts.rateLimit?.marketsMaxPerWindow ?? KEEPER_GAMMA_MARKETS_MAX_PER_10S)), rateLimitWindowMs, opts.rateLimit?.now ?? Date.now);
     this.log = opts.log;
   }
+  async acquireRateLimitPermit(url) {
+    if (!this.rateLimitEnabled)
+      return;
+    await this.generalLimiter.acquire();
+    let pathname = "";
+    try {
+      pathname = new URL(url).pathname;
+    } catch {
+      return;
+    }
+    if (pathname.startsWith("/markets")) {
+      await this.marketsLimiter.acquire();
+    }
+  }
   isRetryable(err) {
     if (err instanceof SyntaxError)
       return true;
@@ -1393,7 +1416,10 @@ class GammaClient {
     return /timeout|ETIMEDOUT|ECONNRESET|fetch failed|network|socket|aborted|AbortError|429|500|502|503|504/i.test(msg);
   }
   async request(url) {
-    return withRetry(async () => fetchJson(url, { timeoutMs: this.timeoutMs, fetchFn: this.fetchFn }), {
+    return withRetry(async () => {
+      await this.acquireRateLimitPermit(url);
+      return fetchJson(url, { timeoutMs: this.timeoutMs, fetchFn: this.fetchFn });
+    }, {
       maxAttempts: this.maxAttempts,
       baseBackoffMs: this.retry.baseBackoffMs,
       maxBackoffMs: this.retry.maxBackoffMs,
@@ -1584,6 +1610,12 @@ function chunk(xs, size) {
     out.push(xs.slice(i, i + size));
   return out;
 }
+// src/utils/url.ts
+var POLYMARKET_BASE = "https://polymarket.com/event";
+function polymarketEventUrl(slug) {
+  return `${POLYMARKET_BASE}/${encodeURIComponent(slug)}`;
+}
+
 // src/resolver.ts
 function parseJsonStringArray(field, value) {
   const parsed = JSON.parse(value);
@@ -1606,10 +1638,13 @@ function resolveBinaryMarketFromGammaMarket(m) {
   if (yesIdx === -1 || noIdx === -1) {
     throw new Error(`Gamma market ${m.id} outcomes are not Yes/No: ${outcomes.join(",")}`);
   }
+  const eventSlug = m.events?.[0]?.slug;
   return {
     conditionId: m.conditionId,
     gammaMarketId: m.id,
     slug: m.slug,
+    eventSlug,
+    url: polymarketEventUrl(eventSlug ?? m.slug),
     yesTokenId: tokenIds[yesIdx] ?? (() => {
       throw new Error(`Missing YES tokenId for market ${m.id}`);
     })(),
@@ -1623,24 +1658,37 @@ function resolveBinaryMarketFromGammaMarket(m) {
 async function resolveBinaryMarketsByConditionId(conditionIds, opts = {}) {
   const gamma = opts.gamma ?? new GammaClient;
   const chunkSize = opts.chunkSize ?? 50;
+  const maxConcurrentRequests = Math.max(1, Math.floor(opts.maxConcurrentRequests ?? 3));
   const out = new Map;
-  for (const group of chunk(conditionIds, chunkSize)) {
-    let markets = [];
-    try {
-      markets = await gamma.getMarketsByConditionIds(group);
-    } catch (err) {
-      opts.log?.("warn", "Gamma getMarketsByConditionIds failed", {
-        chunkSize: group.length,
-        err: String(err)
-      });
-      continue;
-    }
-    for (const m of markets) {
+  const groups = chunk(conditionIds, chunkSize);
+  let nextGroupIdx = 0;
+  const workers = Array.from({ length: Math.min(maxConcurrentRequests, groups.length) }, async () => {
+    while (true) {
+      const idx = nextGroupIdx++;
+      const group = groups[idx];
+      if (!group)
+        return;
+      let markets = [];
       try {
-        const r = resolveBinaryMarketFromGammaMarket(m);
-        out.set(r.conditionId, r);
-      } catch {}
+        markets = await gamma.getMarketsByConditionIds(group);
+      } catch (err) {
+        opts.log?.("warn", "Gamma getMarketsByConditionIds failed", {
+          chunkSize: group.length,
+          chunkIndex: idx,
+          err: String(err)
+        });
+        continue;
+      }
+      for (const m of markets) {
+        try {
+          const r = resolveBinaryMarketFromGammaMarket(m);
+          out.set(r.conditionId, r);
+        } catch {}
+      }
     }
+  });
+  for (const worker of workers) {
+    await worker;
   }
   return out;
 }
@@ -3283,6 +3331,7 @@ export {
   resetClobClient,
   probToE8,
   priceValid,
+  polymarketEventUrl,
   parseRetryAfter,
   parseDecimalToBigint,
   isValidPrice,
@@ -3340,6 +3389,8 @@ export {
   POLYMARKET_GENERAL_LIMIT_PER_10S,
   POLYMARKET_ENDPOINTS,
   OrderValidationError,
+  KEEPER_GAMMA_MARKETS_MAX_PER_10S,
+  KEEPER_GAMMA_GENERAL_MAX_PER_10S,
   KEEPER_CLOB_READ_RPS,
   KEEPER_CLOB_READ_BURST,
   KEEPER_CLOB_POST_ORDER_MAX_PER_10S,

package/dist/rate-limits.d.ts

@@ -69,6 +69,10 @@ export declare const KEEPER_CLOB_DELETE_ORDER_MAX_PER_10MIN = 150;
 /** Internal budget: DELETE /cancel-all. */
 export declare const KEEPER_CLOB_CANCEL_ALL_MAX_PER_10S = 3;
 export declare const KEEPER_CLOB_CANCEL_ALL_MAX_PER_10MIN = 30;
+/** Internal budget: Gamma API general requests per 10s. */
+export declare const KEEPER_GAMMA_GENERAL_MAX_PER_10S = 800;
+/** Internal budget: Gamma /markets requests per 10s. */
+export declare const KEEPER_GAMMA_MARKETS_MAX_PER_10S = 120;
 /**
  * Lightweight sliding-window rate limiter.
  *

package/dist/rate-limits.d.ts.map

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

package/dist/resolver.d.ts

@@ -3,7 +3,17 @@ import type { GammaMarket } from "./types.js";
 export type ResolvedBinaryMarket = {
     conditionId: `0x${string}`;
     gammaMarketId: string;
+    /** Market-level slug from Gamma API. */
     slug: string;
+    /** Parent event slug (when the Gamma response includes nested events). */
+    eventSlug?: string;
+    /**
+     * Best-effort Polymarket UI link.
+     * Constructed as `https://polymarket.com/event/<eventSlug ?? slug>`.
+     * Uses the event slug when available (correct for Polymarket routing),
+     * falls back to the market slug otherwise.
+     */
+    url: string;
     yesTokenId: string;
     noTokenId: string;
     endDateIso?: string;
@@ -14,6 +24,8 @@ export type ConditionResolverOpts = {
     gamma?: GammaClient;
     /** How many conditionIds per Gamma request. */
     chunkSize?: number;
+    /** Max number of in-flight Gamma chunk requests. */
+    maxConcurrentRequests?: number;
     log?: (level: "debug" | "info" | "warn" | "error", msg: string, fields?: Record<string, unknown>) => void;
 };
 /**

package/dist/resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../src/resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAS,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,MAAM,oBAAoB,GAAG;IACjC,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAUF,wBAAgB,kCAAkC,CAAC,CAAC,EAAE,WAAW,GAAG,oBAAoB,CAkCvF;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,CACJ,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,EAC1C,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,IAAI,CAAC;CACX,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,iCAAiC,CACrD,YAAY,EAAE,KAAK,MAAM,EAAE,EAAE,EAC7B,IAAI,GAAE,qBAA0B,GAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,EAAE,EAAE,oBAAoB,CAAC,CAAC,CA4BnD"}
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../src/resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAS,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9C,MAAM,MAAM,oBAAoB,GAAG;IACjC,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAUF,wBAAgB,kCAAkC,CAAC,CAAC,EAAE,WAAW,GAAG,oBAAoB,CAsCvF;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,GAAG,CAAC,EAAE,CACJ,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,EAC1C,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,IAAI,CAAC;CACX,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,iCAAiC,CACrD,YAAY,EAAE,KAAK,MAAM,EAAE,EAAE,EAC7B,IAAI,GAAE,qBAA0B,GAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,EAAE,EAAE,oBAAoB,CAAC,CAAC,CA6CnD"}

package/dist/utils/url.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Construct a full Polymarket event URL from a Gamma slug.
+ *
+ * @example
+ * ```ts
+ * polymarketEventUrl("will-bitcoin-hit-1m-before-gta-vi")
+ * // => "https://polymarket.com/event/will-bitcoin-hit-1m-before-gta-vi"
+ * ```
+ */
+export declare function polymarketEventUrl(slug: string): string;
+//# sourceMappingURL=url.d.ts.map

package/dist/utils/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/utils/url.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@varla/polymarket",
-  "version": "2.2.6",
+  "version": "2.4.0",
   "description": "High-performance Polymarket SDK",
   "type": "module",
   "main": "./dist/index.js",