parsec-api 0.9.0 → 0.11.0

package/src/client.ts

@@ -11,31 +11,23 @@ import type { APIResponseProps } from './internal/parse';
 import { getPlatformHeaders } from './internal/detect-platform';
 import * as Shims from './internal/shims';
 import * as Opts from './internal/request-options';
-import * as qs from './internal/qs';
+import { stringifyQuery } from './internal/utils/query';
 import { VERSION } from './version';
 import * as Errors from './core/error';
 import * as Uploads from './core/uploads';
 import * as API from './resources/index';
-import { ParsecWebSocket, type ParsecWebSocketOptions } from './streaming';
 import { APIPromise } from './core/api-promise';
 import {
   Account,
   AccountBalanceParams,
   AccountBalanceResponse,
-  AccountCapabilitiesResponse,
   AccountPingParams,
   AccountPingResponse,
-  AccountUpdateCredentialsParams,
+  AccountUsageResponse,
   AccountUserActivityParams,
   AccountUserActivityResponse,
 } from './resources/account';
-import {
-  ApprovalListParams,
-  ApprovalListResponse,
-  ApprovalSetParams,
-  ApprovalSetResponse,
-  Approvals,
-} from './resources/approvals';
+import { Ctf, CtfMergeParams, CtfRedeemParams, CtfResponse, CtfSplitParams } from './resources/ctf';
 import { EventListParams, EventListResponse, Events } from './resources/events';
 import { ExchangeListResponse, Exchanges } from './resources/exchanges';
 import {
@@ -43,7 +35,9 @@ import {
   ExecutionPriceRetrieveParams,
   ExecutionPriceRetrieveResponse,
 } from './resources/execution-price';
+import { FillListParams, FillListResponse, Fills } from './resources/fills';
 import { MarketListParams, MarketListResponse, Markets } from './resources/markets';
+import { Onboard, OnboardCreateParams, OnboardCreateResponse } from './resources/onboard';
 import { Orderbook, OrderbookRetrieveParams, OrderbookRetrieveResponse } from './resources/orderbook';
 import {
   Order,
@@ -57,12 +51,19 @@ import {
 import { PositionListParams, PositionListResponse, Positions } from './resources/positions';
 import { Price, PriceRetrieveParams, PriceRetrieveResponse } from './resources/price';
 import { TradeListParams, TradeListResponse, Trades } from './resources/trades';
+import {
+  Wallet,
+  WalletExportKeyParams,
+  WalletExportKeyResponse,
+  WalletRetrieveResponse,
+} from './resources/wallet';
 import {
   CustomerUsage,
   Websocket,
   WebsocketUsageParams,
   WebsocketUsageResponse,
 } from './resources/websocket';
+import { Builder, BuilderPoolResponse } from './resources/builder/builder';
 import { type Fetch } from './internal/builtin-types';
 import { HeadersLike, NullableHeaders, buildHeaders } from './internal/headers';
 import { FinalRequestOptions, RequestOptions } from './internal/request-options';
@@ -164,11 +165,6 @@ export interface ClientOptions {
    * Defaults to globalThis.console.
    */
   logger?: Logger | undefined;
-
-  // TODO(verbose-mode): Add per-request debug override that logs raw request/response
-  // details (method, URL, headers, body, status) independent of global log level.
-  // pmxt exposes `verbose: true` per request, which is useful during strategy
-  // integration debugging without enabling global SDK logging noise.
 }
 
 /**
@@ -285,8 +281,8 @@ export class ParsecAPI {
     return buildHeaders([{ 'X-API-Key': this.apiKey }]);
   }
 
-  protected stringifyQuery(query: Record<string, unknown>): string {
-    return qs.stringify(query, { arrayFormat: 'comma' });
+  protected stringifyQuery(query: object | Record<string, unknown>): string {
+    return stringifyQuery(query);
   }
 
   private getUserAgent(): string {
@@ -323,7 +319,7 @@ export class ParsecAPI {
     }
 
     if (typeof query === 'object' && query && !Array.isArray(query)) {
-      url.search = this.stringifyQuery(query as Record<string, unknown>);
+      url.search = this.stringifyQuery(query);
     }
 
     return url.toString();
@@ -762,7 +758,7 @@ export class ParsecAPI {
     ) {
       return {
         bodyHeaders: { 'content-type': 'application/x-www-form-urlencoded' },
-        body: this.stringifyQuery(body as Record<string, unknown>),
+        body: this.stringifyQuery(body),
       };
     } else {
       return this.#encoder({ body, headers });
@@ -798,42 +794,12 @@ export class ParsecAPI {
   websocket: API.Websocket = new API.Websocket(this);
   orders: API.Orders = new API.Orders(this);
   positions: API.Positions = new API.Positions(this);
+  fills: API.Fills = new API.Fills(this);
   account: API.Account = new API.Account(this);
-  approvals: API.Approvals = new API.Approvals(this);
-
-  /**
-   * Create a WebSocket client for real-time orderbook and trade streaming.
-   * Inherits `apiKey` from this client and derives the WebSocket URL from `baseURL`.
-   *
-   * @param opts.url - Override the WebSocket URL (derived from baseURL by default).
-   * @returns A new `ParsecWebSocket` instance.
-   *
-   * @example
-   * ```ts
-   * const client = new ParsecAPI({ apiKey: 'pk_...' });
-   * const ws = client.ws();
-   *
-   * ws.on('orderbook', (book) => console.log(book.bids[0]));
-   * await ws.connect();
-   * ws.subscribe({ parsecId: 'polymarket:0x123', outcome: 'Yes' });
-   * ```
-   */
-  ws(opts?: ParsecWebSocketOptions): ParsecWebSocket {
-    const wsUrl = opts?.url ?? this.#deriveWsUrl();
-    return new ParsecWebSocket(this.apiKey, wsUrl);
-  }
-
-  #deriveWsUrl(): string {
-    const base = this.baseURL.replace(/\/$/, '');
-    if (base.startsWith('https://')) {
-      return base.replace(/^https:\/\//, 'wss://') + '/ws';
-    }
-    if (base.startsWith('http://')) {
-      return base.replace(/^http:\/\//, 'ws://') + '/ws';
-    }
-    // Fallback: assume wss
-    return 'wss://' + base + '/ws';
-  }
+  onboard: API.Onboard = new API.Onboard(this);
+  wallet: API.Wallet = new API.Wallet(this);
+  ctf: API.Ctf = new API.Ctf(this);
+  builder: API.Builder = new API.Builder(this);
 }
 
 ParsecAPI.Exchanges = Exchanges;
@@ -846,8 +812,12 @@ ParsecAPI.Events = Events;
 ParsecAPI.Websocket = Websocket;
 ParsecAPI.Orders = Orders;
 ParsecAPI.Positions = Positions;
+ParsecAPI.Fills = Fills;
 ParsecAPI.Account = Account;
-ParsecAPI.Approvals = Approvals;
+ParsecAPI.Onboard = Onboard;
+ParsecAPI.Wallet = Wallet;
+ParsecAPI.Ctf = Ctf;
+ParsecAPI.Builder = Builder;
 
 export declare namespace ParsecAPI {
   export type RequestOptions = Opts.RequestOptions;
@@ -913,23 +883,39 @@ export declare namespace ParsecAPI {
     type PositionListParams as PositionListParams,
   };
 
+  export { Fills as Fills, type FillListResponse as FillListResponse, type FillListParams as FillListParams };
+
   export {
     Account as Account,
     type AccountBalanceResponse as AccountBalanceResponse,
-    type AccountCapabilitiesResponse as AccountCapabilitiesResponse,
     type AccountPingResponse as AccountPingResponse,
+    type AccountUsageResponse as AccountUsageResponse,
     type AccountUserActivityResponse as AccountUserActivityResponse,
     type AccountBalanceParams as AccountBalanceParams,
     type AccountPingParams as AccountPingParams,
-    type AccountUpdateCredentialsParams as AccountUpdateCredentialsParams,
     type AccountUserActivityParams as AccountUserActivityParams,
   };
 
   export {
-    Approvals as Approvals,
-    type ApprovalListResponse as ApprovalListResponse,
-    type ApprovalSetResponse as ApprovalSetResponse,
-    type ApprovalListParams as ApprovalListParams,
-    type ApprovalSetParams as ApprovalSetParams,
+    Onboard as Onboard,
+    type OnboardCreateResponse as OnboardCreateResponse,
+    type OnboardCreateParams as OnboardCreateParams,
   };
+
+  export {
+    Wallet as Wallet,
+    type WalletRetrieveResponse as WalletRetrieveResponse,
+    type WalletExportKeyResponse as WalletExportKeyResponse,
+    type WalletExportKeyParams as WalletExportKeyParams,
+  };
+
+  export {
+    Ctf as Ctf,
+    type CtfResponse as CtfResponse,
+    type CtfMergeParams as CtfMergeParams,
+    type CtfRedeemParams as CtfRedeemParams,
+    type CtfSplitParams as CtfSplitParams,
+  };
+
+  export { Builder as Builder, type BuilderPoolResponse as BuilderPoolResponse };
 }

package/src/core/error.ts

@@ -23,35 +23,6 @@ export class APIError<
     this.error = error;
   }
 
-  /**
-   * Machine-readable error code from API response body, when provided.
-   * Example: `insufficient_funds`, `rate_limit_exceeded`.
-   */
-  get code(): string | undefined {
-    const code = (this.error as any)?.code;
-    return typeof code === 'string' ? code : undefined;
-  }
-
-  /**
-   * Retry hint from API response body, when provided.
-   */
-  get retryable(): boolean | undefined {
-    const retryable = (this.error as any)?.retryable;
-    return typeof retryable === 'boolean' ? retryable : undefined;
-  }
-
-  isCode(code: string): boolean {
-    return this.code === code;
-  }
-
-  isRetryable(): boolean {
-    return this.retryable === true;
-  }
-
-  isInsufficientFunds(): boolean {
-    return this.code === 'insufficient_funds';
-  }
-
   private static makeMessage(status: number | undefined, error: any, message: string | undefined) {
     const msg =
       error?.message ?

package/src/index.ts

@@ -20,17 +20,3 @@ export {
   PermissionDeniedError,
   UnprocessableEntityError,
 } from './core/error';
-
-export {
-  ParsecWebSocket,
-  type ParsecWebSocketOptions,
-  type ParsecWebSocketEventMap,
-  type OrderbookSnapshot,
-  type StreamingOrderbookLevel,
-  type Activity,
-  type WsError,
-  type MarketSubscription,
-  type FeedState,
-  type BookState,
-  type OrderbookKind,
-} from './streaming';

package/src/internal/utils/query.ts

@@ -0,0 +1,7 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import * as qs from '../qs/stringify';
+
+export function stringifyQuery(query: object | Record<string, unknown>) {
+  return qs.stringify(query, { arrayFormat: 'comma' });
+}

package/src/internal/utils.ts

@@ -6,3 +6,4 @@ export * from './utils/env';
 export * from './utils/log';
 export * from './utils/uuid';
 export * from './utils/sleep';
+export * from './utils/query';

package/src/resources/account.ts

@@ -23,13 +23,6 @@ export class Account extends APIResource {
     });
   }
 
-  /**
-   * Returns the customer's tier and list of linked exchanges.
-   */
-  capabilities(options?: RequestOptions): APIPromise<AccountCapabilitiesResponse> {
-    return this._client.get('/api/v1/session/capabilities', options);
-  }
-
   /**
    * Performs a lightweight balance fetch per exchange to verify connectivity/auth
    * status.
@@ -42,14 +35,12 @@ export class Account extends APIResource {
   }
 
   /**
-   * Updates stored credentials for this API key. Returns 204 on success.
+   * Returns the authenticated customer's tier, billing period, rate limits, and
+   * current consumption (monthly requests, WebSocket connections/subscriptions).
+   * Values of 0 for limits indicate unlimited.
    */
-  updateCredentials(body: AccountUpdateCredentialsParams, options?: RequestOptions): APIPromise<void> {
-    return this._client.put('/api/v1/credentials', {
-      body,
-      ...options,
-      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
-    });
+  usage(options?: RequestOptions): APIPromise<AccountUsageResponse> {
+    return this._client.get('/api/v1/usage', options);
   }
 
   /**
@@ -68,18 +59,6 @@ export interface AccountBalanceResponse {
   raw: { [key: string]: unknown };
 }
 
-export interface AccountCapabilitiesResponse {
-  /**
-   * Exchange IDs the customer has credentials linked for.
-   */
-  linked_exchanges: Array<string>;
-
-  /**
-   * Customer tier (e.g., "free", "pro", "admin").
-   */
-  tier: string;
-}
-
 export type AccountPingResponse = Array<AccountPingResponse.AccountPingResponseItem>;
 
 export namespace AccountPingResponse {
@@ -94,6 +73,78 @@ export namespace AccountPingResponse {
   }
 }
 
+export interface AccountUsageResponse {
+  /**
+   * Unix seconds — 1st of next month UTC.
+   */
+  billing_period_end: number;
+
+  /**
+   * Unix seconds — 1st of current month UTC.
+   */
+  billing_period_start: number;
+
+  limits: AccountUsageResponse.Limits;
+
+  /**
+   * Current tier (free, pro, scale).
+   */
+  tier: string;
+
+  usage: AccountUsageResponse.Usage;
+}
+
+export namespace AccountUsageResponse {
+  export interface Limits {
+    /**
+     * Max historical data age in days. 0 = unlimited.
+     */
+    history_max_age_days: number;
+
+    /**
+     * Monthly REST request cap. 0 = unlimited.
+     */
+    monthly_requests: number;
+
+    /**
+     * REST queries per second. 0 = unlimited.
+     */
+    rest_qps: number;
+
+    /**
+     * REST burst QPS allowance. 0 = unlimited.
+     */
+    rest_qps_burst: number;
+
+    /**
+     * Max orderbook depth per WebSocket subscription.
+     */
+    ws_max_depth: number;
+
+    /**
+     * Max WebSocket subscriptions across all connections. 0 = unlimited.
+     */
+    ws_max_subscriptions: number;
+  }
+
+  export interface Usage {
+    /**
+     * REST requests consumed this billing period.
+     */
+    monthly_requests: number;
+
+    /**
+     * Currently active WebSocket connections.
+     */
+    ws_active_connections: number;
+
+    /**
+     * Currently active WebSocket subscriptions.
+     */
+    ws_active_subscriptions: number;
+  }
+}
+
 export interface AccountUserActivityResponse {
   exchanges: { [key: string]: unknown };
 
@@ -134,33 +185,6 @@ export interface AccountPingParams {
   exchange?: string;
 }
 
-export interface AccountUpdateCredentialsParams {
-  /**
-   * Kalshi API key ID.
-   */
-  api_key_id?: string | null;
-
-  /**
-   * Polymarket CLOB API key.
-   */
-  clob_api_key?: string | null;
-
-  /**
-   * Polymarket CLOB API passphrase.
-   */
-  clob_api_passphrase?: string | null;
-
-  /**
-   * Polymarket CLOB API secret.
-   */
-  clob_api_secret?: string | null;
-
-  /**
-   * Kalshi RSA private key (PEM format).
-   */
-  private_key?: string | null;
-}
-
 export interface AccountUserActivityParams {
   /**
    * User address (typically an EVM address).
@@ -182,12 +206,11 @@ export interface AccountUserActivityParams {
 export declare namespace Account {
   export {
     type AccountBalanceResponse as AccountBalanceResponse,
-    type AccountCapabilitiesResponse as AccountCapabilitiesResponse,
     type AccountPingResponse as AccountPingResponse,
+    type AccountUsageResponse as AccountUsageResponse,
     type AccountUserActivityResponse as AccountUserActivityResponse,
     type AccountBalanceParams as AccountBalanceParams,
     type AccountPingParams as AccountPingParams,
-    type AccountUpdateCredentialsParams as AccountUpdateCredentialsParams,
     type AccountUserActivityParams as AccountUserActivityParams,
   };
 }

package/src/resources/builder/builder.ts

@@ -0,0 +1,78 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as EscrowAPI from './escrow';
+import { Escrow, EscrowConfigResponse } from './escrow';
+import * as OnboardAPI from './onboard';
+import { Onboard, OnboardCreateParams, OnboardCreateResponse } from './onboard';
+import * as UsersAPI from './users';
+import {
+  UserCreateParams,
+  UserCreateResponse,
+  UserListParams,
+  UserListResponse,
+  UserRetrieveResponse,
+  UserUpdateParams,
+  UserUpdateResponse,
+  Users,
+} from './users';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+
+export class Builder extends APIResource {
+  users: UsersAPI.Users = new UsersAPI.Users(this._client);
+  onboard: OnboardAPI.Onboard = new OnboardAPI.Onboard(this._client);
+  escrow: EscrowAPI.Escrow = new EscrowAPI.Escrow(this._client);
+
+  /**
+   * Returns the builder's QPS pool allocation, end-user count, and total allocated
+   * QPS.
+   */
+  pool(options?: RequestOptions): APIPromise<BuilderPoolResponse> {
+    return this._client.get('/api/v1/builder/pool', options);
+  }
+}
+
+export interface BuilderPoolResponse {
+  /**
+   * Number of end-users created by this builder.
+   */
+  end_user_count: number;
+
+  /**
+   * Total QPS available to this builder.
+   */
+  qps_pool: number;
+
+  /**
+   * Total QPS allocated to end-users.
+   */
+  total_allocated_qps: number;
+}
+
+Builder.Users = Users;
+Builder.Onboard = Onboard;
+Builder.Escrow = Escrow;
+
+export declare namespace Builder {
+  export { type BuilderPoolResponse as BuilderPoolResponse };
+
+  export {
+    Users as Users,
+    type UserCreateResponse as UserCreateResponse,
+    type UserRetrieveResponse as UserRetrieveResponse,
+    type UserUpdateResponse as UserUpdateResponse,
+    type UserListResponse as UserListResponse,
+    type UserCreateParams as UserCreateParams,
+    type UserUpdateParams as UserUpdateParams,
+    type UserListParams as UserListParams,
+  };
+
+  export {
+    Onboard as Onboard,
+    type OnboardCreateResponse as OnboardCreateResponse,
+    type OnboardCreateParams as OnboardCreateParams,
+  };
+
+  export { Escrow as Escrow, type EscrowConfigResponse as EscrowConfigResponse };
+}

package/src/resources/builder/escrow.ts

@@ -0,0 +1,62 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+
+export class Escrow extends APIResource {
+  /**
+   * Returns the builder's fee escrow configuration including contract address, fee
+   * rates, and treasury address. Read-only — fee escrow is configured by Parsec
+   * admins during onboarding.
+   */
+  config(options?: RequestOptions): APIPromise<EscrowConfigResponse> {
+    return this._client.get('/api/v1/builder/escrow/config', options);
+  }
+}
+
+export interface EscrowConfigResponse {
+  /**
+   * Affiliate fee rate in basis points.
+   */
+  affiliate_fee_bps: number;
+
+  /**
+   * Escrow smart contract address.
+   */
+  escrow_contract_address: string;
+
+  /**
+   * Whether fee escrow is enabled for this builder.
+   */
+  fee_escrow_enabled: boolean;
+
+  /**
+   * Minimum fee in basis points.
+   */
+  min_fee_bps: number;
+
+  /**
+   * Minimum fee in USDC (human-readable).
+   */
+  min_fee_usdc: string;
+
+  /**
+   * Treasury address for fee distribution.
+   */
+  treasury_address: string;
+
+  /**
+   * Affiliate fee recipient address.
+   */
+  affiliate_address?: string | null;
+
+  /**
+   * Fee rate in basis points.
+   */
+  fee_bps?: number | null;
+}
+
+export declare namespace Escrow {
+  export { type EscrowConfigResponse as EscrowConfigResponse };
+}

package/src/resources/builder/index.ts

@@ -0,0 +1,15 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Builder, type BuilderPoolResponse } from './builder';
+export { Escrow, type EscrowConfigResponse } from './escrow';
+export { Onboard, type OnboardCreateResponse, type OnboardCreateParams } from './onboard';
+export {
+  Users,
+  type UserCreateResponse,
+  type UserRetrieveResponse,
+  type UserUpdateResponse,
+  type UserListResponse,
+  type UserCreateParams,
+  type UserUpdateParams,
+  type UserListParams,
+} from './users';