@pear-protocol/core-sdk 1.5.0 → 1.7.0

package/dist/admin/index.d.ts

@@ -1,6 +1,7 @@
 import { HttpTypes } from '@pear-protocol/types';
 import { HttpClient } from '../http.js';
 import { ClientHeaders } from '../types.js';
+import '@pear-protocol/utils';
 
 declare class Admin {
     private client;

package/dist/auth/index.d.ts

@@ -1,6 +1,7 @@
 import { HttpTypes } from '@pear-protocol/types';
 import { HttpClient } from '../http.js';
 import { ClientHeaders } from '../types.js';
+import '@pear-protocol/utils';
 
 declare class Auth {
     private client;

package/dist/core/index.d.ts

@@ -1,6 +1,7 @@
 import { HttpTypes } from '@pear-protocol/types';
 import { HttpClient } from '../http.js';
 import { ClientHeaders } from '../types.js';
+import '@pear-protocol/utils';
 
 declare class Core {
     private client;
@@ -204,7 +205,6 @@ declare class Core {
     executions: {
         list: (query: HttpTypes.ExecutionListParamsInput, headers?: ClientHeaders) => Promise<{
             limit: number;
-            nextCursor: string | undefined;
             executions: ({
                 id: string;
                 connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
@@ -348,6 +348,152 @@ declare class Core {
                     filledPrice?: string | undefined;
                 }[] | undefined;
             })[];
+            nextCursor?: string | undefined;
+        }>;
+        get: (id: string, headers?: ClientHeaders) => Promise<{
+            execution: {
+                id: string;
+                connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                status: "CANCELLED" | "ACTIVE" | "COMPLETED" | "IDLE" | "FAILED";
+                createdAt: string;
+                updatedAt: string;
+                intent: "OPEN";
+                orderType: "MARKET";
+                legs: [{
+                    symbol: string;
+                    side: "BUY" | "SELL";
+                    mode: "QUANTITY" | "USD";
+                    amount: string;
+                    reduceOnly: boolean;
+                }, ...{
+                    symbol: string;
+                    side: "BUY" | "SELL";
+                    mode: "QUANTITY" | "USD";
+                    amount: string;
+                    reduceOnly: boolean;
+                }[]];
+                error?: string | undefined;
+                orders?: {
+                    id: string;
+                    connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                    status: "CANCELLED" | "PENDING" | "PARTIAL" | "FILLED" | "REJECTED";
+                    createdAt: string;
+                    updatedAt: string;
+                    type: "MARKET";
+                    symbol: string;
+                    side: "BUY" | "SELL";
+                    reduceOnly: boolean;
+                    leverage: number;
+                    quantity: string;
+                    price: string;
+                    filledQuantity: string;
+                    error?: string | undefined;
+                    filledPrice?: string | undefined;
+                }[] | undefined;
+            } | {
+                id: string;
+                connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                status: "CANCELLED" | "ACTIVE" | "COMPLETED" | "IDLE" | "FAILED";
+                createdAt: string;
+                updatedAt: string;
+                intent: "ADJUST";
+                orderType: "MARKET";
+                position: {
+                    id: string;
+                    exposure: Record<string, `-${string}` | `+${string}`>;
+                };
+                legs: [{
+                    symbol: string;
+                    side: "BUY" | "SELL";
+                    mode: "QUANTITY" | "USD";
+                    amount: string;
+                    reduceOnly: boolean;
+                }, ...{
+                    symbol: string;
+                    side: "BUY" | "SELL";
+                    mode: "QUANTITY" | "USD";
+                    amount: string;
+                    reduceOnly: boolean;
+                }[]];
+                error?: string | undefined;
+                orders?: {
+                    id: string;
+                    connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                    status: "CANCELLED" | "PENDING" | "PARTIAL" | "FILLED" | "REJECTED";
+                    createdAt: string;
+                    updatedAt: string;
+                    type: "MARKET";
+                    symbol: string;
+                    side: "BUY" | "SELL";
+                    reduceOnly: boolean;
+                    leverage: number;
+                    quantity: string;
+                    price: string;
+                    filledQuantity: string;
+                    error?: string | undefined;
+                    filledPrice?: string | undefined;
+                }[] | undefined;
+            } | {
+                id: string;
+                connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                status: "CANCELLED" | "ACTIVE" | "COMPLETED" | "IDLE" | "FAILED";
+                createdAt: string;
+                updatedAt: string;
+                intent: "CLOSE";
+                orderType: "MARKET";
+                position: {
+                    id: string;
+                    exposure: Record<string, `-${string}` | `+${string}`>;
+                };
+                error?: string | undefined;
+                orders?: {
+                    id: string;
+                    connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                    status: "CANCELLED" | "PENDING" | "PARTIAL" | "FILLED" | "REJECTED";
+                    createdAt: string;
+                    updatedAt: string;
+                    type: "MARKET";
+                    symbol: string;
+                    side: "BUY" | "SELL";
+                    reduceOnly: boolean;
+                    leverage: number;
+                    quantity: string;
+                    price: string;
+                    filledQuantity: string;
+                    error?: string | undefined;
+                    filledPrice?: string | undefined;
+                }[] | undefined;
+            } | {
+                id: string;
+                connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                status: "CANCELLED" | "ACTIVE" | "COMPLETED" | "IDLE" | "FAILED";
+                createdAt: string;
+                updatedAt: string;
+                intent: "REVERSE";
+                orderType: "MARKET";
+                position: {
+                    id: string;
+                    exposure: Record<string, `-${string}` | `+${string}`>;
+                };
+                error?: string | undefined;
+                orders?: {
+                    id: string;
+                    connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                    status: "CANCELLED" | "PENDING" | "PARTIAL" | "FILLED" | "REJECTED";
+                    createdAt: string;
+                    updatedAt: string;
+                    type: "MARKET";
+                    symbol: string;
+                    side: "BUY" | "SELL";
+                    reduceOnly: boolean;
+                    leverage: number;
+                    quantity: string;
+                    price: string;
+                    filledQuantity: string;
+                    error?: string | undefined;
+                    filledPrice?: string | undefined;
+                }[] | undefined;
+            };
         }>;
     };
     fills: {
@@ -379,7 +525,6 @@ declare class Core {
         }>;
         list: (query: HttpTypes.FillListParams, headers?: ClientHeaders) => Promise<{
             limit: number;
-            nextCursor: string | undefined;
             fills: {
                 id: string;
                 status: "PROVISIONAL" | "CONFIRMED" | "RECONCILED";
@@ -404,6 +549,7 @@ declare class Core {
                     quantity: string;
                 } | undefined;
             }[];
+            nextCursor?: string | undefined;
         }>;
         provisionals: (headers?: ClientHeaders) => Promise<{
             fills: {
@@ -426,7 +572,6 @@ declare class Core {
     ladders: {
         list: (query: HttpTypes.LadderListParamsInput, headers?: ClientHeaders) => Promise<{
             limit: number;
-            nextCursor: string | undefined;
             ladders: {
                 id: string;
                 connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
@@ -859,6 +1004,7 @@ declare class Core {
                 createdAt: string;
                 updatedAt: string;
             }[];
+            nextCursor?: string | undefined;
         }>;
         create: (body: HttpTypes.CreateLadder, headers?: ClientHeaders) => Promise<{
             ladder: {
@@ -1822,26 +1968,50 @@ declare class Core {
         list: (query?: HttpTypes.NotificationListParamsInput, headers?: ClientHeaders) => Promise<{
             notifications: {
                 id: string;
-                category: "TAKE_PROFIT_HIT" | "STOP_LOSS_HIT" | "TRIGGER_ORDER_HIT";
+                category: "TAKE_PROFIT_HIT" | "STOP_LOSS_HIT" | "TRIGGER_ORDER_HIT" | "TAKE_PROFIT_FAILED" | "STOP_LOSS_FAILED" | "TRIGGER_ORDER_FAILED" | "ATTACHED_TRIGGER_DISCARDED";
                 parameters: {
                     type: "take_profit";
                     triggerId: string;
                     positionId: string;
                     connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                    metric?: "price" | "ratio" | "weighted_ratio" | "funding_rate" | "prediction_market" | "btc_dominance" | "notional" | "upnl" | "upnl_bps" | "ratio_trailing" | "price_trailing" | "weighted_ratio_trailing" | "notional_trailing" | "upnl_trailing" | "upnl_bps_trailing" | undefined;
+                    level?: number | undefined;
+                    reason?: string | undefined;
                 } | {
                     type: "stop_loss";
                     triggerId: string;
                     positionId: string;
                     connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                    metric?: "price" | "ratio" | "weighted_ratio" | "funding_rate" | "prediction_market" | "btc_dominance" | "notional" | "upnl" | "upnl_bps" | "ratio_trailing" | "price_trailing" | "weighted_ratio_trailing" | "notional_trailing" | "upnl_trailing" | "upnl_bps_trailing" | undefined;
+                    level?: number | undefined;
+                    reason?: string | undefined;
                 } | {
                     type: "trigger_order";
                     triggerId: string;
                     positionId: string;
                     connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                    metric?: "price" | "ratio" | "weighted_ratio" | "funding_rate" | "prediction_market" | "btc_dominance" | "notional" | "upnl" | "upnl_bps" | "ratio_trailing" | "price_trailing" | "weighted_ratio_trailing" | "notional_trailing" | "upnl_trailing" | "upnl_bps_trailing" | undefined;
+                    level?: number | undefined;
+                    reason?: string | undefined;
                 } | {
                     type: "default_trigger";
                     triggerId: string;
                     connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                    metric?: "price" | "ratio" | "weighted_ratio" | "funding_rate" | "prediction_market" | "btc_dominance" | "notional" | "upnl" | "upnl_bps" | "ratio_trailing" | "price_trailing" | "weighted_ratio_trailing" | "notional_trailing" | "upnl_trailing" | "upnl_bps_trailing" | undefined;
+                    level?: number | undefined;
+                    reason?: string | undefined;
+                } | {
+                    type: "attached_trigger_discarded";
+                    positionId: string;
+                    positionKey: string;
+                    connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                    discarded: {
+                        bracketType: "STOP_LOSS" | "TAKE_PROFIT";
+                        metric: "price" | "ratio" | "weighted_ratio" | "funding_rate" | "prediction_market" | "btc_dominance" | "notional" | "upnl" | "upnl_bps" | "ratio_trailing" | "price_trailing" | "weighted_ratio_trailing" | "notional_trailing" | "upnl_trailing" | "upnl_bps_trailing";
+                        reason: "TRIGGER_LIMIT" | "TRAILING_ALREADY_EXISTS";
+                        level?: number | undefined;
+                    }[];
+                    activeTriggerLimit: number;
                 };
                 isRead: boolean;
                 createdAt: string;
@@ -1868,6 +2038,7 @@ declare class Core {
     };
     positions: {
         list: (query: HttpTypes.PositionListParamsInput, headers?: ClientHeaders) => Promise<{
+            limit: number;
             positions: {
                 id: string;
                 tradeAccountId: string;
@@ -1877,11 +2048,13 @@ declare class Core {
                 exposure: Record<string, `-${string}` | `+${string}`>;
                 totalFundingPayment: Record<string, `-${string}` | `+${string}`>;
                 initialExposureUSD: Record<string, `-${string}` | `+${string}`>;
+                entryPrices: Record<string, string>;
                 createdAt: string;
                 updatedAt: string;
                 closedReason?: "USER" | "NETTED" | "LIQUIDATED" | null | undefined;
                 closedAt?: string | null | undefined;
             }[];
+            nextCursor?: string | undefined;
         }>;
         openLite: (headers?: ClientHeaders) => Promise<{
             positions: {
@@ -2089,7 +2262,6 @@ declare class Core {
         auto: {
             list: (query?: HttpTypes.AutoRebalanceListParamsInput, headers?: ClientHeaders) => Promise<{
                 limit: number;
-                nextCursor: string | undefined;
                 items: {
                     id: string;
                     positionId: string;
@@ -2100,6 +2272,7 @@ declare class Core {
                     updatedAt: string;
                     timeframe?: "1d" | "1h" | "4h" | undefined;
                 }[];
+                nextCursor?: string | undefined;
             }>;
             create: (body: HttpTypes.CreateAutoRebalanceConfig, headers?: ClientHeaders) => Promise<{
                 config: {
@@ -2129,7 +2302,6 @@ declare class Core {
         };
         listEvents: (positionId: string, query?: HttpTypes.RebalanceEventListParamsInput, headers?: ClientHeaders) => Promise<{
             limit: number;
-            nextCursor: string | undefined;
             items: {
                 id: string;
                 autoRebalanceConfigId: string;
@@ -2142,6 +2314,7 @@ declare class Core {
                 createdAt: string;
                 error?: string | undefined;
             }[];
+            nextCursor?: string | undefined;
         }>;
     };
     savedBaskets: {
@@ -2201,7 +2374,6 @@ declare class Core {
     schedules: {
         list: (query: HttpTypes.ScheduleListParamsInput, headers?: ClientHeaders) => Promise<{
             limit: number;
-            nextCursor: string | undefined;
             schedules: ({
                 id: string;
                 connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
@@ -2297,6 +2469,7 @@ declare class Core {
                     } | undefined;
                 }[] | undefined;
             })[];
+            nextCursor?: string | undefined;
         }>;
         create: (body: HttpTypes.CreateSchedule, headers?: ClientHeaders) => Promise<{
             schedule: {
@@ -3153,7 +3326,6 @@ declare class Core {
     triggers: {
         list: (query: HttpTypes.TriggerListParamsInput, headers?: ClientHeaders) => Promise<{
             limit: number;
-            nextCursor: string | undefined;
             triggers: ({
                 id: string;
                 tradeAccountId: string;
@@ -3572,6 +3744,7 @@ declare class Core {
                     stopBreachedAt?: number | undefined;
                 } | undefined;
             })[];
+            nextCursor?: string | undefined;
         }>;
         open: (body: HttpTypes.CreateTriggerOpen, headers?: ClientHeaders) => Promise<{
             trigger: {
@@ -4485,6 +4658,14 @@ declare class Core {
                 openPositions: number;
             }[];
         }>;
+        totals: (query: HttpTypes.StatisticsTotalsQueryParamsInput, headers?: ClientHeaders) => Promise<{
+            data: {
+                totalVolume: number;
+                totalFees: number;
+                totalTrades: number;
+                totalUsers: number;
+            };
+        }>;
     };
     tca: {
         execution: (executionId: string, headers?: ClientHeaders) => Promise<{

package/dist/core/index.js

@@ -83,6 +83,12 @@ class Core {
         headers,
         query
       });
+    },
+    get: async (id, headers) => {
+      return await this.client.fetch(`/executions/${id}`, {
+        method: "GET",
+        headers
+      });
     }
   };
   fills = {
@@ -575,6 +581,13 @@ class Core {
         headers,
         query
       });
+    },
+    totals: async (query, headers) => {
+      return await this.client.fetch(`/statistics/totals`, {
+        method: "GET",
+        headers,
+        query
+      });
     }
   };
   tca = {

package/dist/external/kalshi.js

@@ -1,3 +1,5 @@
+import { proxyFetch } from '@pear-protocol/utils';
+
 const BASE_URL = "https://api.elections.kalshi.com";
 const BATCH_SIZE = 100;
 async function fetchKalshiMarketNames(tickers) {
@@ -7,7 +9,7 @@ async function fetchKalshiMarketNames(tickers) {
     const url = new URL(`${BASE_URL}/trade-api/v2/markets`);
     url.searchParams.set("tickers", batch.join(","));
     url.searchParams.set("limit", String(BATCH_SIZE));
-    const response = await fetch(url, { method: "GET", headers: { accept: "application/json" } });
+    const response = await proxyFetch(url, { method: "GET", headers: { accept: "application/json" } });
     if (!response.ok) throw new Error(`Kalshi API error: ${response.status} ${response.statusText}`);
     const data = await response.json();
     for (const m of data.markets ?? []) result.set(m.ticker, m.title);
@@ -22,7 +24,7 @@ async function searchKalshiTriggers(params = {}) {
   if (params.category) url.searchParams.set("category", params.category);
   if (params.search) url.searchParams.set("query", params.search);
   if (params.cursor) url.searchParams.set("cursor", params.cursor);
-  const response = await fetch(url, { method: "GET", headers: { accept: "application/json" } });
+  const response = await proxyFetch(url, { method: "GET", headers: { accept: "application/json" } });
   if (!response.ok) return { triggers: [], nextCursor: null };
   const data = await response.json();
   return {

package/dist/external/polymarket.js

@@ -1,3 +1,5 @@
+import { proxyFetch } from '@pear-protocol/utils';
+
 const BASE_URL = "https://gamma-api.polymarket.com";
 const BATCH_SIZE = 100;
 async function fetchPolymarketMarketNames(ids) {
@@ -7,7 +9,7 @@ async function fetchPolymarketMarketNames(ids) {
     const url = new URL(`${BASE_URL}/markets`);
     for (const id of batch) url.searchParams.append("id", id);
     url.searchParams.set("limit", String(BATCH_SIZE));
-    const response = await fetch(url, { method: "GET", headers: { accept: "application/json" } });
+    const response = await proxyFetch(url, { method: "GET", headers: { accept: "application/json" } });
     if (!response.ok) throw new Error(`Polymarket API error: ${response.status} ${response.statusText}`);
     const data = await response.json();
     for (const m of data) result.set(m.id, m.question ?? m.groupItemTitle ?? "");
@@ -23,7 +25,7 @@ async function searchPolymarketTriggers(params = {}) {
   if (params.search) url.searchParams.set("title_search", params.search);
   if (params.category) url.searchParams.set("tag_slug", params.category);
   if (params.cursor) url.searchParams.set("after_cursor", params.cursor);
-  const response = await fetch(url, { method: "GET", headers: { accept: "application/json" } });
+  const response = await proxyFetch(url, { method: "GET", headers: { accept: "application/json" } });
   if (!response.ok) return { triggers: [], nextCursor: null };
   const data = await response.json();
   const events = data.events ?? [];

package/dist/http.d.ts

@@ -1,5 +1,6 @@
 import { AuthMode, Logger, RequestMiddleware, ResponseMiddleware, FetchInput, FetchArgs } from './types.js';
 import '@pear-protocol/types';
+import '@pear-protocol/utils';
 
 declare class HttpClient {
     private baseUrl;

package/dist/index.d.ts

@@ -5,6 +5,7 @@ import { External } from './external/index.js';
 import { SDKConfig } from './types.js';
 export { ExternalTrigger, ExternalTriggerSource, HttpTypes, SearchTriggersParams, SearchTriggersResponse, TriggerOutcome } from '@pear-protocol/types';
 export * from '@pear-protocol/utils';
+export { FetchError } from './utils.js';
 import './http.js';
 
 declare class PearSDK {

package/dist/index.js

@@ -1,3 +1,5 @@
+import { configureProxy } from '@pear-protocol/utils';
+export * from '@pear-protocol/utils';
 import { Admin } from './admin';
 import { Auth } from './auth';
 import { Core } from './core';
@@ -5,7 +7,7 @@ import { External } from './external';
 export { External } from './external';
 import { HttpClient } from './http';
 import { FetchError } from './utils';
-export * from '@pear-protocol/utils';
+export { FetchError } from './utils';
 
 const SESSION_REFRESH_PATH = "/auth/session/refresh";
 const SESSION_REFRESH_TIMEOUT_MS = 15e3;
@@ -35,6 +37,7 @@ class PearSDK {
   core;
   external;
   constructor(config) {
+    if (config.proxy) configureProxy(config.proxy);
     const authMode = config.auth?.type ?? "session";
     const logger = config.logger ?? {
       error: console.error,

package/dist/types.d.ts

@@ -1,4 +1,5 @@
 import { HttpTypes } from '@pear-protocol/types';
+import { ProxyConfig } from '@pear-protocol/utils';
 
 type AuthMode = 'session' | 'bearer' | 'apikey';
 type SDKConfig = {
@@ -88,6 +89,14 @@ type SDKConfig = {
      * Example: true
      */
     debug?: boolean;
+    /**
+     * Optional forward-proxy for the SDK's external HTTP calls (prediction-market data). When
+     * enabled, requests are re-pointed at `proxy.url` with the original host in `X-Proxy-Target`.
+     * Injected here because the SDK also runs in the browser, where env vars are unavailable.
+     *
+     * Example: { enabled: true, url: 'http://proxy.internal:8080' }
+     */
+    proxy?: ProxyConfig;
 };
 type Logger = {
     error: (...messages: string[]) => void;

package/dist/utils.d.ts

@@ -1,5 +1,6 @@
 import { FetchArgs, AuthMode } from './types.js';
 import '@pear-protocol/types';
+import '@pear-protocol/utils';
 
 declare function getBaseUrl(passedBaseUrl: string): string;
 declare function normalizeRequest(init: FetchArgs | undefined, headers: Headers, authMode: AuthMode): RequestInit | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pear-protocol/core-sdk",
-  "version": "1.5.0",
+  "version": "1.7.0",
   "description": "Pear Protocol Core SDK",
   "private": false,
   "type": "module",
@@ -27,8 +27,8 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@pear-protocol/types": "^1.6.0",
-    "@pear-protocol/utils": "^0.1.0",
+    "@pear-protocol/types": "^1.9.0",
+    "@pear-protocol/utils": "^0.2.0",
     "qs": "^6.14.0"
   },
   "devDependencies": {