@agg-build/sdk 2.2.0 → 2.2.1

package/dist/index.d.mts

@@ -871,6 +871,7 @@ type MidpointItem = {
     timestamp: number | null;
     outcomes: OutcomeMidpoint[];
     matched: MatchedMidpoint[];
+    arbReturn?: number | null | undefined;
 };
 type ComputeSplitsRequest = {
     side: TradeSide$1;
@@ -1328,13 +1329,21 @@ interface WsTrade {
 type WsCandleInterval = "1m" | "5m" | "1h" | "1d";
 interface WsSubscribed {
     type: "subscribed";
+    /** Confirmed ids. For `orderbook`/`trades` these are venueMarketOutcomeIds.
+     *  For `arb` this historically mirrors the marketIds — prefer `marketIds`. */
     outcomeIds: string[];
-    channel: "orderbook" | "trades";
+    /** Confirmed marketIds — only set on `arb` confirmations, whose
+     *  subscriptions are keyed by marketIds, not outcomeIds. */
+    marketIds?: string[];
+    channel: "orderbook" | "trades" | "arb" | "arb-feed";
 }
 interface WsUnsubscribed {
     type: "unsubscribed";
+    /** See {@link WsSubscribed.outcomeIds}. */
     outcomeIds: string[];
-    channel: "orderbook" | "trades";
+    /** Confirmed marketIds — only set on `arb` confirmations. */
+    marketIds?: string[];
+    channel: "orderbook" | "trades" | "arb" | "arb-feed";
 }
 interface WsConnected {
     type: "connected";
@@ -1622,8 +1631,10 @@ declare function applyOrderbookDelta(state: OrderbookState, delta: WsOrderbookDe
 /**
  * Agg platform WebSocket client.
  *
- * Single connection, refcounted subscriptions by ID (venueMarketId or
- * venueMarketOutcomeId). Maintains in-memory orderbook state per subscribed ID.
+ * Single connection, refcounted subscriptions. Orderbook/trades subscriptions
+ * are keyed by venueMarketOutcomeId (the `outcomes[].id` on REST market
+ * responses — NOT a venueMarketId); arb subscriptions are keyed by marketId.
+ * Maintains in-memory orderbook state per subscribed outcome id.
  * All timestamps converted from server ms to seconds before invoking callbacks.
  *
  * Recovery: seq gap or checksum mismatch → resnapshot request.
@@ -1632,8 +1643,10 @@ declare function applyOrderbookDelta(state: OrderbookState, delta: WsOrderbookDe
  */
 
 interface AggWebSocketCallbacks {
-    onSnapshot?: (marketId: string, book: OrderbookState) => void;
-    onDelta?: (marketId: string, book: OrderbookState) => void;
+    /** Invoked with the venueMarketOutcomeId the snapshot belongs to. */
+    onSnapshot?: (outcomeId: string, book: OrderbookState) => void;
+    /** Invoked with the venueMarketOutcomeId the delta belongs to. */
+    onDelta?: (outcomeId: string, book: OrderbookState) => void;
     onTrade?: (trade: WsTrade) => void;
     onHeartbeat?: (hb: WsHeartbeat) => void;
     onSubscribed?: (msg: WsSubscribed) => void;
@@ -2302,6 +2315,7 @@ interface MidpointRow {
     midpoint: number | null;
     spread: number | null;
     timestamp: number | null;
+    arbReturn?: number | null;
     /** Provenance of `midpoint`. */
     markSource?: MarkSource;
     /**
@@ -2310,6 +2324,10 @@ interface MidpointRow {
      * without re-running the matching logic.
      */
     siblingVenueMarketId?: string;
+    /** Top-of-book buy-side price. Only present when `bestPrice=true`. */
+    bestBid?: number | null;
+    /** Top-of-book sell-side price. Only present when `bestPrice=true`. */
+    bestAsk?: number | null;
 }
 /** Per-outcome midpoint from a live orderbook. */
 interface OutcomeMidpointRow {
@@ -2318,12 +2336,39 @@ interface OutcomeMidpointRow {
     midpoint: number | null;
     /** Provenance of `midpoint`. */
     markSource?: MarkSource;
+    /** Top-of-book buy-side price. Only present when `bestPrice=true`. */
+    bestBid?: number | null;
+    /** Top-of-book sell-side price. Only present when `bestPrice=true`. */
+    bestAsk?: number | null;
 }
 /** Response from GET /midpoints (batch). */
 interface BatchMidpointsResponse {
     data: Array<MidpointRow & {
         outcomes: OutcomeMidpointRow[];
         matched: MidpointRow[];
+        /**
+         * Live, quality-gated cross-venue arbitrage return for this market's
+         * cluster as a decimal fraction (`0.0085` = 0.85%), computed fresh by
+         * the engine on this request. Prefer it over the `arbReturn` embedded
+         * in venue-event listings, which a background sync can leave stale.
+         * Only present when the request set `bestPrice=true`.
+         */
+        arbReturn?: number | null;
+        /**
+         * DB status of the requested market. Present whenever the id resolves
+         * to a known market. Resolved markets never serve a price (see `error`).
+         */
+        marketStatus?: MarketStatus;
+        /**
+         * Structured refusal, mirroring GET /orderbooks per-item errors:
+         * `market_resolved` for settled markets (prices are nulled instead of
+         * serving a stale mark), `market_not_found` for unknown ids.
+         */
+        error?: {
+            code: "market_resolved" | "market_not_found";
+            message: string;
+            retryable: boolean;
+        };
     }>;
 }
 /** Response from GET /orderbook/outcome/:id (single outcome). */

package/dist/index.d.ts

@@ -871,6 +871,7 @@ type MidpointItem = {
     timestamp: number | null;
     outcomes: OutcomeMidpoint[];
     matched: MatchedMidpoint[];
+    arbReturn?: number | null | undefined;
 };
 type ComputeSplitsRequest = {
     side: TradeSide$1;
@@ -1328,13 +1329,21 @@ interface WsTrade {
 type WsCandleInterval = "1m" | "5m" | "1h" | "1d";
 interface WsSubscribed {
     type: "subscribed";
+    /** Confirmed ids. For `orderbook`/`trades` these are venueMarketOutcomeIds.
+     *  For `arb` this historically mirrors the marketIds — prefer `marketIds`. */
     outcomeIds: string[];
-    channel: "orderbook" | "trades";
+    /** Confirmed marketIds — only set on `arb` confirmations, whose
+     *  subscriptions are keyed by marketIds, not outcomeIds. */
+    marketIds?: string[];
+    channel: "orderbook" | "trades" | "arb" | "arb-feed";
 }
 interface WsUnsubscribed {
     type: "unsubscribed";
+    /** See {@link WsSubscribed.outcomeIds}. */
     outcomeIds: string[];
-    channel: "orderbook" | "trades";
+    /** Confirmed marketIds — only set on `arb` confirmations. */
+    marketIds?: string[];
+    channel: "orderbook" | "trades" | "arb" | "arb-feed";
 }
 interface WsConnected {
     type: "connected";
@@ -1622,8 +1631,10 @@ declare function applyOrderbookDelta(state: OrderbookState, delta: WsOrderbookDe
 /**
  * Agg platform WebSocket client.
  *
- * Single connection, refcounted subscriptions by ID (venueMarketId or
- * venueMarketOutcomeId). Maintains in-memory orderbook state per subscribed ID.
+ * Single connection, refcounted subscriptions. Orderbook/trades subscriptions
+ * are keyed by venueMarketOutcomeId (the `outcomes[].id` on REST market
+ * responses — NOT a venueMarketId); arb subscriptions are keyed by marketId.
+ * Maintains in-memory orderbook state per subscribed outcome id.
  * All timestamps converted from server ms to seconds before invoking callbacks.
  *
  * Recovery: seq gap or checksum mismatch → resnapshot request.
@@ -1632,8 +1643,10 @@ declare function applyOrderbookDelta(state: OrderbookState, delta: WsOrderbookDe
  */
 
 interface AggWebSocketCallbacks {
-    onSnapshot?: (marketId: string, book: OrderbookState) => void;
-    onDelta?: (marketId: string, book: OrderbookState) => void;
+    /** Invoked with the venueMarketOutcomeId the snapshot belongs to. */
+    onSnapshot?: (outcomeId: string, book: OrderbookState) => void;
+    /** Invoked with the venueMarketOutcomeId the delta belongs to. */
+    onDelta?: (outcomeId: string, book: OrderbookState) => void;
     onTrade?: (trade: WsTrade) => void;
     onHeartbeat?: (hb: WsHeartbeat) => void;
     onSubscribed?: (msg: WsSubscribed) => void;
@@ -2302,6 +2315,7 @@ interface MidpointRow {
     midpoint: number | null;
     spread: number | null;
     timestamp: number | null;
+    arbReturn?: number | null;
     /** Provenance of `midpoint`. */
     markSource?: MarkSource;
     /**
@@ -2310,6 +2324,10 @@ interface MidpointRow {
      * without re-running the matching logic.
      */
     siblingVenueMarketId?: string;
+    /** Top-of-book buy-side price. Only present when `bestPrice=true`. */
+    bestBid?: number | null;
+    /** Top-of-book sell-side price. Only present when `bestPrice=true`. */
+    bestAsk?: number | null;
 }
 /** Per-outcome midpoint from a live orderbook. */
 interface OutcomeMidpointRow {
@@ -2318,12 +2336,39 @@ interface OutcomeMidpointRow {
     midpoint: number | null;
     /** Provenance of `midpoint`. */
     markSource?: MarkSource;
+    /** Top-of-book buy-side price. Only present when `bestPrice=true`. */
+    bestBid?: number | null;
+    /** Top-of-book sell-side price. Only present when `bestPrice=true`. */
+    bestAsk?: number | null;
 }
 /** Response from GET /midpoints (batch). */
 interface BatchMidpointsResponse {
     data: Array<MidpointRow & {
         outcomes: OutcomeMidpointRow[];
         matched: MidpointRow[];
+        /**
+         * Live, quality-gated cross-venue arbitrage return for this market's
+         * cluster as a decimal fraction (`0.0085` = 0.85%), computed fresh by
+         * the engine on this request. Prefer it over the `arbReturn` embedded
+         * in venue-event listings, which a background sync can leave stale.
+         * Only present when the request set `bestPrice=true`.
+         */
+        arbReturn?: number | null;
+        /**
+         * DB status of the requested market. Present whenever the id resolves
+         * to a known market. Resolved markets never serve a price (see `error`).
+         */
+        marketStatus?: MarketStatus;
+        /**
+         * Structured refusal, mirroring GET /orderbooks per-item errors:
+         * `market_resolved` for settled markets (prices are nulled instead of
+         * serving a stale mark), `market_not_found` for unknown ids.
+         */
+        error?: {
+            code: "market_resolved" | "market_not_found";
+            message: string;
+            retryable: boolean;
+        };
     }>;
 }
 /** Response from GET /orderbook/outcome/:id (single outcome). */

package/dist/index.js

@@ -1593,7 +1593,7 @@ var AggWebSocket = class {
 // src/client.ts
 var COOKIE_REFRESH_DELIVERY = "cookie-refresh";
 var DEFAULT_MIDPOINT_IDS_PER_REQUEST = 75;
-var MAX_MIDPOINT_IDS_PER_REQUEST = 200;
+var MAX_MIDPOINT_IDS_PER_REQUEST = 75;
 var isUserProfile = (user) => {
   return "accounts" in user && "wallets" in user && "avatarUrl" in user;
 };
@@ -1638,6 +1638,17 @@ var chunkArray = (items, size) => {
   }
   return chunks;
 };
+var normalizeRequestedVenueMarketIds = (venueMarketIds) => {
+  const normalizedIds = [];
+  const seenIds = /* @__PURE__ */ new Set();
+  for (const venueMarketId of venueMarketIds) {
+    const normalizedVenueMarketId = venueMarketId.trim();
+    if (!normalizedVenueMarketId || seenIds.has(normalizedVenueMarketId)) continue;
+    seenIds.add(normalizedVenueMarketId);
+    normalizedIds.push(normalizedVenueMarketId);
+  }
+  return normalizedIds;
+};
 var mapChartResolution = (resolution) => {
   switch (resolution) {
     case void 0:
@@ -2811,7 +2822,8 @@ Issued At: ${issuedAt}`;
   getMidpoints(paramsOrVenueMarketIds, options) {
     return __async(this, null, function* () {
       var _a;
-      const venueMarketIds = Array.isArray(paramsOrVenueMarketIds) ? paramsOrVenueMarketIds : paramsOrVenueMarketIds.venueMarketIds;
+      const requestedVenueMarketIds = Array.isArray(paramsOrVenueMarketIds) ? paramsOrVenueMarketIds : paramsOrVenueMarketIds.venueMarketIds;
+      const venueMarketIds = normalizeRequestedVenueMarketIds(requestedVenueMarketIds);
       const bestPrice = !Array.isArray(paramsOrVenueMarketIds) ? paramsOrVenueMarketIds.bestPrice : options == null ? void 0 : options.bestPrice;
       const maxMidpointIdsPerRequest = resolveMidpointIdsPerRequest(
         (_a = options == null ? void 0 : options.maxMidpointIdsPerRequest) != null ? _a : Array.isArray(paramsOrVenueMarketIds) ? void 0 : paramsOrVenueMarketIds.maxMidpointIdsPerRequest
@@ -2824,6 +2836,9 @@ Issued At: ${issuedAt}`;
           signal: options == null ? void 0 : options.signal
         });
       };
+      if (venueMarketIds.length === 0) {
+        return { data: [] };
+      }
       if (venueMarketIds.length <= maxMidpointIdsPerRequest) {
         return requestBatch(venueMarketIds);
       }

package/dist/index.mjs

@@ -1480,7 +1480,7 @@ var AggWebSocket = class {
 // src/client.ts
 var COOKIE_REFRESH_DELIVERY = "cookie-refresh";
 var DEFAULT_MIDPOINT_IDS_PER_REQUEST = 75;
-var MAX_MIDPOINT_IDS_PER_REQUEST = 200;
+var MAX_MIDPOINT_IDS_PER_REQUEST = 75;
 var isUserProfile = (user) => {
   return "accounts" in user && "wallets" in user && "avatarUrl" in user;
 };
@@ -1525,6 +1525,17 @@ var chunkArray = (items, size) => {
   }
   return chunks;
 };
+var normalizeRequestedVenueMarketIds = (venueMarketIds) => {
+  const normalizedIds = [];
+  const seenIds = /* @__PURE__ */ new Set();
+  for (const venueMarketId of venueMarketIds) {
+    const normalizedVenueMarketId = venueMarketId.trim();
+    if (!normalizedVenueMarketId || seenIds.has(normalizedVenueMarketId)) continue;
+    seenIds.add(normalizedVenueMarketId);
+    normalizedIds.push(normalizedVenueMarketId);
+  }
+  return normalizedIds;
+};
 var mapChartResolution = (resolution) => {
   switch (resolution) {
     case void 0:
@@ -2698,7 +2709,8 @@ Issued At: ${issuedAt}`;
   getMidpoints(paramsOrVenueMarketIds, options) {
     return __async(this, null, function* () {
       var _a;
-      const venueMarketIds = Array.isArray(paramsOrVenueMarketIds) ? paramsOrVenueMarketIds : paramsOrVenueMarketIds.venueMarketIds;
+      const requestedVenueMarketIds = Array.isArray(paramsOrVenueMarketIds) ? paramsOrVenueMarketIds : paramsOrVenueMarketIds.venueMarketIds;
+      const venueMarketIds = normalizeRequestedVenueMarketIds(requestedVenueMarketIds);
       const bestPrice = !Array.isArray(paramsOrVenueMarketIds) ? paramsOrVenueMarketIds.bestPrice : options == null ? void 0 : options.bestPrice;
       const maxMidpointIdsPerRequest = resolveMidpointIdsPerRequest(
         (_a = options == null ? void 0 : options.maxMidpointIdsPerRequest) != null ? _a : Array.isArray(paramsOrVenueMarketIds) ? void 0 : paramsOrVenueMarketIds.maxMidpointIdsPerRequest
@@ -2711,6 +2723,9 @@ Issued At: ${issuedAt}`;
           signal: options == null ? void 0 : options.signal
         });
       };
+      if (venueMarketIds.length === 0) {
+        return { data: [] };
+      }
       if (venueMarketIds.length <= maxMidpointIdsPerRequest) {
         return requestBatch(venueMarketIds);
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agg-build/sdk",
-  "version": "2.2.0",
+  "version": "2.2.1",
   "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",