@ostium/builder-sdk 0.2.0 → 0.3.0

package/dist/index.d.cts

@@ -624,11 +624,24 @@ interface GetPairsParams {
 interface GetUserParams {
     user: Address;
 }
-interface GetOpenPositionsParams extends GetUserParams {
+interface GetOpenPositionsParams {
+    /**
+     * Trader address — pass `'ALL'` to fetch every trader's open positions
+     * (no trader filter applied to the subgraph query).
+     */
+    user: Address | AllTraders;
     /** Current Arbitrum block number — required for live PnL. Auto-fetched on `OstiumClient`. */
     blockNumber?: bigint;
+    /**
+     * Maximum number of positions to return. Defaults to `Infinity` (all positions).
+     */
+    limit?: number;
+    /**
+     * Number of positions to skip (for pagination). Defaults to `0`.
+     */
+    skip?: number;
 }
-/** Sentinel value for `getFills` / `getFillsByTime` to fetch every trader's fills. */
+/** Sentinel value for `getOpenPositions`, `getFills`, and `getFillsByTime` to fetch across every trader. */
 type AllTraders = 'ALL';
 interface GetFillsParams {
     /**
@@ -1349,6 +1362,11 @@ declare class OstiumClient {
     /**
      * Open positions + margin summary for a user. Defaults to the connected
      * trader. Live prices and the current block number are fetched automatically.
+     *
+     * - `user`: pass an address to scope to a single trader, or `'ALL'` to fetch
+     *   positions across every trader (no trader filter).
+     * - `limit`: cap the number of positions returned (default: all).
+     * - `skip`: offset into the result set for pagination (default: `0`).
      */
     getOpenPositions(params?: Partial<GetOpenPositionsParams>): Promise<OpenPositionsResponse>;
     /**

package/dist/index.d.ts

@@ -624,11 +624,24 @@ interface GetPairsParams {
 interface GetUserParams {
     user: Address;
 }
-interface GetOpenPositionsParams extends GetUserParams {
+interface GetOpenPositionsParams {
+    /**
+     * Trader address — pass `'ALL'` to fetch every trader's open positions
+     * (no trader filter applied to the subgraph query).
+     */
+    user: Address | AllTraders;
     /** Current Arbitrum block number — required for live PnL. Auto-fetched on `OstiumClient`. */
     blockNumber?: bigint;
+    /**
+     * Maximum number of positions to return. Defaults to `Infinity` (all positions).
+     */
+    limit?: number;
+    /**
+     * Number of positions to skip (for pagination). Defaults to `0`.
+     */
+    skip?: number;
 }
-/** Sentinel value for `getFills` / `getFillsByTime` to fetch every trader's fills. */
+/** Sentinel value for `getOpenPositions`, `getFills`, and `getFillsByTime` to fetch across every trader. */
 type AllTraders = 'ALL';
 interface GetFillsParams {
     /**
@@ -1349,6 +1362,11 @@ declare class OstiumClient {
     /**
      * Open positions + margin summary for a user. Defaults to the connected
      * trader. Live prices and the current block number are fetched automatically.
+     *
+     * - `user`: pass an address to scope to a single trader, or `'ALL'` to fetch
+     *   positions across every trader (no trader filter).
+     * - `limit`: cap the number of positions returned (default: all).
+     * - `skip`: offset into the result set for pagination (default: `0`).
      */
     getOpenPositions(params?: Partial<GetOpenPositionsParams>): Promise<OpenPositionsResponse>;
     /**

package/dist/index.js

@@ -2938,6 +2938,17 @@ query GetTraderOpenTrades($trader: String!, $skip: Int!, $first: Int!) {
     ${PAIR_FULL}
   }
 }`;
+var GetAllOpenTradesQuery = `
+query GetAllOpenTrades($skip: Int!, $first: Int!) {
+  trades(
+    where: { isOpen: true }
+    skip: $skip first: $first
+    orderBy: timestamp orderDirection: desc
+  ) {
+    ${TRADE_CORE}
+    ${PAIR_FULL}
+  }
+}`;
 var ORDER_FIELDS = `
     id tradeID limitID trader
     pair { id from to group { id name } }
@@ -3017,9 +3028,9 @@ query GetTraderActiveLimits($trader: String!, $skip: Int!, $first: Int!) {
 }`;
 
 // src/data/internal/pagination.ts
-async function paginateAll(fetcher, batchSize = 1e3, max = Infinity) {
+async function paginateAll(fetcher, batchSize = 1e3, max = Infinity, initialSkip = 0) {
   const results = [];
-  let skip = 0;
+  let skip = initialSkip;
   while (results.length < max) {
     const remaining = max - results.length;
     const fetchSize = Math.min(batchSize, remaining);
@@ -3948,15 +3959,28 @@ var OstiumSubgraphClient = class _OstiumSubgraphClient {
    *   PnL fields are zeroed.
    */
   async getOpenPositions(params) {
-    const { user, blockNumber } = params;
+    const { user, blockNumber, limit = Infinity, skip: initialSkip = 0 } = params;
+    const isGlobal = user === "ALL";
     const [trades, prices] = await Promise.all([
-      paginateAll(async (skip, first) => {
-        const data = await this.query(
-          GetTraderOpenTradesQuery,
-          { trader: user.toLowerCase(), skip, first }
-        );
-        return data.trades;
-      }),
+      paginateAll(
+        async (skip, first) => {
+          if (isGlobal) {
+            const data2 = await this.query(
+              GetAllOpenTradesQuery,
+              { skip, first }
+            );
+            return data2.trades;
+          }
+          const data = await this.query(
+            GetTraderOpenTradesQuery,
+            { trader: user.toLowerCase(), skip, first }
+          );
+          return data.trades;
+        },
+        1e3,
+        limit,
+        initialSkip
+      ),
       this.fetchLivePricesSafe()
     ]);
     const pairPositions = trades.map((trade) => {
@@ -5124,11 +5148,18 @@ var OstiumClient = class _OstiumClient {
   /**
    * Open positions + margin summary for a user. Defaults to the connected
    * trader. Live prices and the current block number are fetched automatically.
+   *
+   * - `user`: pass an address to scope to a single trader, or `'ALL'` to fetch
+   *   positions across every trader (no trader filter).
+   * - `limit`: cap the number of positions returned (default: all).
+   * - `skip`: offset into the result set for pagination (default: `0`).
    */
   async getOpenPositions(params) {
     return this.subgraph.getOpenPositions({
       user: params?.user ?? this.getTraderAddress(),
-      blockNumber: params?.blockNumber ?? await this.publicClient.getBlockNumber()
+      blockNumber: params?.blockNumber ?? await this.publicClient.getBlockNumber(),
+      limit: params?.limit,
+      skip: params?.skip
     });
   }
   /**