@pear-protocol/types 1.33.0 → 2.1.0

package/dist/portfolio/responses.d.ts

@@ -1,176 +1,185 @@
 import { z } from 'zod';
 export declare const PortfolioResponse: z.ZodObject<{
-    intervals: z.ZodNullable<z.ZodObject<{
-        oneDay: z.ZodArray<z.ZodObject<{
-            periodStart: z.ZodString;
-            periodEnd: z.ZodString;
-            volume: z.ZodNumber;
-            openInterest: z.ZodNumber;
-            winningTradesCount: z.ZodNumber;
-            winningTradesUsd: z.ZodNumber;
-            losingTradesCount: z.ZodNumber;
-            losingTradesUsd: z.ZodNumber;
-        }, z.core.$strip>>;
-        oneWeek: z.ZodArray<z.ZodObject<{
-            periodStart: z.ZodString;
-            periodEnd: z.ZodString;
-            volume: z.ZodNumber;
-            openInterest: z.ZodNumber;
-            winningTradesCount: z.ZodNumber;
-            winningTradesUsd: z.ZodNumber;
-            losingTradesCount: z.ZodNumber;
-            losingTradesUsd: z.ZodNumber;
-        }, z.core.$strip>>;
-        oneMonth: z.ZodArray<z.ZodObject<{
-            periodStart: z.ZodString;
-            periodEnd: z.ZodString;
-            volume: z.ZodNumber;
-            openInterest: z.ZodNumber;
-            winningTradesCount: z.ZodNumber;
-            winningTradesUsd: z.ZodNumber;
-            losingTradesCount: z.ZodNumber;
-            losingTradesUsd: z.ZodNumber;
-        }, z.core.$strip>>;
-        oneYear: z.ZodArray<z.ZodObject<{
-            periodStart: z.ZodString;
-            periodEnd: z.ZodString;
-            volume: z.ZodNumber;
-            openInterest: z.ZodNumber;
-            winningTradesCount: z.ZodNumber;
-            winningTradesUsd: z.ZodNumber;
-            losingTradesCount: z.ZodNumber;
-            losingTradesUsd: z.ZodNumber;
-        }, z.core.$strip>>;
-        all: z.ZodArray<z.ZodObject<{
-            periodStart: z.ZodString;
-            periodEnd: z.ZodString;
-            volume: z.ZodNumber;
-            openInterest: z.ZodNumber;
-            winningTradesCount: z.ZodNumber;
-            winningTradesUsd: z.ZodNumber;
-            losingTradesCount: z.ZodNumber;
-            losingTradesUsd: z.ZodNumber;
+    realizedCashflow: z.ZodObject<{
+        grossPnl: z.ZodNumber;
+        tradeFees: z.ZodNumber;
+        pearFees: z.ZodNumber;
+        netCashflow: z.ZodNumber;
+        funding: z.ZodNumber;
+        netCashflowWithFunding: z.ZodNumber;
+        undeterminedQuantityByAsset: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        fundingSynced: z.ZodBoolean;
+        intervals: z.ZodOptional<z.ZodObject<{
+            oneDay: z.ZodArray<z.ZodObject<{
+                grossPnl: z.ZodNumber;
+                tradeFees: z.ZodNumber;
+                pearFees: z.ZodNumber;
+                netCashflow: z.ZodNumber;
+                funding: z.ZodNumber;
+                netCashflowWithFunding: z.ZodNumber;
+                undeterminedQuantityByAsset: z.ZodRecord<z.ZodString, z.ZodNumber>;
+                periodStart: z.ZodString;
+                periodEnd: z.ZodString;
+            }, z.core.$strip>>;
+            oneWeek: z.ZodArray<z.ZodObject<{
+                grossPnl: z.ZodNumber;
+                tradeFees: z.ZodNumber;
+                pearFees: z.ZodNumber;
+                netCashflow: z.ZodNumber;
+                funding: z.ZodNumber;
+                netCashflowWithFunding: z.ZodNumber;
+                undeterminedQuantityByAsset: z.ZodRecord<z.ZodString, z.ZodNumber>;
+                periodStart: z.ZodString;
+                periodEnd: z.ZodString;
+            }, z.core.$strip>>;
+            oneMonth: z.ZodArray<z.ZodObject<{
+                grossPnl: z.ZodNumber;
+                tradeFees: z.ZodNumber;
+                pearFees: z.ZodNumber;
+                netCashflow: z.ZodNumber;
+                funding: z.ZodNumber;
+                netCashflowWithFunding: z.ZodNumber;
+                undeterminedQuantityByAsset: z.ZodRecord<z.ZodString, z.ZodNumber>;
+                periodStart: z.ZodString;
+                periodEnd: z.ZodString;
+            }, z.core.$strip>>;
+            oneYear: z.ZodArray<z.ZodObject<{
+                grossPnl: z.ZodNumber;
+                tradeFees: z.ZodNumber;
+                pearFees: z.ZodNumber;
+                netCashflow: z.ZodNumber;
+                funding: z.ZodNumber;
+                netCashflowWithFunding: z.ZodNumber;
+                undeterminedQuantityByAsset: z.ZodRecord<z.ZodString, z.ZodNumber>;
+                periodStart: z.ZodString;
+                periodEnd: z.ZodString;
+            }, z.core.$strip>>;
+            all: z.ZodArray<z.ZodObject<{
+                grossPnl: z.ZodNumber;
+                tradeFees: z.ZodNumber;
+                pearFees: z.ZodNumber;
+                netCashflow: z.ZodNumber;
+                funding: z.ZodNumber;
+                netCashflowWithFunding: z.ZodNumber;
+                undeterminedQuantityByAsset: z.ZodRecord<z.ZodString, z.ZodNumber>;
+                periodStart: z.ZodString;
+                periodEnd: z.ZodString;
+            }, z.core.$strip>>;
         }, z.core.$strip>>;
-    }, z.core.$strip>>;
-    overall: z.ZodObject<{
-        totalWinningTradesCount: z.ZodNumber;
-        totalLosingTradesCount: z.ZodNumber;
-        totalWinningUsd: z.ZodNumber;
-        totalLosingUsd: z.ZodNumber;
-        currentOpenInterest: z.ZodNumber;
-        currentTotalVolume: z.ZodNumber;
+    }, z.core.$strip>;
+    closedPositionStats: z.ZodObject<{
+        totalPositions: z.ZodNumber;
+        wins: z.ZodNumber;
+        losses: z.ZodNumber;
+        hitRate: z.ZodNullable<z.ZodNumber>;
+        profitFactor: z.ZodNullable<z.ZodNumber>;
+        avgWinSize: z.ZodNullable<z.ZodNumber>;
+        avgLossSize: z.ZodNullable<z.ZodNumber>;
+        netPnl: z.ZodNumber;
+        positionPnls: z.ZodArray<z.ZodNumber>;
+        positionReturns: z.ZodArray<z.ZodNumber>;
+    }, z.core.$strip>;
+    openSnapshot: z.ZodObject<{
+        openInterest: z.ZodNumber;
         unrealizedPnl: z.ZodNumber;
-        realizedPnl: z.ZodNumber;
-        totalFees: z.ZodNumber;
-        totalTrades: z.ZodNumber;
+    }, z.core.$strip>;
+    volume: z.ZodObject<{
+        total: z.ZodNumber;
+        intervals: z.ZodOptional<z.ZodObject<{
+            oneDay: z.ZodArray<z.ZodObject<{
+                periodStart: z.ZodString;
+                periodEnd: z.ZodString;
+                volume: z.ZodNumber;
+            }, z.core.$strip>>;
+            oneWeek: z.ZodArray<z.ZodObject<{
+                periodStart: z.ZodString;
+                periodEnd: z.ZodString;
+                volume: z.ZodNumber;
+            }, z.core.$strip>>;
+            oneMonth: z.ZodArray<z.ZodObject<{
+                periodStart: z.ZodString;
+                periodEnd: z.ZodString;
+                volume: z.ZodNumber;
+            }, z.core.$strip>>;
+            oneYear: z.ZodArray<z.ZodObject<{
+                periodStart: z.ZodString;
+                periodEnd: z.ZodString;
+                volume: z.ZodNumber;
+            }, z.core.$strip>>;
+            all: z.ZodArray<z.ZodObject<{
+                periodStart: z.ZodString;
+                periodEnd: z.ZodString;
+                volume: z.ZodNumber;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export type PortfolioResponse = z.output<typeof PortfolioResponse>;
 export declare const PortfolioAnalyticsResponse: z.ZodObject<{
     config: z.ZodObject<{
-        rollingWindowDays: z.ZodNumber;
         startDate: z.ZodString;
         endDate: z.ZodString;
+    }, z.core.$strip>;
+    realizedCashflow: z.ZodObject<{
+        grossPnl: z.ZodNumber;
+        tradeFees: z.ZodNumber;
+        pearFees: z.ZodNumber;
+        netCashflow: z.ZodNumber;
+        funding: z.ZodNumber;
+        netCashflowWithFunding: z.ZodNumber;
+        undeterminedQuantityByAsset: z.ZodRecord<z.ZodString, z.ZodNumber>;
         fundingSynced: z.ZodBoolean;
+        series: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            grossPnl: z.ZodNumber;
+            tradeFees: z.ZodNumber;
+            pearFees: z.ZodNumber;
+            netCashflow: z.ZodNumber;
+            funding: z.ZodNumber;
+            netCashflowWithFunding: z.ZodNumber;
+            undeterminedQuantityByAsset: z.ZodRecord<z.ZodString, z.ZodNumber>;
+            periodStart: z.ZodString;
+            periodEnd: z.ZodString;
+        }, z.core.$strip>>>;
     }, z.core.$strip>;
-    portfolio: z.ZodObject<{
-        realizedOnly: z.ZodObject<{
-            pnlAbsolute: z.ZodNumber;
-            pnlPercent: z.ZodNullable<z.ZodNumber>;
-            hitRate: z.ZodNullable<z.ZodNumber>;
-            profitFactor: z.ZodNullable<z.ZodNumber>;
-            avgWinSize: z.ZodNullable<z.ZodNumber>;
-            avgLossSize: z.ZodNullable<z.ZodNumber>;
-            avgReturnPerWin: z.ZodNullable<z.ZodNumber>;
-            avgReturnPerLoss: z.ZodNullable<z.ZodNumber>;
-            maxDrawdown: z.ZodNullable<z.ZodNumber>;
-            sharpeRatio: z.ZodNullable<z.ZodNumber>;
-            sortinoRatio: z.ZodNullable<z.ZodNumber>;
-        }, z.core.$strip>;
-        realizedPlusUnrealized: z.ZodObject<{
-            pnlAbsolute: z.ZodNumber;
-            pnlPercent: z.ZodNullable<z.ZodNumber>;
-            hitRate: z.ZodNullable<z.ZodNumber>;
-            profitFactor: z.ZodNullable<z.ZodNumber>;
-            avgWinSize: z.ZodNullable<z.ZodNumber>;
-            avgLossSize: z.ZodNullable<z.ZodNumber>;
-            avgReturnPerWin: z.ZodNullable<z.ZodNumber>;
-            avgReturnPerLoss: z.ZodNullable<z.ZodNumber>;
-            maxDrawdown: z.ZodNullable<z.ZodNumber>;
-            sharpeRatio: z.ZodNullable<z.ZodNumber>;
-            sortinoRatio: z.ZodNullable<z.ZodNumber>;
-        }, z.core.$strip>;
-        realizedHitRate: z.ZodNullable<z.ZodNumber>;
+    closedPositionStats: z.ZodObject<{
+        totalPositions: z.ZodNumber;
+        wins: z.ZodNumber;
+        losses: z.ZodNumber;
+        hitRate: z.ZodNullable<z.ZodNumber>;
         profitFactor: z.ZodNullable<z.ZodNumber>;
         avgWinSize: z.ZodNullable<z.ZodNumber>;
         avgLossSize: z.ZodNullable<z.ZodNumber>;
-        breakevenHitRate: z.ZodNullable<z.ZodNumber>;
-        cushion: z.ZodNullable<z.ZodNumber>;
+        netPnl: z.ZodNumber;
+        positionPnls: z.ZodArray<z.ZodNumber>;
+        positionReturns: z.ZodArray<z.ZodNumber>;
     }, z.core.$strip>;
-    assets: z.ZodArray<z.ZodObject<{
-        asset: z.ZodString;
-        realizedOnly: z.ZodObject<{
-            pnlAbsolute: z.ZodNumber;
-            pnlPercent: z.ZodNullable<z.ZodNumber>;
-            hitRate: z.ZodNullable<z.ZodNumber>;
-            profitFactor: z.ZodNullable<z.ZodNumber>;
-            avgWinSize: z.ZodNullable<z.ZodNumber>;
-            avgLossSize: z.ZodNullable<z.ZodNumber>;
-            avgReturnPerWin: z.ZodNullable<z.ZodNumber>;
-            avgReturnPerLoss: z.ZodNullable<z.ZodNumber>;
-            maxDrawdown: z.ZodNullable<z.ZodNumber>;
-            sharpeRatio: z.ZodNullable<z.ZodNumber>;
-            sortinoRatio: z.ZodNullable<z.ZodNumber>;
-        }, z.core.$strip>;
-        realizedPlusUnrealized: z.ZodObject<{
-            pnlAbsolute: z.ZodNumber;
-            pnlPercent: z.ZodNullable<z.ZodNumber>;
-            hitRate: z.ZodNullable<z.ZodNumber>;
-            profitFactor: z.ZodNullable<z.ZodNumber>;
-            avgWinSize: z.ZodNullable<z.ZodNumber>;
-            avgLossSize: z.ZodNullable<z.ZodNumber>;
-            avgReturnPerWin: z.ZodNullable<z.ZodNumber>;
-            avgReturnPerLoss: z.ZodNullable<z.ZodNumber>;
-            maxDrawdown: z.ZodNullable<z.ZodNumber>;
-            sharpeRatio: z.ZodNullable<z.ZodNumber>;
-            sortinoRatio: z.ZodNullable<z.ZodNumber>;
-        }, z.core.$strip>;
-        unrealizedReturnPerDay: z.ZodNullable<z.ZodNumber>;
-    }, z.core.$strip>>;
-    pairs: z.ZodArray<z.ZodObject<{
+    pairBreakdown: z.ZodArray<z.ZodObject<{
         key: z.ZodString;
         longAssets: z.ZodArray<z.ZodString>;
         shortAssets: z.ZodArray<z.ZodString>;
-        trades: z.ZodNumber;
+        positions: z.ZodNumber;
         wins: z.ZodNumber;
         losses: z.ZodNumber;
         hitRate: z.ZodNullable<z.ZodNumber>;
-        avgWinSize: z.ZodNullable<z.ZodNumber>;
-        avgLossSize: z.ZodNullable<z.ZodNumber>;
-        expectancy: z.ZodNullable<z.ZodNumber>;
-        totalPnl: z.ZodNumber;
+        profitFactor: z.ZodNullable<z.ZodNumber>;
+        expectancy: z.ZodNumber;
+        grossPnl: z.ZodNumber;
+        tradeFees: z.ZodNumber;
+        pearFees: z.ZodNumber;
+        netPnl: z.ZodNumber;
         bookPercent: z.ZodNullable<z.ZodNumber>;
     }, z.core.$strip>>;
-    series: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        date: z.ZodString;
-        trades: z.ZodNumber;
-        wins: z.ZodNumber;
-        losses: z.ZodNumber;
-        dayPnl: z.ZodNumber;
-        dayVolume: z.ZodNumber;
-        dayFunding: z.ZodNumber;
-        dayNetPnl: z.ZodNumber;
-        hitRate: z.ZodNullable<z.ZodNumber>;
-        winLossRatio: z.ZodNullable<z.ZodNumber>;
-        rollingHitRate: z.ZodNullable<z.ZodNumber>;
-        rollingWinLossRatio: z.ZodNullable<z.ZodNumber>;
-        dailyReturn: z.ZodNullable<z.ZodNumber>;
-        cumulativeReturn: z.ZodNumber;
-        equity: z.ZodNumber;
-        drawdown: z.ZodNumber;
-        rollingSharpe: z.ZodNullable<z.ZodNumber>;
-        rollingSortino: z.ZodNullable<z.ZodNumber>;
-        rollingVolatility: z.ZodNullable<z.ZodNumber>;
-    }, z.core.$strip>>>;
+    openSnapshot: z.ZodObject<{
+        openInterest: z.ZodNumber;
+        unrealizedPnl: z.ZodNumber;
+    }, z.core.$strip>;
+    volume: z.ZodObject<{
+        total: z.ZodNumber;
+        series: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            periodStart: z.ZodString;
+            periodEnd: z.ZodString;
+            volume: z.ZodNumber;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>;
 }, z.core.$strip>;
 export type PortfolioAnalyticsResponse = z.output<typeof PortfolioAnalyticsResponse>;

package/dist/portfolio/responses.js

@@ -1,16 +1,29 @@
 import { z } from 'zod';
-import { PortfolioOverall, PortfolioIntervals, PortfolioMetrics, PortfolioAnalyticsConfig, PortfolioSeriesPoint, PortfolioPairBreakdown, PortfolioAssetAnalytics } from './entities';
+import { PortfolioOpenSnapshot, PortfolioClosedPositionStats, PortfolioVolumeAmounts, PortfolioVolumeIntervals, PortfolioCashflowAmounts, PortfolioCashflowIntervals, PortfolioAnalyticsConfig, PortfolioVolumeSeriesPoint, PortfolioPairBreakdown, PortfolioCashflowSeriesPoint } from './entities';
 
 const PortfolioResponse = z.object({
-  intervals: PortfolioIntervals.nullable(),
-  overall: PortfolioOverall
+  realizedCashflow: PortfolioCashflowAmounts.extend({
+    fundingSynced: z.boolean(),
+    intervals: PortfolioCashflowIntervals.optional()
+  }),
+  closedPositionStats: PortfolioClosedPositionStats,
+  openSnapshot: PortfolioOpenSnapshot,
+  volume: PortfolioVolumeAmounts.extend({
+    intervals: PortfolioVolumeIntervals.optional()
+  })
 });
 const PortfolioAnalyticsResponse = z.object({
   config: PortfolioAnalyticsConfig,
-  portfolio: PortfolioMetrics,
-  assets: z.array(PortfolioAssetAnalytics),
-  pairs: z.array(PortfolioPairBreakdown),
-  series: z.array(PortfolioSeriesPoint).optional()
+  realizedCashflow: PortfolioCashflowAmounts.extend({
+    fundingSynced: z.boolean(),
+    series: z.array(PortfolioCashflowSeriesPoint).optional()
+  }),
+  closedPositionStats: PortfolioClosedPositionStats,
+  pairBreakdown: z.array(PortfolioPairBreakdown),
+  openSnapshot: PortfolioOpenSnapshot,
+  volume: PortfolioVolumeAmounts.extend({
+    series: z.array(PortfolioVolumeSeriesPoint).optional()
+  })
 });
 
 export { PortfolioAnalyticsResponse, PortfolioResponse };

package/dist/position/entities.d.ts

@@ -43,7 +43,8 @@ export type PositionInitialExposureUSD = z.infer<typeof PositionInitialExposureU
  * negative = net paid). Derived by walking the position's exposure snapshots and
  * summing each in-window funding event as `exposure × fundingPerUnit`. Across a
  * fully-tracked account the per-position shares sum to the account funding (up to
- * 20-dp rounding of the coefficient).
+ * 20-dp rounding of the coefficient); untracked or external exposure sharing the
+ * account under-attributes the shares, so the account-level total stays authoritative.
  *
  * @example { '0': '-1.25' } means 1.25 USD of BTC funding paid over the position's life
  */
@@ -92,11 +93,11 @@ export declare const Position: z.ZodObject<{
 }, z.core.$strip>;
 export type Position = z.output<typeof Position>;
 /** Which way a closed basket's leg was held. */
-export declare const ClosedTradeLegSide: z.ZodEnum<{
+export declare const ClosedPositionLegSide: z.ZodEnum<{
     LONG: "LONG";
     SHORT: "SHORT";
 }>;
-export type ClosedTradeLegSide = z.output<typeof ClosedTradeLegSide>;
+export type ClosedPositionLegSide = z.output<typeof ClosedPositionLegSide>;
 /**
  * What one asset did inside one step.
  *
@@ -107,7 +108,7 @@ export type ClosedTradeLegSide = z.output<typeof ClosedTradeLegSide>;
  * value it. Collapsing it into REDUCE would invent a basis; collapsing it into
  * INCREASE would report a close as an add.
  */
-export declare const ClosedTradeStepLeg: z.ZodDiscriminatedUnion<[z.ZodObject<{
+export declare const PositionStepLeg: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"INCREASE">;
     asset: z.ZodString;
     side: z.ZodEnum<{
@@ -142,7 +143,7 @@ export declare const ClosedTradeStepLeg: z.ZodDiscriminatedUnion<[z.ZodObject<{
     tradeFee: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
     pearFee: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
 }, z.core.$strip>], "kind">;
-export type ClosedTradeStepLeg = z.output<typeof ClosedTradeStepLeg>;
+export type PositionStepLeg = z.output<typeof PositionStepLeg>;
 /**
  * One action taken on the position, in the order it happened: the open, each add, each
  * reduction, and the close.
@@ -153,7 +154,7 @@ export type ClosedTradeStepLeg = z.output<typeof ClosedTradeStepLeg>;
  * genuinely separate actions sharing an instant therefore merge into one step; the
  * `executionId` being absent is the signal that a step was grouped this way.
  */
-export declare const ClosedTradeStep: z.ZodObject<{
+export declare const PositionStep: z.ZodObject<{
     executionId: z.ZodOptional<z.ZodString>;
     at: z.ZodString;
     grossPnl: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
@@ -193,15 +194,15 @@ export declare const ClosedTradeStep: z.ZodObject<{
         pearFee: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
     }, z.core.$strip>], "kind">>;
 }, z.core.$strip>;
-export type ClosedTradeStep = z.output<typeof ClosedTradeStep>;
+export type PositionStep = z.output<typeof PositionStep>;
 /**
- * One leg of a closed trade, with its own entry and exit economics.
+ * One leg of a closed position, with its own entry and exit economics.
  *
  * Both optional prices are absent rather than "0" whenever they cannot be derived:
  * "0" is a real price, and claiming one the ledger never recorded would be a lie.
  * Absence is the honest answer.
  */
-export declare const ClosedTradeLeg: z.ZodObject<{
+export declare const ClosedPositionLeg: z.ZodObject<{
     asset: z.ZodString;
     side: z.ZodEnum<{
         LONG: "LONG";
@@ -219,12 +220,12 @@ export declare const ClosedTradeLeg: z.ZodObject<{
     exitQuantity: z.ZodString;
     undeterminedSize: z.ZodString;
 }, z.core.$strip>;
-export type ClosedTradeLeg = z.output<typeof ClosedTradeLeg>;
+export type ClosedPositionLeg = z.output<typeof ClosedPositionLeg>;
 /**
- * One closed position, composed server-side into the trade a trader recognises:
+ * One closed position, composed server-side into the history row a trader recognises:
  * what it earned, what it cost, and what each leg did.
  */
-export declare const ClosedTrade: z.ZodObject<{
+export declare const ClosedPosition: z.ZodObject<{
     positionId: z.ZodUUID;
     connector: z.ZodEnum<{
         hyperliquid: "hyperliquid";
@@ -233,6 +234,7 @@ export declare const ClosedTrade: z.ZodObject<{
         okx: "okx";
         lighter: "lighter";
     }>;
+    status: z.ZodLiteral<"CLOSED">;
     openedAt: z.ZodString;
     closedAt: z.ZodString;
     closedReason: z.ZodOptional<z.ZodEnum<{
@@ -317,4 +319,137 @@ export declare const ClosedTrade: z.ZodObject<{
         }, z.core.$strip>], "kind">>;
     }, z.core.$strip>>>;
 }, z.core.$strip>;
-export type ClosedTrade = z.output<typeof ClosedTrade>;
+export type ClosedPosition = z.output<typeof ClosedPosition>;
+/**
+ * What one leg of an open basket has booked, and what it still holds.
+ *
+ * Split on the only axis that exists here: `realized` describes quantity the ledger has
+ * already closed, `remaining` the quantity it still carries. Fees and funding stay flat
+ * because they are neither — both are charged across the leg's whole life, on entry fills
+ * as well as exit ones, so nesting them under `realized` would misreport what they cover.
+ *
+ * `remaining` holds no PnL — which is why it is not named `unrealized`. This endpoint
+ * reads no mark price by design, so it reports the inputs an unrealized figure is
+ * computed from — size and basis — and leaves the marking to a caller that has a price.
+ */
+export declare const OpenPositionLeg: z.ZodObject<{
+    asset: z.ZodString;
+    side: z.ZodEnum<{
+        LONG: "LONG";
+        SHORT: "SHORT";
+    }>;
+    realized: z.ZodObject<{
+        quantity: z.ZodString;
+        unpricedQuantity: z.ZodString;
+        exitVwap: z.ZodOptional<z.ZodString>;
+        grossPnl: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+        netPnl: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+    }, z.core.$strip>;
+    remaining: z.ZodObject<{
+        quantity: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+        entryVwap: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    totalFees: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+    tradeFees: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+    pearFees: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+    funding: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+}, z.core.$strip>;
+export type OpenPositionLeg = z.output<typeof OpenPositionLeg>;
+/**
+ * The realized view of one open position: the part of it that has already been booked,
+ * composed server-side from the same math /positions/closed uses.
+ *
+ * A pure ledger read — no mark price and therefore no unrealized PnL, which
+ * /positions and /portfolio's openSnapshot already carry.
+ */
+export declare const OpenPosition: z.ZodObject<{
+    positionId: z.ZodUUID;
+    connector: z.ZodEnum<{
+        hyperliquid: "hyperliquid";
+        binance: "binance";
+        bybit: "bybit";
+        okx: "okx";
+        lighter: "lighter";
+    }>;
+    status: z.ZodLiteral<"OPEN">;
+    openedAt: z.ZodString;
+    updatedAt: z.ZodString;
+    origin: z.ZodEnum<{
+        PARTIAL: "PARTIAL";
+        PEAR: "PEAR";
+        EXTERNAL: "EXTERNAL";
+    }>;
+    realizedGrossPnl: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+    netCashflow: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+    totalFees: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+    tradeFees: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+    pearFees: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+    totalFunding: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+    initialExposureUSD: z.ZodRecord<z.ZodString, z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>>;
+    hasSyntheticFills: z.ZodBoolean;
+    hasProvisionalFills: z.ZodBoolean;
+    unstableHistoricalData: z.ZodBoolean;
+    legs: z.ZodArray<z.ZodObject<{
+        asset: z.ZodString;
+        side: z.ZodEnum<{
+            LONG: "LONG";
+            SHORT: "SHORT";
+        }>;
+        realized: z.ZodObject<{
+            quantity: z.ZodString;
+            unpricedQuantity: z.ZodString;
+            exitVwap: z.ZodOptional<z.ZodString>;
+            grossPnl: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+            netPnl: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+        }, z.core.$strip>;
+        remaining: z.ZodObject<{
+            quantity: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+            entryVwap: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        totalFees: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+        tradeFees: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+        pearFees: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+        funding: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+    }, z.core.$strip>>;
+    steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        executionId: z.ZodOptional<z.ZodString>;
+        at: z.ZodString;
+        grossPnl: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+        legs: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"INCREASE">;
+            asset: z.ZodString;
+            side: z.ZodEnum<{
+                BUY: "BUY";
+                SELL: "SELL";
+            }>;
+            quantity: z.ZodString;
+            price: z.ZodString;
+            tradeFee: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+            pearFee: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"REDUCE">;
+            asset: z.ZodString;
+            side: z.ZodEnum<{
+                BUY: "BUY";
+                SELL: "SELL";
+            }>;
+            quantity: z.ZodString;
+            price: z.ZodString;
+            entryBasis: z.ZodString;
+            grossPnl: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+            tradeFee: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+            pearFee: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"REDUCE_UNPRICED">;
+            asset: z.ZodString;
+            side: z.ZodEnum<{
+                BUY: "BUY";
+                SELL: "SELL";
+            }>;
+            quantity: z.ZodString;
+            tradeFee: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+            pearFee: z.ZodPipe<z.ZodString, z.ZodTransform<`-${string}` | `+${string}`, string>>;
+        }, z.core.$strip>], "kind">>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type OpenPosition = z.output<typeof OpenPosition>;