@pear-protocol/core-sdk 0.1.0 → 1.1.0

package/dist/auth/index.d.ts

@@ -30,6 +30,12 @@ declare class Auth {
         providerId: string | null;
         loginMethod: "email" | "evm_wallet";
     }>;
+    apiKeyMe(headers?: ClientHeaders): Promise<{
+        id: string;
+        role: "basic" | "pro" | "admin";
+        scope: "read" | "read_write";
+        authMethod: "api_key";
+    }>;
     refreshSession(headers?: ClientHeaders): Promise<void>;
     refreshToken(body: HttpTypes.RefreshTokenRequest, headers?: ClientHeaders): Promise<{
         accessToken: string;

package/dist/auth/index.js

@@ -50,6 +50,13 @@ class Auth {
       headers
     });
   }
+  // Resolve the identity behind an API key (x-api-key auth). Session-less counterpart to `me`.
+  async apiKeyMe(headers) {
+    return await this.client.fetch(`/auth/api-key/me`, {
+      method: "GET",
+      headers
+    });
+  }
   async refreshSession(headers) {
     return await this.client.fetch(`/auth/session/refresh`, {
       method: "POST",

package/dist/core/index.d.ts

@@ -4,7 +4,9 @@ import { ClientHeaders } from '../types.js';
 
 declare class Core {
     private client;
-    constructor(client: HttpClient);
+    private clientId?;
+    constructor(client: HttpClient, clientId?: string | null);
+    private withClientId;
     accounts: {
         list: (query?: HttpTypes.TradeAccountListParamsInput, headers?: ClientHeaders) => Promise<{
             accounts: {
@@ -180,6 +182,25 @@ declare class Core {
         }>;
         restore: (id: string, headers?: ClientHeaders) => Promise<void>;
     };
+    apiKeys: {
+        list: (headers?: ClientHeaders) => Promise<{
+            id: string;
+            label: string;
+            scope: "read" | "read_write";
+            keyPrefix: string;
+            lastUsedAt: string | null;
+            expiresAt: string | null;
+            revokedAt: string | null;
+            createdAt: string;
+        }[]>;
+        create: (body: HttpTypes.CreateApiKeyInput, headers?: ClientHeaders) => Promise<{
+            id: string;
+            label: string;
+            scope: "read" | "read_write";
+            key: string;
+        }>;
+        revoke: (id: string, headers?: ClientHeaders) => Promise<void>;
+    };
     executions: {
         list: (query: HttpTypes.ExecutionListParamsInput, headers?: ClientHeaders) => Promise<{
             limit: number;
@@ -456,6 +477,54 @@ declare class Core {
             }[];
         }>;
     };
+    notifications: {
+        list: (query?: HttpTypes.NotificationListParamsInput, headers?: ClientHeaders) => Promise<{
+            notifications: {
+                id: string;
+                category: "TAKE_PROFIT_HIT" | "STOP_LOSS_HIT" | "TRIGGER_ORDER_HIT";
+                parameters: {
+                    type: "take_profit";
+                    triggerId: string;
+                    positionId: string;
+                    connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                } | {
+                    type: "stop_loss";
+                    triggerId: string;
+                    positionId: string;
+                    connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                } | {
+                    type: "trigger_order";
+                    triggerId: string;
+                    positionId: string;
+                    connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                } | {
+                    type: "default_trigger";
+                    triggerId: string;
+                    connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                };
+                isRead: boolean;
+                createdAt: string;
+                updatedAt: string;
+            }[];
+        }>;
+        markRead: (body: HttpTypes.MarkNotificationsReadPayloadInput, headers?: ClientHeaders) => Promise<{
+            updated: number;
+        }>;
+        markUnread: (body: HttpTypes.MarkNotificationUnreadPayloadInput, headers?: ClientHeaders) => Promise<{
+            updated: number;
+        }>;
+    };
+    oracle: {
+        btcdom: (headers?: ClientHeaders) => Promise<{
+            id: string;
+            category: "btcdom";
+            source: "coingecko";
+            oracle: {
+                value: number;
+                unit: "cent" | "percent";
+            } | null;
+        }>;
+    };
     positions: {
         list: (query: HttpTypes.PositionListParamsInput, headers?: ClientHeaders) => Promise<{
             positions: {
@@ -1385,6 +1454,29 @@ declare class Core {
                         track: "PEAK" | "TROUGH";
                         threshold: number;
                     };
+                } | {
+                    type: "funding_rate";
+                    data: {
+                        connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                        symbol: string;
+                        track: "PEAK" | "TROUGH";
+                        threshold: number;
+                    };
+                } | {
+                    type: "prediction_market";
+                    data: {
+                        source: "kalshi" | "polymarket";
+                        marketKey: string;
+                        track: "PEAK" | "TROUGH";
+                        threshold: number;
+                    };
+                } | {
+                    type: "btc_dominance";
+                    data: {
+                        source: "coingecko";
+                        track: "PEAK" | "TROUGH";
+                        threshold: number;
+                    };
                 };
                 context: {
                     type: "MARKET";
@@ -1486,6 +1578,29 @@ declare class Core {
                         track: "PEAK" | "TROUGH";
                         threshold: number;
                     };
+                } | {
+                    type: "funding_rate";
+                    data: {
+                        connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                        symbol: string;
+                        track: "PEAK" | "TROUGH";
+                        threshold: number;
+                    };
+                } | {
+                    type: "prediction_market";
+                    data: {
+                        source: "kalshi" | "polymarket";
+                        marketKey: string;
+                        track: "PEAK" | "TROUGH";
+                        threshold: number;
+                    };
+                } | {
+                    type: "btc_dominance";
+                    data: {
+                        source: "coingecko";
+                        track: "PEAK" | "TROUGH";
+                        threshold: number;
+                    };
                 };
                 context: {
                     type: "MARKET";
@@ -1639,6 +1754,29 @@ declare class Core {
                     data: {
                         priceSource: "mark" | "mid";
                     };
+                } | {
+                    type: "funding_rate";
+                    data: {
+                        connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                        symbol: string;
+                        track: "PEAK" | "TROUGH";
+                        threshold: number;
+                    };
+                } | {
+                    type: "prediction_market";
+                    data: {
+                        source: "kalshi" | "polymarket";
+                        marketKey: string;
+                        track: "PEAK" | "TROUGH";
+                        threshold: number;
+                    };
+                } | {
+                    type: "btc_dominance";
+                    data: {
+                        source: "coingecko";
+                        track: "PEAK" | "TROUGH";
+                        threshold: number;
+                    };
                 };
                 context: {
                     type: "MARKET";
@@ -1723,6 +1861,29 @@ declare class Core {
                         track: "PEAK" | "TROUGH";
                         threshold: number;
                     };
+                } | {
+                    type: "funding_rate";
+                    data: {
+                        connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                        symbol: string;
+                        track: "PEAK" | "TROUGH";
+                        threshold: number;
+                    };
+                } | {
+                    type: "prediction_market";
+                    data: {
+                        source: "kalshi" | "polymarket";
+                        marketKey: string;
+                        track: "PEAK" | "TROUGH";
+                        threshold: number;
+                    };
+                } | {
+                    type: "btc_dominance";
+                    data: {
+                        source: "coingecko";
+                        track: "PEAK" | "TROUGH";
+                        threshold: number;
+                    };
                 };
                 context: {
                     type: "MARKET";
@@ -1824,6 +1985,29 @@ declare class Core {
                         track: "PEAK" | "TROUGH";
                         threshold: number;
                     };
+                } | {
+                    type: "funding_rate";
+                    data: {
+                        connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                        symbol: string;
+                        track: "PEAK" | "TROUGH";
+                        threshold: number;
+                    };
+                } | {
+                    type: "prediction_market";
+                    data: {
+                        source: "kalshi" | "polymarket";
+                        marketKey: string;
+                        track: "PEAK" | "TROUGH";
+                        threshold: number;
+                    };
+                } | {
+                    type: "btc_dominance";
+                    data: {
+                        source: "coingecko";
+                        track: "PEAK" | "TROUGH";
+                        threshold: number;
+                    };
                 };
                 context: {
                     type: "MARKET";
@@ -1977,6 +2161,29 @@ declare class Core {
                     data: {
                         priceSource: "mark" | "mid";
                     };
+                } | {
+                    type: "funding_rate";
+                    data: {
+                        connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                        symbol: string;
+                        track: "PEAK" | "TROUGH";
+                        threshold: number;
+                    };
+                } | {
+                    type: "prediction_market";
+                    data: {
+                        source: "kalshi" | "polymarket";
+                        marketKey: string;
+                        track: "PEAK" | "TROUGH";
+                        threshold: number;
+                    };
+                } | {
+                    type: "btc_dominance";
+                    data: {
+                        source: "coingecko";
+                        track: "PEAK" | "TROUGH";
+                        threshold: number;
+                    };
                 };
                 context: {
                     type: "MARKET";
@@ -2061,6 +2268,29 @@ declare class Core {
                         track: "PEAK" | "TROUGH";
                         threshold: number;
                     };
+                } | {
+                    type: "funding_rate";
+                    data: {
+                        connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                        symbol: string;
+                        track: "PEAK" | "TROUGH";
+                        threshold: number;
+                    };
+                } | {
+                    type: "prediction_market";
+                    data: {
+                        source: "kalshi" | "polymarket";
+                        marketKey: string;
+                        track: "PEAK" | "TROUGH";
+                        threshold: number;
+                    };
+                } | {
+                    type: "btc_dominance";
+                    data: {
+                        source: "coingecko";
+                        track: "PEAK" | "TROUGH";
+                        threshold: number;
+                    };
                 };
                 context: {
                     type: "MARKET";
@@ -2162,6 +2392,29 @@ declare class Core {
                         track: "PEAK" | "TROUGH";
                         threshold: number;
                     };
+                } | {
+                    type: "funding_rate";
+                    data: {
+                        connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                        symbol: string;
+                        track: "PEAK" | "TROUGH";
+                        threshold: number;
+                    };
+                } | {
+                    type: "prediction_market";
+                    data: {
+                        source: "kalshi" | "polymarket";
+                        marketKey: string;
+                        track: "PEAK" | "TROUGH";
+                        threshold: number;
+                    };
+                } | {
+                    type: "btc_dominance";
+                    data: {
+                        source: "coingecko";
+                        track: "PEAK" | "TROUGH";
+                        threshold: number;
+                    };
                 };
                 context: {
                     type: "MARKET";
@@ -2315,6 +2568,29 @@ declare class Core {
                     data: {
                         priceSource: "mark" | "mid";
                     };
+                } | {
+                    type: "funding_rate";
+                    data: {
+                        connector: "hyperliquid" | "binance" | "bybit" | "okx" | "lighter";
+                        symbol: string;
+                        track: "PEAK" | "TROUGH";
+                        threshold: number;
+                    };
+                } | {
+                    type: "prediction_market";
+                    data: {
+                        source: "kalshi" | "polymarket";
+                        marketKey: string;
+                        track: "PEAK" | "TROUGH";
+                        threshold: number;
+                    };
+                } | {
+                    type: "btc_dominance";
+                    data: {
+                        source: "coingecko";
+                        track: "PEAK" | "TROUGH";
+                        threshold: number;
+                    };
                 };
                 context: {
                     type: "MARKET";

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`, {
@@ -115,6 +145,37 @@ class Core {
       });
     }
   };
+  notifications = {
+    list: async (query, headers) => {
+      return await this.client.fetch(`/notifications`, {
+        method: "GET",
+        headers,
+        query
+      });
+    },
+    markRead: async (body, headers) => {
+      return await this.client.fetch(`/notifications/read`, {
+        method: "POST",
+        headers,
+        body
+      });
+    },
+    markUnread: async (body, headers) => {
+      return await this.client.fetch(`/notifications/unread`, {
+        method: "POST",
+        headers,
+        body
+      });
+    }
+  };
+  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`, {
@@ -160,7 +221,7 @@ class Core {
       return await this.client.fetch(`/rebalance/manually/${positionId}`, {
         method: "POST",
         headers,
-        body
+        body: this.withClientId(body)
       });
     }
   };
@@ -176,7 +237,7 @@ class Core {
       return await this.client.fetch(`/schedules`, {
         method: "POST",
         headers,
-        body
+        body: this.withClientId(body)
       });
     },
     cancel: async (scheduleId, headers) => {
@@ -227,28 +288,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) => {
@@ -271,14 +332,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) => {

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,8 +1,9 @@
 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';
 
@@ -10,7 +11,8 @@ 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,6 +1,8 @@
 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';
@@ -9,6 +11,7 @@ class PearSDK {
   admin;
   auth;
   core;
+  external;
   constructor(config) {
     const authMode = config.auth?.type ?? "session";
     const logger = config.logger ?? {
@@ -22,6 +25,7 @@ class PearSDK {
     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 () => {
@@ -73,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.1.0",
+  "version": "1.1.0",
   "description": "Pear Protocol Core SDK",
   "private": false,
   "type": "module",
@@ -25,8 +25,8 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@pear-protocol/types": "^0.1.0",
-    "@pear-protocol/utils": "^0.0.22",
+    "@pear-protocol/types": "^1.1.0",
+    "@pear-protocol/utils": "^0.0.23",
     "qs": "^6.14.0"
   },
   "devDependencies": {