@agg-build/sdk 1.0.1 → 1.2.11

package/dist/index.js

@@ -76,12 +76,14 @@ __export(index_exports, {
   Venue: () => Venue,
   aggregateMidpoint: () => aggregateMidpoint,
   applyOrderbookDelta: () => applyOrderbookDelta,
+  buildVenueUrl: () => buildVenueUrl,
   computeBestSplitsByAmount: () => computeBestSplitsByAmount2,
   computeChecksum: () => computeChecksum,
   createAggClient: () => createAggClient,
   enumGuard: () => enumGuard,
   formatMarketQuestion: () => formatMarketQuestion,
   formatOutcomeLabel: () => formatOutcomeLabel,
+  formatOutcomeTitle: () => formatOutcomeTitle,
   getWalletAddressFromUserProfile: () => getWalletAddressFromUserProfile,
   hasShape: () => hasShape,
   isEmail: () => isEmail,
@@ -214,6 +216,29 @@ function formatMarketQuestion(venue, market) {
   }
   return market.question.trim();
 }
+function formatOutcomeTitle(_venue, outcome, market) {
+  var _a, _b;
+  const outcomes = (_a = market.venueMarketOutcomes) != null ? _a : [];
+  if (outcomes.length >= 2) {
+    const normalized = outcomes.map((o) => {
+      var _a2, _b2;
+      return (_b2 = (_a2 = o.title) == null ? void 0 : _a2.trim()) != null ? _b2 : "";
+    });
+    const hasAnyTitle = normalized.some((t) => t.length > 0);
+    if (hasAnyTitle && normalized.every((t) => t === normalized[0])) return null;
+  }
+  const title = (_b = outcome.title) == null ? void 0 : _b.trim();
+  if (title) return title;
+  return deriveOverUnderTitle(outcome.label, market.question);
+}
+var OVER_UNDER_QUESTION = /\bO\/U\s+\d/i;
+function deriveOverUnderTitle(label, question) {
+  if (!question || !OVER_UNDER_QUESTION.test(question)) return null;
+  const normalized = label.trim().toLowerCase();
+  if (normalized === "yes") return "Over";
+  if (normalized === "no") return "Under";
+  return null;
+}
 
 // ../common/src/utils/auth.ts
 function getWalletAddressFromUserProfile(user) {
@@ -560,6 +585,51 @@ var getVenueOrder = (venue) => {
 };
 var sortVenues = (venues) => [...venues].sort((a, b) => getVenueOrder(a) - getVenueOrder(b));
 
+// ../common/src/utils/venue-url.ts
+function buildVenueUrl(venue, opts) {
+  switch (venue) {
+    case "kalshi": {
+      const series = opts.seriesExternalId;
+      const event = opts.eventExternalId;
+      if (series && event) {
+        return `https://kalshi.com/markets/${series.toLowerCase()}/${event.toLowerCase()}`;
+      }
+      return null;
+    }
+    case "polymarket": {
+      if (opts.eventSlug) return `https://polymarket.com/event/${opts.eventSlug}`;
+      if (opts.conditionId) return `https://polymarket.com/market/${opts.conditionId}`;
+      return null;
+    }
+    case "predict": {
+      if (opts.eventSlug) return `https://predict.fun/market/${opts.eventSlug}`;
+      return null;
+    }
+    case "limitless": {
+      if (opts.eventSlug) return `https://limitless.exchange/markets/${opts.eventSlug}`;
+      return null;
+    }
+    case "opinion": {
+      if (opts.eventSlug) return `https://www.opinion.trade/market/${opts.eventSlug}`;
+      return null;
+    }
+    case "myriad": {
+      if (opts.eventSlug) return `https://myriad.markets/markets/${opts.eventSlug}`;
+      return null;
+    }
+    case "hyperliquid": {
+      if (opts.eventSlug) return `https://app.hyperliquid.xyz/trade/${opts.eventSlug}`;
+      return null;
+    }
+    case "probable": {
+      if (opts.eventSlug) return `https://probable.markets/event/${opts.eventSlug}`;
+      return null;
+    }
+    default:
+      return null;
+  }
+}
+
 // src/orderbook-utils.ts
 var PRICE_KEY_SCALE = 1e9;
 function crc32(str) {
@@ -1592,6 +1662,7 @@ var AggClient = class {
       let message = response.status === 404 ? "Market not found" : `AGG API error: ${response.status} ${response.statusText}`;
       let code;
       let retryable;
+      let errors;
       try {
         const body = yield response.json();
         if (typeof body.message === "string" && body.message.length > 0) {
@@ -1603,12 +1674,20 @@ var AggClient = class {
         if (typeof body.retryable === "boolean") {
           retryable = body.retryable;
         }
+        if (Array.isArray(body.errors)) {
+          const parsed = body.errors.map((e) => ({
+            field: typeof (e == null ? void 0 : e.field) === "string" ? e.field : "",
+            message: typeof (e == null ? void 0 : e.message) === "string" ? e.message : ""
+          })).filter((e) => e.message.length > 0);
+          if (parsed.length > 0) errors = parsed;
+        }
       } catch (e) {
       }
       const error = new Error(message);
       error.status = response.status;
       if (code) error.code = code;
       if (retryable !== void 0) error.retryable = retryable;
+      if (errors) error.errors = errors;
       throw error;
     });
   }
@@ -1999,11 +2078,18 @@ Issued At: ${issuedAt}`;
       });
     });
   }
-  /** List execution orders for the authenticated user (cursor pagination). */
+  /**
+   * List execution orders for the authenticated user (cursor pagination).
+   *
+   * Pass `quoteId` to fetch every leg of a multi-venue split route in
+   * one call — `useQuoteSummary(quoteId)` reduces the list into a
+   * rollup (total cost, share-weighted avg price, to-win).
+   */
   getExecutionOrders() {
     return __async(this, arguments, function* (params = {}) {
       const query = {};
       if (params.orderId) query.orderId = params.orderId;
+      if (params.quoteId) query.quoteId = params.quoteId;
       if (params.status) query.status = params.status;
       if (params.cursor) query.cursor = params.cursor;
       if (params.limit != null) query.limit = String(params.limit);
@@ -2126,7 +2212,14 @@ Issued At: ${issuedAt}`;
       return this.request("/app/config", init);
     });
   }
-  /** Search events or markets by query string. Supports cursor-based pagination. */
+  /**
+   * Search events or markets by query string. Supports cursor-based pagination.
+   *
+   * Pass `deep: true` on submit (Enter / Search button) to opt in to the
+   * server-side reranker. Leave it off for debounced typeahead — the wire
+   * format intentionally omits the param so the server hits the cheaper
+   * (and longer-TTL) light cache slot.
+   */
   search(params) {
     return __async(this, null, function* () {
       const query = {
@@ -2136,11 +2229,66 @@ Issued At: ${issuedAt}`;
       if (params.categoryIds && params.categoryIds.length > 0) query.categoryIds = params.categoryIds;
       if (params.limit != null) query.limit = String(params.limit);
       if (params.cursor) query.cursor = params.cursor;
+      if (params.deep) query.deepSearch = "true";
       return this.request("/search", {
         query
       });
     });
   }
+  /** Get Correlated Markets processing and embedding coverage. */
+  getCorrelatedMarketsStatus(options) {
+    return __async(this, null, function* () {
+      return this.request("/correlated-markets/status", {
+        signal: options == null ? void 0 : options.signal
+      });
+    });
+  }
+  /** Get the generated correlated market signals for a market. */
+  getMarketCorrelatedSignals(venueMarketId, options) {
+    return __async(this, null, function* () {
+      const query = {};
+      if ((options == null ? void 0 : options.includeResolved) != null) query.includeResolved = String(options.includeResolved);
+      return this.request(
+        `/correlated-markets/${encodeURIComponent(venueMarketId)}`,
+        { query, signal: options == null ? void 0 : options.signal }
+      );
+    });
+  }
+  /** Search markets by Correlated Markets signal similarity. */
+  queryCorrelatedMarkets(params, options) {
+    return __async(this, null, function* () {
+      return this.request("/correlated-markets/query", {
+        method: "POST",
+        body: JSON.stringify(params),
+        signal: options == null ? void 0 : options.signal
+      });
+    });
+  }
+  /** Get expansion and hedge candidates for an already-processed market. */
+  getCorrelatedMarketCascade(params, options) {
+    return __async(this, null, function* () {
+      const query = {};
+      if (params.side) query.side = params.side;
+      if (params.mode) query.mode = params.mode;
+      if (params.limit != null) query.limit = String(params.limit);
+      if (params.cursor) query.cursor = params.cursor;
+      if (params.includeResolved != null) query.includeResolved = String(params.includeResolved);
+      return this.request(
+        `/correlated-markets/cascade/${encodeURIComponent(params.venueMarketId)}`,
+        { query, signal: options == null ? void 0 : options.signal }
+      );
+    });
+  }
+  /** Resolve a market by ID, venue identifier, slug, conditionId, or text, then return candidates. */
+  resolveCorrelatedMarkets(params, options) {
+    return __async(this, null, function* () {
+      return this.request("/correlated-markets/resolve", {
+        method: "POST",
+        body: JSON.stringify(params),
+        signal: options == null ? void 0 : options.signal
+      });
+    });
+  }
   // --- Chart data ---
   /** Get the canonical TradingView-style bar series for a single venue market outcome. */
   getChartBars(params, options) {
@@ -2176,7 +2324,9 @@ Issued At: ${issuedAt}`;
   getMidpoints(paramsOrVenueMarketIds, options) {
     return __async(this, null, function* () {
       const venueMarketIds = Array.isArray(paramsOrVenueMarketIds) ? paramsOrVenueMarketIds : paramsOrVenueMarketIds.venueMarketIds;
+      const bestPrice = !Array.isArray(paramsOrVenueMarketIds) ? paramsOrVenueMarketIds.bestPrice : options == null ? void 0 : options.bestPrice;
       const query = { venueMarketIds };
+      if (bestPrice) query.bestPrice = "true";
       return this.request("/midpoints", {
         query,
         signal: options == null ? void 0 : options.signal
@@ -2220,6 +2370,7 @@ Issued At: ${issuedAt}`;
       if (params.slipCapBps != null) query.slipCapBps = String(params.slipCapBps);
       if (params.compareVenues) query.compareVenues = "true";
       if (params.tradeSide) query.side = params.tradeSide;
+      if (params.deepEstimate) query.deepEstimate = "true";
       const response = yield this.request(
         `/orderbook/${encodeURIComponent(venueMarketOutcomeId)}/route`,
         { query, signal: options == null ? void 0 : options.signal }
@@ -2576,12 +2727,14 @@ function createAggClient(options) {
   Venue,
   aggregateMidpoint,
   applyOrderbookDelta,
+  buildVenueUrl,
   computeBestSplitsByAmount,
   computeChecksum,
   createAggClient,
   enumGuard,
   formatMarketQuestion,
   formatOutcomeLabel,
+  formatOutcomeTitle,
   getWalletAddressFromUserProfile,
   hasShape,
   isEmail,

package/dist/index.mjs

@@ -117,6 +117,29 @@ function formatMarketQuestion(venue, market) {
   }
   return market.question.trim();
 }
+function formatOutcomeTitle(_venue, outcome, market) {
+  var _a, _b;
+  const outcomes = (_a = market.venueMarketOutcomes) != null ? _a : [];
+  if (outcomes.length >= 2) {
+    const normalized = outcomes.map((o) => {
+      var _a2, _b2;
+      return (_b2 = (_a2 = o.title) == null ? void 0 : _a2.trim()) != null ? _b2 : "";
+    });
+    const hasAnyTitle = normalized.some((t) => t.length > 0);
+    if (hasAnyTitle && normalized.every((t) => t === normalized[0])) return null;
+  }
+  const title = (_b = outcome.title) == null ? void 0 : _b.trim();
+  if (title) return title;
+  return deriveOverUnderTitle(outcome.label, market.question);
+}
+var OVER_UNDER_QUESTION = /\bO\/U\s+\d/i;
+function deriveOverUnderTitle(label, question) {
+  if (!question || !OVER_UNDER_QUESTION.test(question)) return null;
+  const normalized = label.trim().toLowerCase();
+  if (normalized === "yes") return "Over";
+  if (normalized === "no") return "Under";
+  return null;
+}
 
 // ../common/src/utils/auth.ts
 function getWalletAddressFromUserProfile(user) {
@@ -463,6 +486,51 @@ var getVenueOrder = (venue) => {
 };
 var sortVenues = (venues) => [...venues].sort((a, b) => getVenueOrder(a) - getVenueOrder(b));
 
+// ../common/src/utils/venue-url.ts
+function buildVenueUrl(venue, opts) {
+  switch (venue) {
+    case "kalshi": {
+      const series = opts.seriesExternalId;
+      const event = opts.eventExternalId;
+      if (series && event) {
+        return `https://kalshi.com/markets/${series.toLowerCase()}/${event.toLowerCase()}`;
+      }
+      return null;
+    }
+    case "polymarket": {
+      if (opts.eventSlug) return `https://polymarket.com/event/${opts.eventSlug}`;
+      if (opts.conditionId) return `https://polymarket.com/market/${opts.conditionId}`;
+      return null;
+    }
+    case "predict": {
+      if (opts.eventSlug) return `https://predict.fun/market/${opts.eventSlug}`;
+      return null;
+    }
+    case "limitless": {
+      if (opts.eventSlug) return `https://limitless.exchange/markets/${opts.eventSlug}`;
+      return null;
+    }
+    case "opinion": {
+      if (opts.eventSlug) return `https://www.opinion.trade/market/${opts.eventSlug}`;
+      return null;
+    }
+    case "myriad": {
+      if (opts.eventSlug) return `https://myriad.markets/markets/${opts.eventSlug}`;
+      return null;
+    }
+    case "hyperliquid": {
+      if (opts.eventSlug) return `https://app.hyperliquid.xyz/trade/${opts.eventSlug}`;
+      return null;
+    }
+    case "probable": {
+      if (opts.eventSlug) return `https://probable.markets/event/${opts.eventSlug}`;
+      return null;
+    }
+    default:
+      return null;
+  }
+}
+
 // src/orderbook-utils.ts
 var PRICE_KEY_SCALE = 1e9;
 function crc32(str) {
@@ -1495,6 +1563,7 @@ var AggClient = class {
       let message = response.status === 404 ? "Market not found" : `AGG API error: ${response.status} ${response.statusText}`;
       let code;
       let retryable;
+      let errors;
       try {
         const body = yield response.json();
         if (typeof body.message === "string" && body.message.length > 0) {
@@ -1506,12 +1575,20 @@ var AggClient = class {
         if (typeof body.retryable === "boolean") {
           retryable = body.retryable;
         }
+        if (Array.isArray(body.errors)) {
+          const parsed = body.errors.map((e) => ({
+            field: typeof (e == null ? void 0 : e.field) === "string" ? e.field : "",
+            message: typeof (e == null ? void 0 : e.message) === "string" ? e.message : ""
+          })).filter((e) => e.message.length > 0);
+          if (parsed.length > 0) errors = parsed;
+        }
       } catch (e) {
       }
       const error = new Error(message);
       error.status = response.status;
       if (code) error.code = code;
       if (retryable !== void 0) error.retryable = retryable;
+      if (errors) error.errors = errors;
       throw error;
     });
   }
@@ -1902,11 +1979,18 @@ Issued At: ${issuedAt}`;
       });
     });
   }
-  /** List execution orders for the authenticated user (cursor pagination). */
+  /**
+   * List execution orders for the authenticated user (cursor pagination).
+   *
+   * Pass `quoteId` to fetch every leg of a multi-venue split route in
+   * one call — `useQuoteSummary(quoteId)` reduces the list into a
+   * rollup (total cost, share-weighted avg price, to-win).
+   */
   getExecutionOrders() {
     return __async(this, arguments, function* (params = {}) {
       const query = {};
       if (params.orderId) query.orderId = params.orderId;
+      if (params.quoteId) query.quoteId = params.quoteId;
       if (params.status) query.status = params.status;
       if (params.cursor) query.cursor = params.cursor;
       if (params.limit != null) query.limit = String(params.limit);
@@ -2029,7 +2113,14 @@ Issued At: ${issuedAt}`;
       return this.request("/app/config", init);
     });
   }
-  /** Search events or markets by query string. Supports cursor-based pagination. */
+  /**
+   * Search events or markets by query string. Supports cursor-based pagination.
+   *
+   * Pass `deep: true` on submit (Enter / Search button) to opt in to the
+   * server-side reranker. Leave it off for debounced typeahead — the wire
+   * format intentionally omits the param so the server hits the cheaper
+   * (and longer-TTL) light cache slot.
+   */
   search(params) {
     return __async(this, null, function* () {
       const query = {
@@ -2039,11 +2130,66 @@ Issued At: ${issuedAt}`;
       if (params.categoryIds && params.categoryIds.length > 0) query.categoryIds = params.categoryIds;
       if (params.limit != null) query.limit = String(params.limit);
       if (params.cursor) query.cursor = params.cursor;
+      if (params.deep) query.deepSearch = "true";
       return this.request("/search", {
         query
       });
     });
   }
+  /** Get Correlated Markets processing and embedding coverage. */
+  getCorrelatedMarketsStatus(options) {
+    return __async(this, null, function* () {
+      return this.request("/correlated-markets/status", {
+        signal: options == null ? void 0 : options.signal
+      });
+    });
+  }
+  /** Get the generated correlated market signals for a market. */
+  getMarketCorrelatedSignals(venueMarketId, options) {
+    return __async(this, null, function* () {
+      const query = {};
+      if ((options == null ? void 0 : options.includeResolved) != null) query.includeResolved = String(options.includeResolved);
+      return this.request(
+        `/correlated-markets/${encodeURIComponent(venueMarketId)}`,
+        { query, signal: options == null ? void 0 : options.signal }
+      );
+    });
+  }
+  /** Search markets by Correlated Markets signal similarity. */
+  queryCorrelatedMarkets(params, options) {
+    return __async(this, null, function* () {
+      return this.request("/correlated-markets/query", {
+        method: "POST",
+        body: JSON.stringify(params),
+        signal: options == null ? void 0 : options.signal
+      });
+    });
+  }
+  /** Get expansion and hedge candidates for an already-processed market. */
+  getCorrelatedMarketCascade(params, options) {
+    return __async(this, null, function* () {
+      const query = {};
+      if (params.side) query.side = params.side;
+      if (params.mode) query.mode = params.mode;
+      if (params.limit != null) query.limit = String(params.limit);
+      if (params.cursor) query.cursor = params.cursor;
+      if (params.includeResolved != null) query.includeResolved = String(params.includeResolved);
+      return this.request(
+        `/correlated-markets/cascade/${encodeURIComponent(params.venueMarketId)}`,
+        { query, signal: options == null ? void 0 : options.signal }
+      );
+    });
+  }
+  /** Resolve a market by ID, venue identifier, slug, conditionId, or text, then return candidates. */
+  resolveCorrelatedMarkets(params, options) {
+    return __async(this, null, function* () {
+      return this.request("/correlated-markets/resolve", {
+        method: "POST",
+        body: JSON.stringify(params),
+        signal: options == null ? void 0 : options.signal
+      });
+    });
+  }
   // --- Chart data ---
   /** Get the canonical TradingView-style bar series for a single venue market outcome. */
   getChartBars(params, options) {
@@ -2079,7 +2225,9 @@ Issued At: ${issuedAt}`;
   getMidpoints(paramsOrVenueMarketIds, options) {
     return __async(this, null, function* () {
       const venueMarketIds = Array.isArray(paramsOrVenueMarketIds) ? paramsOrVenueMarketIds : paramsOrVenueMarketIds.venueMarketIds;
+      const bestPrice = !Array.isArray(paramsOrVenueMarketIds) ? paramsOrVenueMarketIds.bestPrice : options == null ? void 0 : options.bestPrice;
       const query = { venueMarketIds };
+      if (bestPrice) query.bestPrice = "true";
       return this.request("/midpoints", {
         query,
         signal: options == null ? void 0 : options.signal
@@ -2123,6 +2271,7 @@ Issued At: ${issuedAt}`;
       if (params.slipCapBps != null) query.slipCapBps = String(params.slipCapBps);
       if (params.compareVenues) query.compareVenues = "true";
       if (params.tradeSide) query.side = params.tradeSide;
+      if (params.deepEstimate) query.deepEstimate = "true";
       const response = yield this.request(
         `/orderbook/${encodeURIComponent(venueMarketOutcomeId)}/route`,
         { query, signal: options == null ? void 0 : options.signal }
@@ -2478,12 +2627,14 @@ export {
   Venue,
   aggregateMidpoint,
   applyOrderbookDelta,
+  buildVenueUrl,
   computeBestSplitsByAmount2 as computeBestSplitsByAmount,
   computeChecksum,
   createAggClient,
   enumGuard,
   formatMarketQuestion,
   formatOutcomeLabel,
+  formatOutcomeTitle,
   getWalletAddressFromUserProfile,
   hasShape,
   isEmail,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agg-build/sdk",
-  "version": "1.0.1",
+  "version": "1.2.11",
   "description": "Vanilla TypeScript client for the AGG prediction market aggregator (auth, markets, orderbooks, charts, trading, managed execution, WebSockets). Works in browsers, Node.js, and React Native.",
   "sideEffects": false,
   "license": "MIT",