parsec-api 0.9.0 → 0.12.0

package/src/resources/events.ts

@@ -3,28 +3,18 @@
 import { APIResource } from '../core/resource';
 import { APIPromise } from '../core/api-promise';
 import { RequestOptions } from '../internal/request-options';
-import { attachBinaryOutcomeGetters } from './markets';
 
 export class Events extends APIResource {
   /**
-   * Aggregates markets by event ID from the Silver cache. Returns event summaries
-   * sorted by total volume (descending). Markets without an event_id are excluded.
+   * Aggregates markets by event ID from the DuckDB gold layer. Returns event
+   * summaries sorted by total volume (descending). Markets without an event_id are
+   * excluded.
    */
   list(
     query: EventListParams | null | undefined = {},
     options?: RequestOptions,
   ): APIPromise<EventListResponse> {
-    const request = this._client.get('/api/v1/events', {
-      query,
-      ...options,
-    }) as APIPromise<EventListResponse>;
-    return request._thenUnwrap((data: EventListResponse) => {
-      data.events.forEach((event) => {
-        if (!event.markets) return;
-        event.markets = event.markets.map((market) => attachBinaryOutcomeGetters(market));
-      });
-      return data;
-    });
+    return this._client.get('/api/v1/events', { query, ...options });
   }
 }
 
@@ -106,18 +96,6 @@ export namespace EventListResponse {
        */
       outcomes: Array<Market.Outcome>;
 
-      /**
-       * Convenience getter for binary markets: outcome where `name` is "Yes"
-       * (case-insensitive).
-       */
-      readonly yes?: Market.Outcome;
-
-      /**
-       * Convenience getter for binary markets: outcome where `name` is "No"
-       * (case-insensitive).
-       */
-      readonly no?: Market.Outcome;
-
       /**
        * Parsec group ID for cross-exchange event grouping.
        */
@@ -180,6 +158,16 @@ export namespace EventListResponse {
        */
       event_start_time?: string;
 
+      /**
+       * Market icon URL.
+       */
+      icon_url?: string | null;
+
+      /**
+       * Market image URL.
+       */
+      image_url?: string | null;
+
       /**
        * Date of last data collection.
        */
@@ -195,6 +183,11 @@ export namespace EventListResponse {
        */
       liquidity?: number;
 
+      /**
+       * Cross-exchange same-market relations. Only included when `include_matches=true`.
+       */
+      matched_markets?: Array<Market.MatchedMarket>;
+
       /**
        * Minimum order size in contracts. Varies per market on Polymarket (e.g. 5, 15);
        * typically 1 on Kalshi.
@@ -211,6 +204,17 @@ export namespace EventListResponse {
        */
       outcome_count?: number;
 
+      /**
+       * When bid/ask/last_price was last refreshed (upgraded to now when live WS data
+       * overlays the snapshot).
+       */
+      price_updated_at?: string | null;
+
+      /**
+       * Co-dependent market relations. Only included when `include_related=true`.
+       */
+      related_markets?: Array<Market.RelatedMarket>;
+
       /**
        * Market resolution rules.
        */
@@ -258,6 +262,80 @@ export namespace EventListResponse {
          */
         token_id?: string;
       }
+
+      export interface MatchedMarket {
+        /**
+         * Match confidence score (0.0–1.0).
+         */
+        confidence: number;
+
+        /**
+         * Confidence tier: HIGH, MEDIUM, or LOW.
+         */
+        confidence_tier: string;
+
+        /**
+         * Exchange of the related market.
+         */
+        exchange: string;
+
+        /**
+         * Parsec ID of the related market.
+         */
+        parsec_id: string;
+
+        /**
+         * Source of the match (e.g., embedding, llm).
+         */
+        source: string;
+
+        /**
+         * Direction of dependency (for related markets only).
+         */
+        dependency_direction?: string | null;
+
+        /**
+         * Type of dependency (for related markets only).
+         */
+        dependency_type?: string | null;
+      }
+
+      export interface RelatedMarket {
+        /**
+         * Match confidence score (0.0–1.0).
+         */
+        confidence: number;
+
+        /**
+         * Confidence tier: HIGH, MEDIUM, or LOW.
+         */
+        confidence_tier: string;
+
+        /**
+         * Exchange of the related market.
+         */
+        exchange: string;
+
+        /**
+         * Parsec ID of the related market.
+         */
+        parsec_id: string;
+
+        /**
+         * Source of the match (e.g., embedding, llm).
+         */
+        source: string;
+
+        /**
+         * Direction of dependency (for related markets only).
+         */
+        dependency_direction?: string | null;
+
+        /**
+         * Type of dependency (for related markets only).
+         */
+        dependency_type?: string | null;
+      }
     }
   }
 

package/src/resources/exchanges.ts

@@ -32,8 +32,6 @@ export namespace ExchangeListResponse {
 
   export namespace ExchangeListResponseItem {
     export interface Has {
-      approvals: boolean;
-
       cancel_order: boolean;
 
       create_order: boolean;
@@ -42,6 +40,8 @@ export namespace ExchangeListResponse {
 
       fetch_events: boolean;
 
+      fetch_fills: boolean;
+
       fetch_markets: boolean;
 
       fetch_orderbook: boolean;

package/src/resources/fills.ts

@@ -0,0 +1,107 @@
+// 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 { buildHeaders } from '../internal/headers';
+import { RequestOptions } from '../internal/request-options';
+
+export class Fills extends APIResource {
+  /**
+   * Returns fills (individual trade executions) for the authenticated customer on
+   * the specified exchange. A single order can produce multiple fills.
+   */
+  list(params: FillListParams, options?: RequestOptions): APIPromise<FillListResponse> {
+    const { 'X-Exchange-Credentials': xExchangeCredentials, ...query } = params;
+    return this._client.get('/api/v1/fills', {
+      query,
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(xExchangeCredentials != null ? { 'X-Exchange-Credentials': xExchangeCredentials } : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+}
+
+export type FillListResponse = Array<FillListResponse.FillListResponseItem>;
+
+export namespace FillListResponse {
+  export interface FillListResponseItem {
+    /**
+     * Timestamp of the fill (ISO 8601).
+     */
+    created_at: string;
+
+    /**
+     * Fee charged for this fill.
+     */
+    fee: number;
+
+    /**
+     * Unique fill identifier.
+     */
+    fill_id: string;
+
+    /**
+     * Whether this fill was a taker (market order hitting resting liquidity).
+     */
+    is_taker: boolean;
+
+    /**
+     * Market the fill occurred on (exchange-native ID).
+     */
+    market_id: string;
+
+    /**
+     * ID of the order that was filled.
+     */
+    order_id: string;
+
+    /**
+     * The outcome traded (e.g., "Yes" or "No").
+     */
+    outcome: string;
+
+    /**
+     * Execution price.
+     */
+    price: number;
+
+    side: 'buy' | 'sell';
+
+    /**
+     * Number of contracts filled.
+     */
+    size: number;
+  }
+}
+
+export interface FillListParams {
+  /**
+   * Query param: Exchange identifier (e.g., kalshi, polymarket).
+   */
+  exchange: string;
+
+  /**
+   * Query param: Maximum number of fills to return.
+   */
+  limit?: number;
+
+  /**
+   * Query param: Filter fills by a specific market ID (exchange-native).
+   */
+  market_id?: string;
+
+  /**
+   * Header param: Base64-encoded JSON of per-request exchange credentials (Mode B).
+   * When provided, Parsec creates a transient exchange session instead of using
+   * stored credentials. The JSON shape matches the RequestCredentials schema.
+   */
+  'X-Exchange-Credentials'?: string;
+}
+
+export declare namespace Fills {
+  export { type FillListResponse as FillListResponse, type FillListParams as FillListParams };
+}

package/src/resources/index.ts

@@ -3,21 +3,15 @@
 export {
   Account,
   type AccountBalanceResponse,
-  type AccountCapabilitiesResponse,
   type AccountPingResponse,
+  type AccountUsageResponse,
   type AccountUserActivityResponse,
   type AccountBalanceParams,
   type AccountPingParams,
-  type AccountUpdateCredentialsParams,
   type AccountUserActivityParams,
 } from './account';
-export {
-  Approvals,
-  type ApprovalListResponse,
-  type ApprovalSetResponse,
-  type ApprovalListParams,
-  type ApprovalSetParams,
-} from './approvals';
+export { Builder, type BuilderPoolResponse } from './builder/builder';
+export { Ctf, type CtfResponse, type CtfMergeParams, type CtfRedeemParams, type CtfSplitParams } from './ctf';
 export { Events, type EventListResponse, type EventListParams } from './events';
 export { Exchanges, type ExchangeListResponse } from './exchanges';
 export {
@@ -25,13 +19,10 @@ export {
   type ExecutionPriceRetrieveResponse,
   type ExecutionPriceRetrieveParams,
 } from './execution-price';
+export { Fills, type FillListResponse, type FillListParams } from './fills';
 export { Markets, type MarketListResponse, type MarketListParams } from './markets';
-export {
-  Orderbook,
-  type OrderbookRetrieveResponse,
-  type OrderbookRetrieveParams,
-  type OrderbookLevel,
-} from './orderbook';
+export { Onboard, type OnboardCreateResponse, type OnboardCreateParams } from './onboard';
+export { Orderbook, type OrderbookRetrieveResponse, type OrderbookRetrieveParams } from './orderbook';
 export {
   Orders,
   type Order,
@@ -44,6 +35,12 @@ export {
 export { Positions, type PositionListResponse, type PositionListParams } from './positions';
 export { Price, type PriceRetrieveResponse, type PriceRetrieveParams } from './price';
 export { Trades, type TradeListResponse, type TradeListParams } from './trades';
+export {
+  Wallet,
+  type WalletRetrieveResponse,
+  type WalletExportKeyResponse,
+  type WalletExportKeyParams,
+} from './wallet';
 export {
   Websocket,
   type CustomerUsage,

package/src/resources/markets.ts

@@ -4,34 +4,6 @@ import { APIResource } from '../core/resource';
 import { APIPromise } from '../core/api-promise';
 import { RequestOptions } from '../internal/request-options';
 
-function findOutcomeByName<T extends { name: string }>(outcomes: Array<T>, target: string): T | undefined {
-  const normalized = target.toLowerCase();
-  return outcomes.find((outcome) => outcome.name.toLowerCase() === normalized);
-}
-
-export function attachBinaryOutcomeGetters<
-  TOutcome extends { name: string },
-  TMarket extends { outcomes: Array<TOutcome> },
->(market: TMarket): TMarket & { readonly yes?: TOutcome; readonly no?: TOutcome } {
-  if (!Object.prototype.hasOwnProperty.call(market, 'yes')) {
-    Object.defineProperty(market, 'yes', {
-      configurable: false,
-      enumerable: false,
-      get: () => findOutcomeByName(market.outcomes, 'yes'),
-    });
-  }
-
-  if (!Object.prototype.hasOwnProperty.call(market, 'no')) {
-    Object.defineProperty(market, 'no', {
-      configurable: false,
-      enumerable: false,
-      get: () => findOutcomeByName(market.outcomes, 'no'),
-    });
-  }
-
-  return market as TMarket & { readonly yes?: TOutcome; readonly no?: TOutcome };
-}
-
 export class Markets extends APIResource {
   /**
    * Provide either `exchanges` (CSV) or `parsec_ids` (CSV). When `parsec_ids` is
@@ -41,14 +13,7 @@ export class Markets extends APIResource {
     query: MarketListParams | null | undefined = {},
     options?: RequestOptions,
   ): APIPromise<MarketListResponse> {
-    const request = this._client.get('/api/v1/markets', {
-      query,
-      ...options,
-    }) as APIPromise<MarketListResponse>;
-    return request._thenUnwrap((data: MarketListResponse) => {
-      data.markets = data.markets.map((market) => attachBinaryOutcomeGetters(market));
-      return data;
-    });
+    return this._client.get('/api/v1/markets', { query, ...options });
   }
 }
 
@@ -87,18 +52,6 @@ export namespace MarketListResponse {
      */
     outcomes: Array<Market.Outcome>;
 
-    /**
-     * Convenience getter for binary markets: outcome where `name` is "Yes"
-     * (case-insensitive).
-     */
-    readonly yes?: Market.Outcome;
-
-    /**
-     * Convenience getter for binary markets: outcome where `name` is "No"
-     * (case-insensitive).
-     */
-    readonly no?: Market.Outcome;
-
     /**
      * Parsec group ID for cross-exchange event grouping.
      */
@@ -161,6 +114,16 @@ export namespace MarketListResponse {
      */
     event_start_time?: string;
 
+    /**
+     * Market icon URL.
+     */
+    icon_url?: string | null;
+
+    /**
+     * Market image URL.
+     */
+    image_url?: string | null;
+
     /**
      * Date of last data collection.
      */
@@ -176,6 +139,11 @@ export namespace MarketListResponse {
      */
     liquidity?: number;
 
+    /**
+     * Cross-exchange same-market relations. Only included when `include_matches=true`.
+     */
+    matched_markets?: Array<Market.MatchedMarket>;
+
     /**
      * Minimum order size in contracts. Varies per market on Polymarket (e.g. 5, 15);
      * typically 1 on Kalshi.
@@ -192,6 +160,17 @@ export namespace MarketListResponse {
      */
     outcome_count?: number;
 
+    /**
+     * When bid/ask/last_price was last refreshed (upgraded to now when live WS data
+     * overlays the snapshot).
+     */
+    price_updated_at?: string | null;
+
+    /**
+     * Co-dependent market relations. Only included when `include_related=true`.
+     */
+    related_markets?: Array<Market.RelatedMarket>;
+
     /**
      * Market resolution rules.
      */
@@ -239,6 +218,80 @@ export namespace MarketListResponse {
        */
       token_id?: string;
     }
+
+    export interface MatchedMarket {
+      /**
+       * Match confidence score (0.0–1.0).
+       */
+      confidence: number;
+
+      /**
+       * Confidence tier: HIGH, MEDIUM, or LOW.
+       */
+      confidence_tier: string;
+
+      /**
+       * Exchange of the related market.
+       */
+      exchange: string;
+
+      /**
+       * Parsec ID of the related market.
+       */
+      parsec_id: string;
+
+      /**
+       * Source of the match (e.g., embedding, llm).
+       */
+      source: string;
+
+      /**
+       * Direction of dependency (for related markets only).
+       */
+      dependency_direction?: string | null;
+
+      /**
+       * Type of dependency (for related markets only).
+       */
+      dependency_type?: string | null;
+    }
+
+    export interface RelatedMarket {
+      /**
+       * Match confidence score (0.0–1.0).
+       */
+      confidence: number;
+
+      /**
+       * Confidence tier: HIGH, MEDIUM, or LOW.
+       */
+      confidence_tier: string;
+
+      /**
+       * Exchange of the related market.
+       */
+      exchange: string;
+
+      /**
+       * Parsec ID of the related market.
+       */
+      parsec_id: string;
+
+      /**
+       * Source of the match (e.g., embedding, llm).
+       */
+      source: string;
+
+      /**
+       * Direction of dependency (for related markets only).
+       */
+      dependency_direction?: string | null;
+
+      /**
+       * Type of dependency (for related markets only).
+       */
+      dependency_type?: string | null;
+    }
   }
 
   export interface Pagination {
@@ -287,7 +340,19 @@ export interface MarketListParams {
   group_id?: string;
 
   /**
-   * Results per page (default 100).
+   * When true, each market includes a `matched_markets` array with cross-exchange
+   * same-market relations.
+   */
+  include_matches?: boolean;
+
+  /**
+   * When true, each market includes a `related_markets` array with co-dependent
+   * market relations.
+   */
+  include_related?: boolean;
+
+  /**
+   * Results per page (default 100, max 100).
    */
   limit?: number;
 

package/src/resources/onboard.ts

@@ -0,0 +1,116 @@
+// 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 Onboard extends APIResource {
+  /**
+   * Unified onboarding endpoint. Managed mode creates wallet + exchange credentials
+   * (Polymarket only). Self mode stores user-provided credentials (Polymarket or
+   * Kalshi). Idempotent and resumable.
+   */
+  create(body: OnboardCreateParams, options?: RequestOptions): APIPromise<OnboardCreateResponse> {
+    return this._client.post('/api/v1/onboard', { body, ...options });
+  }
+}
+
+export interface OnboardCreateResponse {
+  /**
+   * Exchange that was onboarded.
+   */
+  exchange: string;
+
+  /**
+   * All exchanges linked to this account.
+   */
+  linked_exchanges: Array<string>;
+
+  /**
+   * Onboard mode used ("managed" or "self").
+   */
+  mode: string;
+
+  /**
+   * Onboard status ("complete").
+   */
+  status: string;
+
+  /**
+   * Steps completed during this call.
+   */
+  steps_completed: Array<string>;
+
+  /**
+   * EOA wallet address (managed mode only).
+   */
+  eoa_address?: string | null;
+
+  /**
+   * Safe wallet address (present when wallet_type is "safe").
+   */
+  safe_address?: string | null;
+}
+
+export interface OnboardCreateParams {
+  /**
+   * Exchange to onboard ("polymarket" or "kalshi").
+   */
+  exchange: string;
+
+  /**
+   * Managed = Parsec creates wallet + credentials. Self = you provide credentials.
+   */
+  mode: 'managed' | 'self';
+
+  /**
+   * Kalshi API key ID (self mode).
+   */
+  api_key_id?: string;
+
+  /**
+   * Chain ID for Safe wallet creation. Only used with wallet_type "safe".
+   */
+  chain_id?: number;
+
+  /**
+   * Polymarket CLOB API key (self mode).
+   */
+  clob_api_key?: string;
+
+  /**
+   * Polymarket CLOB API passphrase (self mode).
+   */
+  clob_api_passphrase?: string;
+
+  /**
+   * Polymarket CLOB API secret (self mode).
+   */
+  clob_api_secret?: string;
+
+  /**
+   * External wallet address (42-char hex, 0x-prefixed). Required when wallet_type is
+   * "safe". Parsec skips embedded EOA creation and uses this address as the Safe
+   * owner. Must not be provided when wallet_type is "eoa".
+   */
+  eoa_address?: string;
+
+  /**
+   * Kalshi RSA private key in PEM format (self mode).
+   */
+  private_key?: string;
+
+  /**
+   * Wallet type for managed mode. "eoa" (default) creates an embedded EOA wallet.
+   * "safe" creates a Safe wallet owned by the external address in eoa_address.
+   * "safe" requires eoa_address. Providing eoa_address with "eoa" returns 400.
+   */
+  wallet_type?: string;
+}
+
+export declare namespace Onboard {
+  export {
+    type OnboardCreateResponse as OnboardCreateResponse,
+    type OnboardCreateParams as OnboardCreateParams,
+  };
+}