@pear-protocol/core-sdk 0.0.24 → 1.0.0

package/dist/core/index.js

@@ -1,7 +1,16 @@
 class Core {
   client;
-  constructor(client) {
+  clientId;
+  constructor(client, clientId) {
     this.client = client;
+    this.clientId = clientId;
+  }
+  // Auto-attach the configured attribution clientId to a request body unless the
+  // caller already set one explicitly. Bound to the exact trade / trigger / schedule /
+  // rebalance payloads it serves, so an unrelated body is a compile error.
+  withClientId(body) {
+    if (!this.clientId) return body;
+    return { clientId: this.clientId, ...body };
   }
   accounts = {
     list: async (query, headers) => {
@@ -33,7 +42,7 @@ class Core {
     },
     credentials: async (id, headers) => {
       return await this.client.fetch(`/trade-accounts/${id}/credentials`, {
-        method: "GET",
+        method: "POST",
         headers
       });
     },
@@ -44,6 +53,27 @@ class Core {
       });
     }
   };
+  apiKeys = {
+    list: async (headers) => {
+      return await this.client.fetch(`/api-keys`, {
+        method: "GET",
+        headers
+      });
+    },
+    create: async (body, headers) => {
+      return await this.client.fetch(`/api-keys`, {
+        method: "POST",
+        headers,
+        body
+      });
+    },
+    revoke: async (id, headers) => {
+      return await this.client.fetch(`/api-keys/${id}`, {
+        method: "DELETE",
+        headers
+      });
+    }
+  };
   executions = {
     list: async (query, headers) => {
       return await this.client.fetch(`/executions`, {
@@ -99,6 +129,30 @@ class Core {
       });
     }
   };
+  markets = {
+    list: async (query, headers) => {
+      return await this.client.fetch(`/markets`, {
+        method: "GET",
+        headers,
+        query
+      });
+    },
+    baskets: async (query, headers) => {
+      return await this.client.fetch(`/markets/baskets`, {
+        method: "GET",
+        headers,
+        query
+      });
+    }
+  };
+  oracle = {
+    btcdom: async (headers) => {
+      return await this.client.fetch(`/oracle/btcdom`, {
+        method: "GET",
+        headers
+      });
+    }
+  };
   positions = {
     list: async (query, headers) => {
       return await this.client.fetch(`/positions`, {
@@ -114,6 +168,22 @@ class Core {
       });
     }
   };
+  portfolio = {
+    overview: async (query, headers) => {
+      return await this.client.fetch(`/portfolio`, {
+        method: "GET",
+        headers,
+        query
+      });
+    },
+    analytics: async (query, headers) => {
+      return await this.client.fetch(`/portfolio/analytics`, {
+        method: "GET",
+        headers,
+        query
+      });
+    }
+  };
   prices = {
     list: async (query, headers) => {
       return await this.client.fetch(`/prices`, {
@@ -128,7 +198,7 @@ class Core {
       return await this.client.fetch(`/rebalance/manually/${positionId}`, {
         method: "POST",
         headers,
-        body
+        body: this.withClientId(body)
       });
     }
   };
@@ -144,7 +214,7 @@ class Core {
       return await this.client.fetch(`/schedules`, {
         method: "POST",
         headers,
-        body
+        body: this.withClientId(body)
       });
     },
     cancel: async (scheduleId, headers) => {
@@ -195,28 +265,28 @@ class Core {
       return await this.client.fetch(`/trade/open`, {
         method: "POST",
         headers,
-        body
+        body: this.withClientId(body)
       });
     },
     adjust: async (positionId, body, headers) => {
       return await this.client.fetch(`/trade/${positionId}/adjust`, {
         method: "POST",
         headers,
-        body
+        body: this.withClientId(body)
       });
     },
     close: async (positionId, body, headers) => {
       return await this.client.fetch(`/trade/${positionId}/close`, {
         method: "POST",
         headers,
-        body
+        body: this.withClientId(body)
       });
     },
     closeAll: async (body, headers) => {
       return await this.client.fetch(`/trade/close-all`, {
         method: "POST",
         headers,
-        body
+        body: this.withClientId(body)
       });
     },
     setLeverage: async (body, headers) => {
@@ -239,14 +309,14 @@ class Core {
       return await this.client.fetch(`/triggers/open`, {
         method: "POST",
         headers,
-        body
+        body: this.withClientId(body)
       });
     },
     close: async (body, headers) => {
       return await this.client.fetch(`/triggers/close`, {
         method: "POST",
         headers,
-        body
+        body: this.withClientId(body)
       });
     },
     cancel: async (triggerId, headers) => {
@@ -345,6 +415,28 @@ class Core {
       });
     }
   };
+  tca = {
+    execution: async (executionId, headers) => {
+      return await this.client.fetch(`/tca/executions/${executionId}`, {
+        method: "GET",
+        headers
+      });
+    },
+    position: async (positionId, query, headers) => {
+      return await this.client.fetch(`/tca/positions/${positionId}`, {
+        method: "GET",
+        headers,
+        query
+      });
+    },
+    summary: async (query, headers) => {
+      return await this.client.fetch(`/tca/summary`, {
+        method: "GET",
+        headers,
+        query
+      });
+    }
+  };
 }
 
 export { Core };

package/dist/external/index.d.ts

@@ -0,0 +1,17 @@
+import { SearchTriggersParams, SearchTriggersResponse } from '@pear-protocol/types';
+export { ExternalTrigger, ExternalTriggerSource, SearchTriggersParams, SearchTriggersResponse, TriggerOutcome } from '@pear-protocol/types';
+
+declare class External {
+    triggers: {
+        kalshi: {
+            marketNames: (tickers: string[]) => Promise<Map<string, string>>;
+            search: (params?: SearchTriggersParams) => Promise<SearchTriggersResponse>;
+        };
+        polymarket: {
+            marketNames: (ids: string[]) => Promise<Map<string, string>>;
+            search: (params?: SearchTriggersParams) => Promise<SearchTriggersResponse>;
+        };
+    };
+}
+
+export { External };

package/dist/external/index.js

@@ -0,0 +1,25 @@
+import { searchKalshiTriggers, fetchKalshiMarketNames } from './kalshi';
+import { searchPolymarketTriggers, fetchPolymarketMarketNames } from './polymarket';
+
+class External {
+  triggers = {
+    kalshi: {
+      marketNames: async (tickers) => {
+        return fetchKalshiMarketNames(tickers);
+      },
+      search: async (params = {}) => {
+        return searchKalshiTriggers(params);
+      }
+    },
+    polymarket: {
+      marketNames: async (ids) => {
+        return fetchPolymarketMarketNames(ids);
+      },
+      search: async (params = {}) => {
+        return searchPolymarketTriggers(params);
+      }
+    }
+  };
+}
+
+export { External };

package/dist/external/kalshi.d.ts

@@ -0,0 +1,6 @@
+import { SearchTriggersParams, SearchTriggersResponse } from '@pear-protocol/types';
+
+declare function fetchKalshiMarketNames(tickers: string[]): Promise<Map<string, string>>;
+declare function searchKalshiTriggers(params?: SearchTriggersParams): Promise<SearchTriggersResponse>;
+
+export { fetchKalshiMarketNames, searchKalshiTriggers };

package/dist/external/kalshi.js

@@ -0,0 +1,69 @@
+const BASE_URL = "https://api.elections.kalshi.com";
+const BATCH_SIZE = 100;
+async function fetchKalshiMarketNames(tickers) {
+  const result = /* @__PURE__ */ new Map();
+  for (let i = 0; i < tickers.length; i += BATCH_SIZE) {
+    const batch = tickers.slice(i, i + BATCH_SIZE);
+    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" } });
+    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);
+  }
+  return result;
+}
+async function searchKalshiTriggers(params = {}) {
+  const url = new URL(`${BASE_URL}/v1/search/series`);
+  url.searchParams.set("order_by", "trending");
+  url.searchParams.set("status", "open");
+  url.searchParams.set("page_size", String(params.pageSize ?? 50));
+  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" } });
+  if (!response.ok) return { triggers: [], nextCursor: null };
+  const data = await response.json();
+  return {
+    triggers: (data.current_page ?? []).map(mapEventToTrigger),
+    nextCursor: data.next_cursor || null
+  };
+}
+function mapEventToTrigger(event) {
+  const imageUrl = `https://kalshi-public-docs.s3.amazonaws.com/series-images-webp/${event.event_ticker.split("-")[0]}.webp`;
+  if (event.markets.length > 1) {
+    return {
+      id: event.event_ticker,
+      category: "prediction_market",
+      source: "kalshi",
+      selectable: false,
+      oracle: null,
+      options: event.markets.map(mapMarketToOutcome),
+      type: "multi",
+      title: event.event_title,
+      imageUrl
+    };
+  }
+  const market = event.markets[0];
+  return {
+    id: market?.ticker ?? event.event_ticker,
+    category: "prediction_market",
+    source: "kalshi",
+    selectable: true,
+    oracle: market?.last_price ?? null,
+    options: [],
+    type: "binary",
+    title: event.event_title,
+    imageUrl
+  };
+}
+function mapMarketToOutcome(market) {
+  return {
+    id: market.ticker,
+    label: market.yes_subtitle || market.title,
+    oracle: market.last_price
+  };
+}
+
+export { fetchKalshiMarketNames, searchKalshiTriggers };

package/dist/external/polymarket.d.ts

@@ -0,0 +1,6 @@
+import { SearchTriggersParams, SearchTriggersResponse } from '@pear-protocol/types';
+
+declare function fetchPolymarketMarketNames(ids: string[]): Promise<Map<string, string>>;
+declare function searchPolymarketTriggers(params?: SearchTriggersParams): Promise<SearchTriggersResponse>;
+
+export { fetchPolymarketMarketNames, searchPolymarketTriggers };

package/dist/external/polymarket.js

@@ -0,0 +1,91 @@
+const BASE_URL = "https://gamma-api.polymarket.com";
+const BATCH_SIZE = 100;
+async function fetchPolymarketMarketNames(ids) {
+  const result = /* @__PURE__ */ new Map();
+  for (let i = 0; i < ids.length; i += BATCH_SIZE) {
+    const batch = ids.slice(i, i + BATCH_SIZE);
+    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" } });
+    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 ?? "");
+  }
+  return result;
+}
+async function searchPolymarketTriggers(params = {}) {
+  const url = new URL(`${BASE_URL}/events/keyset`);
+  url.searchParams.set("closed", "false");
+  url.searchParams.set("limit", String(params.pageSize ?? 50));
+  url.searchParams.set("order", "volume24hr");
+  url.searchParams.set("ascending", "false");
+  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" } });
+  if (!response.ok) return { triggers: [], nextCursor: null };
+  const data = await response.json();
+  const events = data.events ?? [];
+  return {
+    triggers: events.map(mapEventToTrigger).filter((t) => t !== null),
+    nextCursor: data.next_cursor ?? null
+  };
+}
+function mapEventToTrigger(event) {
+  const markets = (event.markets ?? []).filter((m) => m.active !== false && m.closed !== true);
+  const [first] = markets;
+  if (!first) return null;
+  if (markets.length === 1) {
+    return {
+      id: first.id,
+      category: "prediction_market",
+      source: "polymarket",
+      selectable: true,
+      oracle: parseYesCents(first),
+      options: [],
+      type: "binary",
+      title: first.question ?? event.title ?? first.groupItemTitle ?? first.id,
+      imageUrl: first.image ?? first.icon ?? event.image ?? event.icon ?? null
+    };
+  }
+  return {
+    id: event.id ?? event.slug ?? first.id,
+    category: "prediction_market",
+    source: "polymarket",
+    selectable: false,
+    oracle: null,
+    options: markets.map(mapMarketToOutcome),
+    type: "multi",
+    title: event.title ?? first.question ?? event.id,
+    imageUrl: event.image ?? event.icon ?? first.image ?? first.icon ?? null
+  };
+}
+function mapMarketToOutcome(market) {
+  return {
+    id: market.id,
+    label: market.groupItemTitle ?? market.question ?? market.id,
+    oracle: parseYesCents(market)
+  };
+}
+function parseYesCents(market) {
+  const outcomes = parseStringArray(market.outcomes);
+  const prices = parseStringArray(market.outcomePrices);
+  const yesIndex = outcomes.findIndex((o) => o.toLowerCase() === "yes");
+  if (yesIndex < 0) return null;
+  const price = Number(prices[yesIndex] ?? "");
+  if (!Number.isFinite(price)) return null;
+  return Math.round(price * 1e4) / 100;
+}
+function parseStringArray(value) {
+  if (Array.isArray(value)) return value.map(String);
+  if (!value) return [];
+  try {
+    const parsed = JSON.parse(value);
+    return Array.isArray(parsed) ? parsed.map(String) : [];
+  } catch {
+    return [];
+  }
+}
+
+export { fetchPolymarketMarketNames, searchPolymarketTriggers };

package/dist/external/types.d.ts

@@ -0,0 +1,49 @@
+export { ExternalTrigger, ExternalTriggerSource, SearchTriggersParams, SearchTriggersResponse, TriggerOutcome } from '@pear-protocol/types';
+
+type KalshiMarket = {
+    ticker: string;
+    title: string;
+};
+type KalshiMarketsResponse = {
+    markets: KalshiMarket[];
+};
+type KalshiSearchSeriesMarket = {
+    ticker: string;
+    yes_subtitle: string;
+    last_price: number;
+    title: string;
+};
+type KalshiSearchSeriesEvent = {
+    event_ticker: string;
+    event_title: string;
+    markets: KalshiSearchSeriesMarket[];
+};
+type KalshiSearchSeriesResponse = {
+    current_page: KalshiSearchSeriesEvent[];
+    next_cursor: string;
+};
+type PolymarketMarket = {
+    id: string;
+    question?: string;
+    image?: string;
+    icon?: string;
+    active?: boolean;
+    closed?: boolean;
+    groupItemTitle?: string;
+    outcomes?: string[] | string;
+    outcomePrices?: string[] | string;
+};
+type PolymarketEvent = {
+    id: string;
+    slug?: string;
+    title?: string;
+    image?: string;
+    icon?: string;
+    markets?: PolymarketMarket[];
+};
+type PolymarketKeysetEventsResponse = {
+    events?: PolymarketEvent[];
+    next_cursor?: string | null;
+};
+
+export type { KalshiMarket, KalshiMarketsResponse, KalshiSearchSeriesEvent, KalshiSearchSeriesMarket, KalshiSearchSeriesResponse, PolymarketEvent, PolymarketKeysetEventsResponse, PolymarketMarket };

package/dist/external/types.js

@@ -0,0 +1 @@
+

package/dist/http.d.ts

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

package/dist/index.d.ts

@@ -1,14 +1,18 @@
+import { Admin } from './admin/index.js';
 import { Auth } from './auth/index.js';
 import { Core } from './core/index.js';
+import { External } from './external/index.js';
 import { SDKConfig } from './types.js';
-export { HttpTypes } from '@pear-protocol/types';
+export { ExternalTrigger, ExternalTriggerSource, HttpTypes, SearchTriggersParams, SearchTriggersResponse, TriggerOutcome } from '@pear-protocol/types';
 export * from '@pear-protocol/utils';
 import './http.js';
 
 declare class PearSDK {
+    admin: Admin;
     auth: Auth;
     core: Core;
+    external: External;
     constructor(config: SDKConfig);
 }
 
-export { PearSDK as default };
+export { External, PearSDK as default };

package/dist/index.js

@@ -1,12 +1,17 @@
+import { Admin } from './admin';
 import { Auth } from './auth';
 import { Core } from './core';
+import { External } from './external';
+export { External } from './external';
 import { HttpClient } from './http';
 import { FetchError } from './utils';
 export * from '@pear-protocol/utils';
 
 class PearSDK {
+  admin;
   auth;
   core;
+  external;
   constructor(config) {
     const authMode = config.auth?.type ?? "session";
     const logger = config.logger ?? {
@@ -17,8 +22,10 @@ class PearSDK {
       }
     };
     const client = new HttpClient(config.url, authMode, config.logger, config.debug);
+    this.admin = new Admin(client);
     this.auth = new Auth(client);
     this.core = new Core(client);
+    this.external = new External();
     if (authMode === "session") {
       let refreshInFlight = null;
       const refreshSession = async () => {
@@ -70,6 +77,26 @@ class PearSDK {
         });
       }
     }
+    if (authMode === "apikey" && config.auth?.key) {
+      const getKey = config.auth.key;
+      client.useRequest(async (request, next) => {
+        const key = getKey();
+        if (key) {
+          request.headers.set("x-api-key", key);
+        }
+        return next();
+      });
+      if (config.onAuthError) {
+        const onAuthError = config.onAuthError;
+        client.useResponse(async (response) => {
+          if (response.status === 401) {
+            onAuthError();
+            throw new FetchError("Unauthorized. API key may be expired or revoked.", "Unauthorized", 401);
+          }
+          return response;
+        });
+      }
+    }
     if (config.getTradeAccountId) {
       const getTradeAccountId = config.getTradeAccountId;
       client.useRequest(async (request, next) => {

package/dist/types.d.ts

@@ -1,4 +1,6 @@
-type AuthMode = 'session' | 'bearer';
+import { HttpTypes } from '@pear-protocol/types';
+
+type AuthMode = 'session' | 'bearer' | 'apikey';
 type SDKConfig = {
     /**
      * API endpoint.
@@ -16,17 +18,28 @@ type SDKConfig = {
      *
      * Bearer:
      * Token set on every request via `Authorization` header. Provide
-     * `token` getter to supply the API key or JWT. No client-side refresh.
-     * If 401, caller handles re-auth. Used by headless / API-key clients.
+     * `token` getter to supply the JWT. No client-side refresh.
+     * If 401, caller handles re-auth. Used by headless JWT clients.
+     *
+     * Apikey:
+     * API key sent on every request via the `x-api-key` header. Provide
+     * `key` getter. No cookies, no client-side refresh. If 401, caller
+     * handles re-auth. Used by programmatic API-key clients.
      */
     auth?: {
         type: AuthMode;
         /**
-         * Token getter for bearer mode (e.g. () => apiKey). Ignored in session mode.
+         * Token getter for bearer mode (e.g. () => jwt). Ignored in other modes.
          *
-         * Example: () => localStorage.getItem('apiKey')
+         * Example: () => localStorage.getItem('accessToken')
          */
         token?: () => string | null;
+        /**
+         * API key getter for apikey mode. Ignored in other modes.
+         *
+         * Example: () => localStorage.getItem('apiKey')
+         */
+        key?: () => string | null;
     };
     /**
      * Trade account ID getter (used in both modes)
@@ -35,7 +48,16 @@ type SDKConfig = {
      */
     getTradeAccountId?: () => string | null;
     /**
-     * Called when server returns 401 (bearer mode only).
+     * Default attribution client code (client_ids.code). When set, it is
+     * auto-added to the body of trade / trigger / schedule / rebalance requests
+     * unless the call already specifies its own `clientId`. `null`/omitted →
+     * nothing is added.
+     *
+     * Example: 'AGENTPEAR'
+     */
+    clientId?: string | null;
+    /**
+     * Called when server returns 401 (bearer / apikey mode).
      *
      * Example: () => {
      *   console.error('Unauthorized. Token may be expired or revoked.');
@@ -89,5 +111,6 @@ type FetchArgs = Omit<RequestInit, 'headers' | 'body'> & {
 };
 type RequestMiddleware = (request: Request, next: () => Promise<Response>) => Promise<Response>;
 type ResponseMiddleware = (response: Response, retry: () => Promise<Response>, request: Request) => Promise<Response>;
+type ClientIdBody = HttpTypes.RebalanceManually | HttpTypes.CreateSchedule | HttpTypes.CreateTradeOpen | HttpTypes.CreateTradeAdjust | HttpTypes.CreateTradeClose | HttpTypes.CreateTradeCloseAll | HttpTypes.CreateTriggerOpen | HttpTypes.CreateTriggerClose;
 
-export type { AuthMode, ClientHeaders, FetchArgs, FetchInput, FetchParams, Logger, RequestMiddleware, ResponseMiddleware, SDKConfig };
+export type { AuthMode, ClientHeaders, ClientIdBody, FetchArgs, FetchInput, FetchParams, Logger, RequestMiddleware, ResponseMiddleware, SDKConfig };

package/dist/utils.d.ts

@@ -1,4 +1,5 @@
 import { FetchArgs, AuthMode } from './types.js';
+import '@pear-protocol/types';
 
 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": "0.0.24",
+  "version": "1.0.0",
   "description": "Pear Protocol Core SDK",
   "private": false,
   "type": "module",
@@ -25,8 +25,8 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@pear-protocol/types": "^0.0.21",
-    "@pear-protocol/utils": "^0.0.21",
+    "@pear-protocol/types": "^1.0.0",
+    "@pear-protocol/utils": "^0.0.23",
     "qs": "^6.14.0"
   },
   "devDependencies": {