@pear-protocol/core-sdk 1.12.1 → 1.13.0

package/dist/core/index.d.ts

@@ -1904,6 +1904,7 @@ declare class Core {
                 connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
                 type: "spot" | "perp" | "hip3";
                 leverage: number;
+                marginMode: "any" | "isolated" | "cross";
                 precision: {
                     quantity: {
                         decimals: number;
@@ -1930,6 +1931,7 @@ declare class Core {
             instruments: {
                 id: string;
                 base: string;
+                marginMode: "any" | "isolated" | "cross";
                 precision: {
                     quantity: {
                         contractSize: number;
@@ -1974,8 +1976,11 @@ declare class Core {
                 connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
                 basketKey: string;
                 displaySymbol: string;
-                longInstrumentIds: string[];
-                shortInstrumentIds: string[];
+                legs: {
+                    id: string;
+                    symbol: string;
+                    side: "BUY" | "SELL";
+                }[];
                 price: string;
                 priceChange24h: string;
                 weightRatio: string;
@@ -1991,13 +1996,25 @@ declare class Core {
                 hasMaterializedStats: boolean;
             }[];
         }>;
+        basketPositions: (body: HttpTypes.MarketBasketPositionCountsPayloadInput, headers?: ClientHeaders) => Promise<{
+            counts: {
+                basketKey: string;
+                opened: number;
+                traders: number;
+            }[];
+        }>;
     };
     notifications: {
         list: (query?: HttpTypes.NotificationListParamsInput, headers?: ClientHeaders) => Promise<{
             notifications: {
                 id: string;
-                category: "TAKE_PROFIT_HIT" | "STOP_LOSS_HIT" | "TRIGGER_ORDER_HIT" | "TAKE_PROFIT_FAILED" | "STOP_LOSS_FAILED" | "TRIGGER_ORDER_FAILED" | "ATTACHED_TRIGGER_DISCARDED";
+                category: "TAKE_PROFIT_HIT" | "STOP_LOSS_HIT" | "TRIGGER_ORDER_HIT" | "TAKE_PROFIT_FAILED" | "STOP_LOSS_FAILED" | "TRIGGER_ORDER_FAILED" | "ATTACHED_TRIGGER_DISCARDED" | "AUTO_REBALANCE_EXECUTED" | "AUTO_REBALANCE_FAILED" | "AUTO_REBALANCE_PAUSED";
                 parameters: {
+                    legs: {
+                        id: string;
+                        symbol: string;
+                        side: "BUY" | "SELL";
+                    }[];
                     type: "take_profit";
                     triggerId: string;
                     positionId: string;
@@ -2006,6 +2023,11 @@ declare class Core {
                     level?: number | undefined;
                     reason?: string | undefined;
                 } | {
+                    legs: {
+                        id: string;
+                        symbol: string;
+                        side: "BUY" | "SELL";
+                    }[];
                     type: "stop_loss";
                     triggerId: string;
                     positionId: string;
@@ -2014,6 +2036,11 @@ declare class Core {
                     level?: number | undefined;
                     reason?: string | undefined;
                 } | {
+                    legs: {
+                        id: string;
+                        symbol: string;
+                        side: "BUY" | "SELL";
+                    }[];
                     type: "trigger_order";
                     triggerId: string;
                     positionId: string;
@@ -2022,6 +2049,11 @@ declare class Core {
                     level?: number | undefined;
                     reason?: string | undefined;
                 } | {
+                    legs: {
+                        id: string;
+                        symbol: string;
+                        side: "BUY" | "SELL";
+                    }[];
                     type: "default_trigger";
                     triggerId: string;
                     connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
@@ -2029,6 +2061,11 @@ declare class Core {
                     level?: number | undefined;
                     reason?: string | undefined;
                 } | {
+                    legs: {
+                        id: string;
+                        symbol: string;
+                        side: "BUY" | "SELL";
+                    }[];
                     type: "attached_trigger_discarded";
                     positionId: string;
                     positionKey: string;
@@ -2040,6 +2077,51 @@ declare class Core {
                         level?: number | undefined;
                     }[];
                     activeTriggerLimit: number;
+                } | {
+                    legs: {
+                        id: string;
+                        symbol: string;
+                        side: "BUY" | "SELL";
+                        currentWeight: number;
+                        targetWeight: number;
+                    }[];
+                    driftPct: number;
+                    notionalUsd: number;
+                    configId: string;
+                    positionId: string;
+                    positionKey: string;
+                    connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                    weightSource: "INITIAL_WEIGHT" | "LIVE_BETA";
+                    type: "auto_rebalance_executed";
+                } | {
+                    legs: {
+                        id: string;
+                        symbol: string;
+                        side: "BUY" | "SELL";
+                        currentWeight: number;
+                        targetWeight: number;
+                    }[];
+                    driftPct: number;
+                    reason: string;
+                    configId: string;
+                    positionId: string;
+                    positionKey: string;
+                    connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                    weightSource: "INITIAL_WEIGHT" | "LIVE_BETA";
+                    type: "auto_rebalance_failed";
+                } | {
+                    legs: {
+                        id: string;
+                        symbol: string;
+                        side: "BUY" | "SELL";
+                    }[];
+                    pausedReason: "POSITION_CHANGED" | "REPEATED_FAILURES" | "INVALID_LIVE_BETA_EXPOSURE";
+                    configId: string;
+                    positionId: string;
+                    positionKey: string;
+                    connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                    weightSource: "INITIAL_WEIGHT" | "LIVE_BETA";
+                    type: "auto_rebalance_paused";
                 };
                 isRead: boolean;
                 createdAt: string;
@@ -2096,6 +2178,83 @@ declare class Core {
                 connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
             }[];
         }>;
+        /**
+         * Closed-trade history, newest close first, composed server-side.
+         *
+         * A page may hold fewer than `limit` trades and still return a `nextCursor` —
+         * page until `nextCursor` is absent, never until a page comes back short.
+         */
+        closed: (query?: HttpTypes.ClosedPositionListParamsInput, headers?: ClientHeaders) => Promise<{
+            limit: number;
+            trades: {
+                positionId: string;
+                connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                openedAt: string;
+                closedAt: string;
+                origin: "PARTIAL" | "PEAR" | "EXTERNAL";
+                grossPnl: `-${string}` | `+${string}`;
+                netPnl: `-${string}` | `+${string}`;
+                totalFees: `-${string}` | `+${string}`;
+                tradeFees: `-${string}` | `+${string}`;
+                pearFees: `-${string}` | `+${string}`;
+                totalFunding: `-${string}` | `+${string}`;
+                entryNotional: string;
+                exitNotional: string;
+                exitNotionalComplete: boolean;
+                hasSyntheticFills: boolean;
+                unstableHistoricalData: boolean;
+                longAssets: string[];
+                shortAssets: string[];
+                legs: {
+                    asset: string;
+                    side: "LONG" | "SHORT";
+                    grossPnl: `-${string}` | `+${string}`;
+                    netPnl: `-${string}` | `+${string}`;
+                    totalFees: `-${string}` | `+${string}`;
+                    tradeFees: `-${string}` | `+${string}`;
+                    pearFees: `-${string}` | `+${string}`;
+                    funding: `-${string}` | `+${string}`;
+                    entryNotional: string;
+                    exitQuantity: string;
+                    undeterminedSize: string;
+                    entryVwap?: string | undefined;
+                    exitVwap?: string | undefined;
+                }[];
+                closedReason?: "USER" | "NETTED" | "LIQUIDATED" | undefined;
+                steps?: {
+                    at: string;
+                    grossPnl: `-${string}` | `+${string}`;
+                    legs: ({
+                        kind: "INCREASE";
+                        asset: string;
+                        side: "BUY" | "SELL";
+                        quantity: string;
+                        price: string;
+                        tradeFee: `-${string}` | `+${string}`;
+                        pearFee: `-${string}` | `+${string}`;
+                    } | {
+                        kind: "REDUCE";
+                        asset: string;
+                        side: "BUY" | "SELL";
+                        quantity: string;
+                        price: string;
+                        entryBasis: string;
+                        grossPnl: `-${string}` | `+${string}`;
+                        tradeFee: `-${string}` | `+${string}`;
+                        pearFee: `-${string}` | `+${string}`;
+                    } | {
+                        kind: "REDUCE_UNPRICED";
+                        asset: string;
+                        side: "BUY" | "SELL";
+                        quantity: string;
+                        tradeFee: `-${string}` | `+${string}`;
+                        pearFee: `-${string}` | `+${string}`;
+                    })[];
+                    executionId?: string | undefined;
+                }[] | undefined;
+            }[];
+            nextCursor?: string | undefined;
+        }>;
     };
     portfolio: {
         overview: (query?: HttpTypes.PortfolioQueryInput, headers?: ClientHeaders) => Promise<{
@@ -2296,17 +2455,38 @@ declare class Core {
         auto: {
             list: (query?: HttpTypes.AutoRebalanceListParamsInput, headers?: ClientHeaders) => Promise<{
                 limit: number;
-                items: {
+                items: ({
                     id: string;
                     positionId: string;
                     status: "ACTIVE" | "PAUSED";
-                    weightSource: "INITIAL_WEIGHT" | "LIVE_BETA";
                     minimumDriftPct: string;
                     createdAt: string;
                     updatedAt: string;
-                    pausedReason?: "USER" | "POSITION_CHANGED" | "REPEATED_FAILURES" | undefined;
-                    timeframe?: "1d" | "1h" | "4h" | undefined;
-                }[];
+                    weightSource: "INITIAL_WEIGHT";
+                    pausedReason?: "USER" | "POSITION_CHANGED" | "REPEATED_FAILURES" | "INVALID_LIVE_BETA_EXPOSURE" | undefined;
+                } | {
+                    id: string;
+                    positionId: string;
+                    status: "ACTIVE" | "PAUSED";
+                    minimumDriftPct: string;
+                    createdAt: string;
+                    updatedAt: string;
+                    weightSource: "LIVE_BETA";
+                    timeframe: "1d" | "1h" | "4h";
+                    beta: {
+                        state: "PENDING";
+                    } | {
+                        state: "BASELINED";
+                        impliedEntryBeta: string;
+                    } | {
+                        state: "TRACKING";
+                        impliedEntryBeta: string;
+                        lastDerivedBeta: string;
+                        lastProcessedBetaTime: string;
+                        driftPct?: string | undefined;
+                    };
+                    pausedReason?: "USER" | "POSITION_CHANGED" | "REPEATED_FAILURES" | "INVALID_LIVE_BETA_EXPOSURE" | undefined;
+                })[];
                 nextCursor?: string | undefined;
             }>;
             create: (body: HttpTypes.CreateAutoRebalanceConfig, headers?: ClientHeaders) => Promise<{
@@ -2314,12 +2494,33 @@ declare class Core {
                     id: string;
                     positionId: string;
                     status: "ACTIVE" | "PAUSED";
-                    weightSource: "INITIAL_WEIGHT" | "LIVE_BETA";
                     minimumDriftPct: string;
                     createdAt: string;
                     updatedAt: string;
-                    pausedReason?: "USER" | "POSITION_CHANGED" | "REPEATED_FAILURES" | undefined;
-                    timeframe?: "1d" | "1h" | "4h" | undefined;
+                    weightSource: "INITIAL_WEIGHT";
+                    pausedReason?: "USER" | "POSITION_CHANGED" | "REPEATED_FAILURES" | "INVALID_LIVE_BETA_EXPOSURE" | undefined;
+                } | {
+                    id: string;
+                    positionId: string;
+                    status: "ACTIVE" | "PAUSED";
+                    minimumDriftPct: string;
+                    createdAt: string;
+                    updatedAt: string;
+                    weightSource: "LIVE_BETA";
+                    timeframe: "1d" | "1h" | "4h";
+                    beta: {
+                        state: "PENDING";
+                    } | {
+                        state: "BASELINED";
+                        impliedEntryBeta: string;
+                    } | {
+                        state: "TRACKING";
+                        impliedEntryBeta: string;
+                        lastDerivedBeta: string;
+                        lastProcessedBetaTime: string;
+                        driftPct?: string | undefined;
+                    };
+                    pausedReason?: "USER" | "POSITION_CHANGED" | "REPEATED_FAILURES" | "INVALID_LIVE_BETA_EXPOSURE" | undefined;
                 };
             }>;
             update: (id: string, body: HttpTypes.UpdateAutoRebalanceConfig, headers?: ClientHeaders) => Promise<{
@@ -2327,12 +2528,33 @@ declare class Core {
                     id: string;
                     positionId: string;
                     status: "ACTIVE" | "PAUSED";
-                    weightSource: "INITIAL_WEIGHT" | "LIVE_BETA";
                     minimumDriftPct: string;
                     createdAt: string;
                     updatedAt: string;
-                    pausedReason?: "USER" | "POSITION_CHANGED" | "REPEATED_FAILURES" | undefined;
-                    timeframe?: "1d" | "1h" | "4h" | undefined;
+                    weightSource: "INITIAL_WEIGHT";
+                    pausedReason?: "USER" | "POSITION_CHANGED" | "REPEATED_FAILURES" | "INVALID_LIVE_BETA_EXPOSURE" | undefined;
+                } | {
+                    id: string;
+                    positionId: string;
+                    status: "ACTIVE" | "PAUSED";
+                    minimumDriftPct: string;
+                    createdAt: string;
+                    updatedAt: string;
+                    weightSource: "LIVE_BETA";
+                    timeframe: "1d" | "1h" | "4h";
+                    beta: {
+                        state: "PENDING";
+                    } | {
+                        state: "BASELINED";
+                        impliedEntryBeta: string;
+                    } | {
+                        state: "TRACKING";
+                        impliedEntryBeta: string;
+                        lastDerivedBeta: string;
+                        lastProcessedBetaTime: string;
+                        driftPct?: string | undefined;
+                    };
+                    pausedReason?: "USER" | "POSITION_CHANGED" | "REPEATED_FAILURES" | "INVALID_LIVE_BETA_EXPOSURE" | undefined;
                 };
             }>;
             replace: (id: string, body: HttpTypes.ReplaceAutoRebalanceConfig, headers?: ClientHeaders) => Promise<{
@@ -2340,12 +2562,33 @@ declare class Core {
                     id: string;
                     positionId: string;
                     status: "ACTIVE" | "PAUSED";
-                    weightSource: "INITIAL_WEIGHT" | "LIVE_BETA";
                     minimumDriftPct: string;
                     createdAt: string;
                     updatedAt: string;
-                    pausedReason?: "USER" | "POSITION_CHANGED" | "REPEATED_FAILURES" | undefined;
-                    timeframe?: "1d" | "1h" | "4h" | undefined;
+                    weightSource: "INITIAL_WEIGHT";
+                    pausedReason?: "USER" | "POSITION_CHANGED" | "REPEATED_FAILURES" | "INVALID_LIVE_BETA_EXPOSURE" | undefined;
+                } | {
+                    id: string;
+                    positionId: string;
+                    status: "ACTIVE" | "PAUSED";
+                    minimumDriftPct: string;
+                    createdAt: string;
+                    updatedAt: string;
+                    weightSource: "LIVE_BETA";
+                    timeframe: "1d" | "1h" | "4h";
+                    beta: {
+                        state: "PENDING";
+                    } | {
+                        state: "BASELINED";
+                        impliedEntryBeta: string;
+                    } | {
+                        state: "TRACKING";
+                        impliedEntryBeta: string;
+                        lastDerivedBeta: string;
+                        lastProcessedBetaTime: string;
+                        driftPct?: string | undefined;
+                    };
+                    pausedReason?: "USER" | "POSITION_CHANGED" | "REPEATED_FAILURES" | "INVALID_LIVE_BETA_EXPOSURE" | undefined;
                 };
             }>;
             cancel: (id: string, headers?: ClientHeaders) => Promise<void>;
@@ -2367,6 +2610,17 @@ declare class Core {
             nextCursor?: string | undefined;
         }>;
     };
+    referrals: {
+        /** Issue an immutable referral code to the authenticated user. */
+        create: (body: HttpTypes.CreateReferralCode, headers?: ClientHeaders) => Promise<void>;
+        /** Permanently bind the authenticated user to an existing referral code. */
+        bind: (body: HttpTypes.BindReferralCode, headers?: ClientHeaders) => Promise<void>;
+        /** Return referral codes owned by the authenticated user and their referrer. */
+        status: (headers?: ClientHeaders) => Promise<{
+            ownedCodes: string[];
+            referrerUserId?: string | undefined;
+        }>;
+    };
     savedBaskets: {
         list: (headers?: ClientHeaders) => Promise<{
             baskets: {
@@ -2640,6 +2894,7 @@ declare class Core {
             since: (body: HttpTypes.SyncFillsSinceRequest, headers?: ClientHeaders) => Promise<{
                 sinceMs: number;
                 neverSynced: boolean;
+                firstSyncStartedAt?: number | undefined;
                 confirmedExchangeFillIds?: string[] | undefined;
             }>;
             reconcile: (body: HttpTypes.ReconcileFillsRequest, headers?: ClientHeaders) => Promise<Record<string, never>>;

package/dist/core/index.js

@@ -207,6 +207,13 @@ class Core {
         headers,
         query
       });
+    },
+    basketPositions: async (body, headers) => {
+      return await this.client.fetch(`/markets/baskets/positions`, {
+        method: "POST",
+        headers,
+        body
+      });
     }
   };
   notifications = {
@@ -253,6 +260,19 @@ class Core {
         method: "GET",
         headers
       });
+    },
+    /**
+     * Closed-trade history, newest close first, composed server-side.
+     *
+     * A page may hold fewer than `limit` trades and still return a `nextCursor` —
+     * page until `nextCursor` is absent, never until a page comes back short.
+     */
+    closed: async (query, headers) => {
+      return await this.client.fetch(`/positions/closed`, {
+        method: "GET",
+        headers,
+        query
+      });
     }
   };
   portfolio = {
@@ -332,6 +352,31 @@ class Core {
       });
     }
   };
+  referrals = {
+    /** Issue an immutable referral code to the authenticated user. */
+    create: async (body, headers) => {
+      return await this.client.fetch(`/referrals/create`, {
+        method: "POST",
+        headers,
+        body
+      });
+    },
+    /** Permanently bind the authenticated user to an existing referral code. */
+    bind: async (body, headers) => {
+      return await this.client.fetch(`/referrals/bind`, {
+        method: "POST",
+        headers,
+        body
+      });
+    },
+    /** Return referral codes owned by the authenticated user and their referrer. */
+    status: async (headers) => {
+      return await this.client.fetch(`/referrals/status`, {
+        method: "GET",
+        headers
+      });
+    }
+  };
   savedBaskets = {
     list: async (headers) => {
       return await this.client.fetch(`/saved-baskets`, {

package/dist/utils.d.ts

@@ -4,7 +4,7 @@ import '@pear-protocol/utils';
 
 declare function getBaseUrl(passedBaseUrl: string): string;
 declare function normalizeRequest(init: FetchArgs | undefined, headers: Headers, authMode: AuthMode): RequestInit | undefined;
-declare function normalizeResponseData(resp: Response, reqHeaders: Headers): Promise<any>;
+declare function normalizeResponseData(resp: Response, reqHeaders: Headers): Promise<unknown>;
 declare class FetchError extends Error {
     status: number | undefined;
     statusText: string | undefined;

package/dist/utils.js

@@ -33,7 +33,14 @@ async function normalizeResponseData(resp, reqHeaders) {
     return null;
   }
   const isJsonRequest = reqHeaders.get("accept")?.includes("application/json");
-  return isJsonRequest ? await resp.json() : resp;
+  if (!isJsonRequest) {
+    return resp;
+  }
+  const responseText = await resp.text();
+  if (responseText.length === 0) {
+    return null;
+  }
+  return JSON.parse(responseText);
 }
 class FetchError extends Error {
   status;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pear-protocol/core-sdk",
-  "version": "1.12.1",
+  "version": "1.13.0",
   "description": "Pear Protocol Core SDK",
   "private": false,
   "type": "module",
@@ -25,8 +25,8 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@pear-protocol/types": "^1.15.0",
-    "@pear-protocol/utils": "^0.4.0",
+    "@pear-protocol/types": "^1.17.0",
+    "@pear-protocol/utils": "^0.5.0",
     "qs": "^6.14.0"
   },
   "devDependencies": {