@pear-protocol/types 1.33.0 → 2.1.0

package/dist/trade/entities.d.ts

@@ -0,0 +1,284 @@
+import { z } from 'zod';
+/** The basis state immediately before or after a fill. */
+export declare const TradePositionState: z.ZodObject<{
+    signedQuantity: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+    basis: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"FLAT">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"PRICED">;
+        entryPrice: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"UNPRICED">;
+    }, z.core.$strip>], "kind">;
+}, z.core.$strip>;
+export type TradePositionState = z.output<typeof TradePositionState>;
+/** The priced or unpriceable quantity reduced by one fill. */
+export declare const TradeRealization: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"PRICED">;
+    quantity: z.ZodString;
+    entryPrice: z.ZodString;
+    exitPrice: z.ZodString;
+    grossPnl: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"UNPRICED">;
+    quantity: z.ZodString;
+}, z.core.$strip>], "kind">;
+export type TradeRealization = z.output<typeof TradeRealization>;
+/** The complete exposure effect of one fill, including flip quantities. */
+export declare const TradePositionEffect: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"OPEN">;
+    openedQuantity: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"INCREASE">;
+    increasedQuantity: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"REDUCE">;
+    reducedQuantity: z.ZodString;
+    realization: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"PRICED">;
+        quantity: z.ZodString;
+        entryPrice: z.ZodString;
+        exitPrice: z.ZodString;
+        grossPnl: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"UNPRICED">;
+        quantity: z.ZodString;
+    }, z.core.$strip>], "kind">;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"CLOSE">;
+    reducedQuantity: z.ZodString;
+    realization: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"PRICED">;
+        quantity: z.ZodString;
+        entryPrice: z.ZodString;
+        exitPrice: z.ZodString;
+        grossPnl: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"UNPRICED">;
+        quantity: z.ZodString;
+    }, z.core.$strip>], "kind">;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"FLIP">;
+    reducedQuantity: z.ZodString;
+    openedQuantity: z.ZodString;
+    realization: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"PRICED">;
+        quantity: z.ZodString;
+        entryPrice: z.ZodString;
+        exitPrice: z.ZodString;
+        grossPnl: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"UNPRICED">;
+        quantity: z.ZodString;
+    }, z.core.$strip>], "kind">;
+}, z.core.$strip>], "kind">;
+export type TradePositionEffect = z.output<typeof TradePositionEffect>;
+/** One executed fill enriched with its position transition. */
+export declare const TradeFill: z.ZodObject<{
+    id: z.ZodUUID;
+    positionId: z.ZodUUID;
+    symbol: z.ZodString;
+    connector: z.ZodEnum<{
+        hyperliquid: "hyperliquid";
+        binance: "binance";
+        bybit: "bybit";
+        okx: "okx";
+        lighter: "lighter";
+    }>;
+    side: z.ZodEnum<{
+        BUY: "BUY";
+        SELL: "SELL";
+    }>;
+    quantity: z.ZodString;
+    price: z.ZodString;
+    tradeFee: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>>;
+    pearFee: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>>;
+    timestamp: z.ZodISODateTime;
+    settlement: z.ZodEnum<{
+        PROVISIONAL: "PROVISIONAL";
+        CONFIRMED: "CONFIRMED";
+    }>;
+    executionId: z.ZodOptional<z.ZodUUID>;
+    positionEffect: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"OPEN">;
+        openedQuantity: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"INCREASE">;
+        increasedQuantity: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"REDUCE">;
+        reducedQuantity: z.ZodString;
+        realization: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"PRICED">;
+            quantity: z.ZodString;
+            entryPrice: z.ZodString;
+            exitPrice: z.ZodString;
+            grossPnl: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"UNPRICED">;
+            quantity: z.ZodString;
+        }, z.core.$strip>], "kind">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"CLOSE">;
+        reducedQuantity: z.ZodString;
+        realization: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"PRICED">;
+            quantity: z.ZodString;
+            entryPrice: z.ZodString;
+            exitPrice: z.ZodString;
+            grossPnl: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"UNPRICED">;
+            quantity: z.ZodString;
+        }, z.core.$strip>], "kind">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"FLIP">;
+        reducedQuantity: z.ZodString;
+        openedQuantity: z.ZodString;
+        realization: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"PRICED">;
+            quantity: z.ZodString;
+            entryPrice: z.ZodString;
+            exitPrice: z.ZodString;
+            grossPnl: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"UNPRICED">;
+            quantity: z.ZodString;
+        }, z.core.$strip>], "kind">;
+    }, z.core.$strip>], "kind">;
+    basisBefore: z.ZodObject<{
+        signedQuantity: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+        basis: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"FLAT">;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"PRICED">;
+            entryPrice: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"UNPRICED">;
+        }, z.core.$strip>], "kind">;
+    }, z.core.$strip>;
+    basisAfter: z.ZodObject<{
+        signedQuantity: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+        basis: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"FLAT">;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"PRICED">;
+            entryPrice: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"UNPRICED">;
+        }, z.core.$strip>], "kind">;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type TradeFill = z.output<typeof TradeFill>;
+/** A presentation group: one Pear execution or one ungrouped external fill. */
+export declare const TradeGroup: z.ZodObject<{
+    id: z.ZodString;
+    executionId: z.ZodOptional<z.ZodUUID>;
+    scheduleId: z.ZodOptional<z.ZodUUID>;
+    triggerId: z.ZodOptional<z.ZodUUID>;
+    connector: z.ZodEnum<{
+        hyperliquid: "hyperliquid";
+        binance: "binance";
+        bybit: "bybit";
+        okx: "okx";
+        lighter: "lighter";
+    }>;
+    at: z.ZodISODateTime;
+    netCashflow: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+    trades: z.ZodArray<z.ZodObject<{
+        id: z.ZodUUID;
+        positionId: z.ZodUUID;
+        symbol: z.ZodString;
+        connector: z.ZodEnum<{
+            hyperliquid: "hyperliquid";
+            binance: "binance";
+            bybit: "bybit";
+            okx: "okx";
+            lighter: "lighter";
+        }>;
+        side: z.ZodEnum<{
+            BUY: "BUY";
+            SELL: "SELL";
+        }>;
+        quantity: z.ZodString;
+        price: z.ZodString;
+        tradeFee: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>>;
+        pearFee: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>>;
+        timestamp: z.ZodISODateTime;
+        settlement: z.ZodEnum<{
+            PROVISIONAL: "PROVISIONAL";
+            CONFIRMED: "CONFIRMED";
+        }>;
+        executionId: z.ZodOptional<z.ZodUUID>;
+        positionEffect: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"OPEN">;
+            openedQuantity: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"INCREASE">;
+            increasedQuantity: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"REDUCE">;
+            reducedQuantity: z.ZodString;
+            realization: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"PRICED">;
+                quantity: z.ZodString;
+                entryPrice: z.ZodString;
+                exitPrice: z.ZodString;
+                grossPnl: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"UNPRICED">;
+                quantity: z.ZodString;
+            }, z.core.$strip>], "kind">;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"CLOSE">;
+            reducedQuantity: z.ZodString;
+            realization: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"PRICED">;
+                quantity: z.ZodString;
+                entryPrice: z.ZodString;
+                exitPrice: z.ZodString;
+                grossPnl: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"UNPRICED">;
+                quantity: z.ZodString;
+            }, z.core.$strip>], "kind">;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"FLIP">;
+            reducedQuantity: z.ZodString;
+            openedQuantity: z.ZodString;
+            realization: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"PRICED">;
+                quantity: z.ZodString;
+                entryPrice: z.ZodString;
+                exitPrice: z.ZodString;
+                grossPnl: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"UNPRICED">;
+                quantity: z.ZodString;
+            }, z.core.$strip>], "kind">;
+        }, z.core.$strip>], "kind">;
+        basisBefore: z.ZodObject<{
+            signedQuantity: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+            basis: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"FLAT">;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"PRICED">;
+                entryPrice: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"UNPRICED">;
+            }, z.core.$strip>], "kind">;
+        }, z.core.$strip>;
+        basisAfter: z.ZodObject<{
+            signedQuantity: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+            basis: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"FLAT">;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"PRICED">;
+                entryPrice: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"UNPRICED">;
+            }, z.core.$strip>], "kind">;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type TradeGroup = z.output<typeof TradeGroup>;

package/dist/trade/entities.js

@@ -0,0 +1,101 @@
+import { z } from 'zod';
+import { SignedDecimalString, UnsignedDecimalString } from '../common/schema';
+import { Connector } from '../connector';
+import { FillStatus } from '../fill';
+import { InstrumentId } from '../instrument';
+
+const TradePositionState = z.object({
+  signedQuantity: SignedDecimalString,
+  basis: z.discriminatedUnion("kind", [
+    z.object({
+      kind: z.literal("FLAT")
+    }),
+    z.object({
+      kind: z.literal("PRICED"),
+      entryPrice: UnsignedDecimalString
+    }),
+    z.object({
+      kind: z.literal("UNPRICED")
+    })
+  ])
+});
+const TradeRealization = z.discriminatedUnion("kind", [
+  z.object({
+    kind: z.literal("PRICED"),
+    quantity: UnsignedDecimalString,
+    entryPrice: UnsignedDecimalString,
+    exitPrice: UnsignedDecimalString,
+    grossPnl: SignedDecimalString
+  }),
+  z.object({
+    kind: z.literal("UNPRICED"),
+    quantity: UnsignedDecimalString
+  })
+]);
+const TradePositionEffect = z.discriminatedUnion("kind", [
+  z.object({
+    kind: z.literal("OPEN"),
+    openedQuantity: UnsignedDecimalString
+  }),
+  z.object({
+    kind: z.literal("INCREASE"),
+    increasedQuantity: UnsignedDecimalString
+  }),
+  z.object({
+    kind: z.literal("REDUCE"),
+    reducedQuantity: UnsignedDecimalString,
+    realization: TradeRealization
+  }),
+  z.object({
+    kind: z.literal("CLOSE"),
+    reducedQuantity: UnsignedDecimalString,
+    realization: TradeRealization
+  }),
+  z.object({
+    kind: z.literal("FLIP"),
+    reducedQuantity: UnsignedDecimalString,
+    openedQuantity: UnsignedDecimalString,
+    realization: TradeRealization
+  })
+]);
+const TradeFill = z.object({
+  id: z.uuid(),
+  positionId: z.uuid(),
+  symbol: InstrumentId,
+  connector: Connector,
+  side: z.enum([
+    "BUY",
+    "SELL"
+  ]),
+  quantity: UnsignedDecimalString,
+  price: UnsignedDecimalString,
+  /** Fee polarity is a charge: `+` is paid, `-` is a rebate — the opposite of `grossPnl`/`netCashflow`, where `+` is a gain. */
+  tradeFee: SignedDecimalString.optional(),
+  /** Same polarity as `tradeFee`: `+` is a charge paid to Pear. */
+  pearFee: SignedDecimalString.optional(),
+  /** Microsecond-precision UTC instant, rendered exactly like the group's `at`. */
+  timestamp: z.iso.datetime(),
+  /** RECONCILED rows are superseded and never listed, so only these two states can appear. */
+  settlement: FillStatus.extract([
+    "PROVISIONAL",
+    "CONFIRMED"
+  ]),
+  executionId: z.uuid().optional(),
+  positionEffect: TradePositionEffect,
+  basisBefore: TradePositionState,
+  basisAfter: TradePositionState
+});
+const TradeGroup = z.object({
+  id: z.string().regex(/^(execution|fill):[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/),
+  executionId: z.uuid().optional(),
+  scheduleId: z.uuid().optional(),
+  triggerId: z.uuid().optional(),
+  connector: Connector,
+  /** Earliest fill instant in the group at microsecond precision; the cursor key. */
+  at: z.iso.datetime(),
+  /** Priced realized PnL minus every fee in the group; `+` is a gain. */
+  netCashflow: SignedDecimalString,
+  trades: z.array(TradeFill)
+});
+
+export { TradeFill, TradeGroup, TradePositionEffect, TradePositionState, TradeRealization };

package/dist/trade/index.d.ts

@@ -1,2 +1,4 @@
+export * from './entities';
 export * from './payloads';
+export * from './queries';
 export * from './responses';

package/dist/trade/index.js

@@ -1,2 +1,4 @@
+export * from './entities';
 export * from './payloads';
+export * from './queries';
 export * from './responses';

package/dist/trade/queries.d.ts

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+/** Cursor-paginated grouped Trade History query. */
+export declare const TradeListParams: z.ZodObject<{
+    cursor: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<number>>>;
+}, z.core.$strip>;
+export type TradeListParamsInput = z.input<typeof TradeListParams>;
+export type TradeListParams = z.output<typeof TradeListParams>;

package/dist/trade/queries.js

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+import { CursorFindParams } from '../common';
+
+const TradeListParams = CursorFindParams.extend({
+  /** Groups contain every fill in an execution, so keep pages bounded. */
+  limit: z.coerce.number().int().positive().max(100).optional().default(20)
+});
+
+export { TradeListParams };

package/dist/trade/responses.d.ts

@@ -1409,3 +1409,119 @@ export declare const CreateTradeCloseAllResponse: z.ZodObject<{
     }, z.core.$strip>], "intent">], "orderType">>;
 }, z.core.$strip>;
 export type CreateTradeCloseAllResponse = z.output<typeof CreateTradeCloseAllResponse>;
+/** One cursor page of execution-grouped fill history. */
+export declare const TradeListResponse: z.ZodObject<{
+    limit: z.ZodNumber;
+    nextCursor: z.ZodOptional<z.ZodString>;
+    groups: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        executionId: z.ZodOptional<z.ZodUUID>;
+        scheduleId: z.ZodOptional<z.ZodUUID>;
+        triggerId: z.ZodOptional<z.ZodUUID>;
+        connector: z.ZodEnum<{
+            hyperliquid: "hyperliquid";
+            binance: "binance";
+            bybit: "bybit";
+            okx: "okx";
+            lighter: "lighter";
+        }>;
+        at: z.ZodISODateTime;
+        netCashflow: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+        trades: z.ZodArray<z.ZodObject<{
+            id: z.ZodUUID;
+            positionId: z.ZodUUID;
+            symbol: z.ZodString;
+            connector: z.ZodEnum<{
+                hyperliquid: "hyperliquid";
+                binance: "binance";
+                bybit: "bybit";
+                okx: "okx";
+                lighter: "lighter";
+            }>;
+            side: z.ZodEnum<{
+                BUY: "BUY";
+                SELL: "SELL";
+            }>;
+            quantity: z.ZodString;
+            price: z.ZodString;
+            tradeFee: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>>;
+            pearFee: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>>;
+            timestamp: z.ZodISODateTime;
+            settlement: z.ZodEnum<{
+                PROVISIONAL: "PROVISIONAL";
+                CONFIRMED: "CONFIRMED";
+            }>;
+            executionId: z.ZodOptional<z.ZodUUID>;
+            positionEffect: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"OPEN">;
+                openedQuantity: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"INCREASE">;
+                increasedQuantity: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"REDUCE">;
+                reducedQuantity: z.ZodString;
+                realization: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"PRICED">;
+                    quantity: z.ZodString;
+                    entryPrice: z.ZodString;
+                    exitPrice: z.ZodString;
+                    grossPnl: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"UNPRICED">;
+                    quantity: z.ZodString;
+                }, z.core.$strip>], "kind">;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"CLOSE">;
+                reducedQuantity: z.ZodString;
+                realization: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"PRICED">;
+                    quantity: z.ZodString;
+                    entryPrice: z.ZodString;
+                    exitPrice: z.ZodString;
+                    grossPnl: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"UNPRICED">;
+                    quantity: z.ZodString;
+                }, z.core.$strip>], "kind">;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"FLIP">;
+                reducedQuantity: z.ZodString;
+                openedQuantity: z.ZodString;
+                realization: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"PRICED">;
+                    quantity: z.ZodString;
+                    entryPrice: z.ZodString;
+                    exitPrice: z.ZodString;
+                    grossPnl: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"UNPRICED">;
+                    quantity: z.ZodString;
+                }, z.core.$strip>], "kind">;
+            }, z.core.$strip>], "kind">;
+            basisBefore: z.ZodObject<{
+                signedQuantity: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+                basis: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"FLAT">;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"PRICED">;
+                    entryPrice: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"UNPRICED">;
+                }, z.core.$strip>], "kind">;
+            }, z.core.$strip>;
+            basisAfter: z.ZodObject<{
+                signedQuantity: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+                basis: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"FLAT">;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"PRICED">;
+                    entryPrice: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"UNPRICED">;
+                }, z.core.$strip>], "kind">;
+            }, z.core.$strip>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type TradeListResponse = z.output<typeof TradeListResponse>;

package/dist/trade/responses.js

@@ -1,5 +1,7 @@
 import { z } from 'zod';
+import { CursorResponse } from '../common';
 import { Execution } from '../execution/entities';
+import { TradeGroup } from './entities';
 
 const CreateTradeOpenResponse = z.object({
   execution: Execution
@@ -16,5 +18,8 @@ const CreateTradeReverseResponse = z.object({
 const CreateTradeCloseAllResponse = z.object({
   executions: z.array(Execution)
 });
+const TradeListResponse = CursorResponse.extend({
+  groups: z.array(TradeGroup)
+});
 
-export { CreateTradeAdjustResponse, CreateTradeCloseAllResponse, CreateTradeCloseResponse, CreateTradeOpenResponse, CreateTradeReverseResponse };
+export { CreateTradeAdjustResponse, CreateTradeCloseAllResponse, CreateTradeCloseResponse, CreateTradeOpenResponse, CreateTradeReverseResponse, TradeListResponse };

package/dist/trade-accounts/entities.d.ts

@@ -20,6 +20,10 @@ export declare const TradeAccount: z.ZodObject<{
         okx: "okx";
         lighter: "lighter";
     }>;
+    kind: z.ZodEnum<{
+        vault: "vault";
+        eoa: "eoa";
+    }>;
     exchangeIdentifier: z.ZodString;
     metadata: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
         agentWalletAddress: z.ZodString;

package/dist/trade-accounts/entities.js

@@ -17,6 +17,10 @@ const TradeAccount = z.object({
   id: z.uuid().describe("Trade account UUID"),
   alias: z.string().describe("User-defined trade account alias"),
   connector: Connector.describe("Exchange connector type"),
+  kind: z.enum([
+    "eoa",
+    "vault"
+  ]).describe("Whether the account trades an EOA or a Pear vault"),
   exchangeIdentifier: z.string().describe("User identifier on the exchange"),
   metadata: ConnectorMetadata.describe("Connector-specific metadata"),
   createdAt: z.string().describe("Creation timestamp (ISO 8601)"),

package/dist/trade-accounts/payloads.d.ts

@@ -109,6 +109,16 @@ export declare const CreateTradeAccount: z.ZodDiscriminatedUnion<[z.ZodObject<{
         l1_address: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
     }, z.core.$strip>;
 }, z.core.$strip>], "connector">;
+/**
+ * Payload to create a Pear-vault-backed Hyperliquid trade account. The backend
+ * generates and approves the API wallet itself (via pear-vault-service), so
+ * the payload carries no credentials.
+ */
+export declare const CreateVaultTradeAccount: z.ZodObject<{
+    vaultAddress: z.ZodPipe<z.ZodString, z.ZodTransform<`0x${string}`, string>>;
+    alias: z.ZodString;
+    idempotencyKey: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 /**
  * Payload to update a trade account
  */
@@ -174,6 +184,8 @@ export type CreateLighterCredentials = z.infer<typeof CreateLighterCredentials>;
 export type CreateLighterMetadata = z.infer<typeof CreateLighterMetadata>;
 export type CreateTradeAccountInput = z.input<typeof CreateTradeAccount>;
 export type CreateTradeAccount = z.output<typeof CreateTradeAccount>;
+export type CreateVaultTradeAccountInput = z.input<typeof CreateVaultTradeAccount>;
+export type CreateVaultTradeAccount = z.output<typeof CreateVaultTradeAccount>;
 export type UpdateTradeAccountInput = z.input<typeof UpdateTradeAccount>;
 export type UpdateTradeAccount = z.output<typeof UpdateTradeAccount>;
 export {};

package/dist/trade-accounts/payloads.js

@@ -104,6 +104,15 @@ const CreateTradeAccount = z.discriminatedUnion("connector", [
   CreateOkxAccount,
   CreateLighterAccount
 ]);
+const CreateVaultTradeAccount = z.object({
+  vaultAddress: EthereumAddress,
+  alias: AccountAlias,
+  /**
+  * Optional caller-supplied key. Reusing it attaches a transport retry to the first attempt;
+  * omitting it starts a new create attempt.
+  */
+  idempotencyKey: z.string().min(1).max(128).optional()
+});
 const UpdateTradeAccount = z.discriminatedUnion("connector", [
   UpdateHyperliquidAccount,
   UpdateBinanceAccount,
@@ -112,4 +121,4 @@ const UpdateTradeAccount = z.discriminatedUnion("connector", [
   UpdateLighterAccount
 ]);
 
-export { CreateTradeAccount, UpdateTradeAccount };
+export { CreateTradeAccount, CreateVaultTradeAccount, UpdateTradeAccount };