@0xmonaco/types 0.8.21 → 0.8.22

package/README.md

@@ -202,50 +202,62 @@ Types for market data operations including trading pair metadata:
 import {
   MarketAPI,
   TradingPair,
+  GetTradingPairsParams,
   GetTradingPairsResponse,
   GetTradingPairResponse,
+  TradingMode,
 } from "@0xmonaco/types";
 
 // Market operations
 interface MarketAPI extends BaseAPI {
-  getTradingPairs(): Promise<TradingPair[]>;
-  getTradingPairBySymbol(symbol: string): Promise<TradingPair | undefined>;
+  getPaginatedTradingPairs(
+    params?: GetTradingPairsParams,
+  ): Promise<GetTradingPairsResponse>;
+  getTradingPair(tradingPairId: string): Promise<TradingPair>;
+  getTradingPairBySymbol(
+    symbol: string,
+    marketType?: TradingMode,
+  ): Promise<TradingPair | undefined>;
 }
 
 // Market data types
 interface TradingPair {
   id: string;
   symbol: string;
-  base_token: string;
-  quote_token: string;
-  base_token_contract: string;
-  quote_token_contract: string;
-  base_decimals: number;
-  quote_decimals: number;
-  market_type: string;
-  is_active: boolean;
-  maker_fee_bps: number;
-  taker_fee_bps: number;
-  min_order_size: string;
-  max_order_size: string;
-  tick_size: string;
+  baseToken: string;
+  quoteToken: string;
+  baseAssetId: string;
+  quoteAssetId: string;
+  baseTokenContract: string;
+  quoteTokenContract: string;
+  baseDecimals: number;
+  baseIconUrl: string;
+  quoteDecimals: number;
+  quoteIconUrl: string;
+  marketType: TradingMode;
+  category: string;
+  isActive: boolean;
+  makerFeeBps: number;
+  takerFeeBps: number;
+  minOrderSize: string;
+  maxOrderSize: string;
+  quantityStepSize: string;
+  tickSize: string;
+  minLeverage?: string | null;
+  maxLeverage?: string | null;
 }
 
 // Market response types
 interface GetTradingPairsResponse {
-  data: {
-    data: TradingPair[];
-    limit: number;
-    page: number;
-    total: number;
-    total_pages: number;
-  };
-  success: boolean;
+  tradingPairs: TradingPair[];
+  page: number;
+  pageSize: number;
+  total: number;
+  totalPages: number;
 }
 
 interface GetTradingPairResponse {
-  data: TradingPair;
-  success: boolean;
+  tradingPair: TradingPair;
 }
 ```
 

package/dist/market/index.d.ts

@@ -48,6 +48,8 @@ export interface TradingPair {
     minOrderSize: string;
     /** Maximum order size */
     maxOrderSize: string;
+    /** Minimum order quantity increment (lot size step) */
+    quantityStepSize: string;
     /** Tick size for price increments */
     tickSize: string;
     /** Minimum supported leverage for margin markets (optional, margin only) */

package/dist/positions/index.d.ts

@@ -18,7 +18,15 @@ export interface Position {
     realizedPnl: string;
     isolatedMargin: string;
     leverage?: string;
+    /**
+     * Position-scoped requirement at markPrice using the market
+     * maintenance-margin rate; zero without open exposure.
+     */
     maintenanceMarginRequired: string;
+    /**
+     * Position-scoped requirement at markPrice honoring effective leverage and
+     * the market initial-margin floor; zero without open exposure.
+     */
     initialMarginRequired?: string;
     liquidationPrice: string;
     status: PositionStatus;
@@ -78,7 +86,15 @@ export interface PositionRisk {
     unrealizedPnl: string;
     liquidationPrice: string;
     marginRatio: string;
+    /**
+     * Position-scoped requirement at markPrice using the market
+     * maintenance-margin rate; zero without open exposure.
+     */
     maintenanceMarginRequired: string;
+    /**
+     * Position-scoped requirement at markPrice honoring effective leverage and
+     * the market initial-margin floor; zero without open exposure.
+     */
     initialMarginRequired?: string;
     updatedAt: string;
 }
@@ -140,6 +156,57 @@ export interface ListPositionHistoryResponse {
     page: number;
     pageSize: number;
 }
+/**
+ * Sample interval for position PnL history queries (matches the candles
+ * interval ladder).
+ */
+export type PnlHistoryInterval = "1m" | "5m" | "15m" | "1h" | "4h" | "1d";
+/**
+ * Query parameters for position PnL history.
+ */
+export interface GetPositionPnlHistoryParams {
+    /** Sample interval */
+    interval: PnlHistoryInterval;
+    /** Start time as Unix timestamp in milliseconds (defaults to the interval's maximum lookback) */
+    startTime?: number;
+    /** End time as Unix timestamp in milliseconds (defaults to now) */
+    endTime?: number;
+}
+/**
+ * One PnL state sample for a position in one bucket. Cumulative fields are
+ * lifetime values as of the bucket; `cumFundingPaid` and `cumFees` are
+ * cost-positive (positive means paid/charged).
+ */
+export interface PositionPnlPoint {
+    /** Bucket start timestamp (ISO 8601) */
+    bucketStart: string;
+    /** Signed position quantity (negative for shorts) */
+    quantity: string;
+    /** Average entry price */
+    entryPrice: string;
+    /** Mark price at the sample */
+    markPrice: string;
+    /** Unrealized PnL at the sample: quantity x (mark - entry) */
+    unrealizedPnl: string;
+    /** Cumulative realized PnL, gross of fees */
+    cumRealizedPnl: string;
+    /** Cumulative funding paid; positive means paid, negative means received */
+    cumFundingPaid: string;
+    /** Cumulative trading fees; positive means charged, negative means rebated */
+    cumFees: string;
+}
+/**
+ * Position PnL history response.
+ * Returned by the /api/v1/positions/{positionId}/pnl/history endpoint.
+ */
+export interface GetPositionPnlHistoryResponse {
+    /** Position UUID */
+    positionId: string;
+    /** Interval used for this query */
+    interval: PnlHistoryInterval;
+    /** Forward-filled PnL state samples, oldest first */
+    data: PositionPnlPoint[];
+}
 export interface PositionsAPI extends BaseAPI {
     listPositions(params?: ListPositionsParams): Promise<ListPositionsResponse>;
     getPosition(positionId: string): Promise<GetPositionResponse>;
@@ -150,4 +217,5 @@ export interface PositionsAPI extends BaseAPI {
     reducePositionMargin(positionId: string, request: ReducePositionMarginRequest): Promise<PositionMarginResponse>;
     attachPositionTpSl(positionId: string, request: AttachPositionTpSlRequest): Promise<AttachPositionTpSlResponse>;
     listPositionHistory(params?: ListPositionHistoryParams): Promise<ListPositionHistoryResponse>;
+    getPositionPnlHistory(positionId: string, params: GetPositionPnlHistoryParams): Promise<GetPositionPnlHistoryResponse>;
 }

package/dist/profile/index.d.ts

@@ -320,8 +320,15 @@ export interface ListFundingPaymentsResponse {
 export type PortfolioPeriod = "24h" | "7d" | "30d" | "all";
 /**
  * Metric for portfolio chart queries.
+ *
+ * `volume` buckets trade volume and `pnl` is the legacy realized-only
+ * net-of-fees series. The remaining metrics are served from PnL history
+ * snapshots, forward-filled per bucket: `realized_pnl`, `funding_paid`, and
+ * `fees` are cumulative lifetime series; `unrealized_pnl`, `total_pnl`, and
+ * `equity` are state series. `funding_paid` is cost-positive (positive means
+ * paid) — negate for display as a PnL contribution.
  */
-export type PortfolioMetric = "volume" | "pnl";
+export type PortfolioMetric = "volume" | "pnl" | "unrealized_pnl" | "total_pnl" | "realized_pnl" | "funding_paid" | "fees" | "equity";
 /**
  * A single data point in a portfolio chart time series.
  */
@@ -343,11 +350,35 @@ export interface PortfolioChartResponse {
     /** Bucketed time series data points */
     data: PortfolioChartPoint[];
 }
+/**
+ * Lifetime PnL components for the authenticated user. The fields satisfy
+ * `totalPnl = (spotRealized + perpsRealized) + (spotUnrealized + perpsUnrealized) - fundingPaid - fees`.
+ */
+export interface PnlBreakdown {
+    /** Cumulative realized spot PnL, average-cost basis, gross of fees; withdrawals realize at fair value */
+    spotRealized: string;
+    /** Unrealized PnL on current spot holdings: quantity x (latest close - average cost) */
+    spotUnrealized: string;
+    /** Cumulative realized perps PnL, gross of fees */
+    perpsRealized: string;
+    /** Unrealized PnL on open perp positions: quantity x (mark - entry) */
+    perpsUnrealized: string;
+    /** Cumulative funding paid; positive means paid, negative means received. Subtracted in totalPnl. */
+    fundingPaid: string;
+    /** Cumulative trading fees; positive means charged, negative means rebated. Subtracted in totalPnl. */
+    fees: string;
+}
 /**
  * Portfolio statistics for the authenticated user over a given period.
  * Returned by the /api/v1/accounts/me/portfolio endpoint.
  */
 export interface PortfolioStats {
+    /** Current unrealized PnL across spot holdings and open perp positions. Live value, independent of the period. */
+    unrealizedPnl: string;
+    /** Current lifetime total PnL: realized + unrealized - fundingPaid - fees. Live value, independent of the period. */
+    totalPnl: string;
+    /** Lifetime PnL components behind totalPnl */
+    pnlBreakdown: PnlBreakdown | null;
     /**
      * Realized PnL over the period on an average-cost basis: gains/losses are
      * booked only when a position is reduced or closed, net of fees, across spot

package/dist/validation/positions.d.ts

@@ -91,3 +91,18 @@ export declare const ListPositionHistorySchema: z.ZodObject<{
     marginAccountId: z.ZodOptional<z.ZodUUID>;
     tradingPairId: z.ZodOptional<z.ZodUUID>;
 }, z.core.$strip>;
+export declare const GetPositionPnlHistorySchema: z.ZodObject<{
+    positionId: z.ZodUUID;
+    params: z.ZodObject<{
+        interval: z.ZodEnum<{
+            "1m": "1m";
+            "5m": "5m";
+            "15m": "15m";
+            "1h": "1h";
+            "4h": "4h";
+            "1d": "1d";
+        }>;
+        startTime: z.ZodOptional<z.ZodNumber>;
+        endTime: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+}, z.core.$strip>;

package/dist/validation/positions.js

@@ -95,3 +95,18 @@ export const ListPositionHistorySchema = PaginationSchema.extend({
     marginAccountId: UUIDSchema.optional(),
     tradingPairId: UUIDSchema.optional(),
 });
+const PnlHistoryIntervalSchema = z.enum(["1m", "5m", "15m", "1h", "4h", "1d"], {
+    message: 'Interval must be one of "1m", "5m", "15m", "1h", "4h", "1d"',
+});
+export const GetPositionPnlHistorySchema = PositionIdSchema.extend({
+    params: z
+        .object({
+        interval: PnlHistoryIntervalSchema,
+        startTime: z.number().int().min(0, "startTime must be a non-negative millisecond timestamp").optional(),
+        endTime: z.number().int().min(0, "endTime must be a non-negative millisecond timestamp").optional(),
+    })
+        .refine((data) => data.startTime === undefined || data.endTime === undefined || data.startTime < data.endTime, {
+        message: "startTime must be less than endTime",
+        path: ["startTime"],
+    }),
+});

package/dist/wire/operations.d.ts

@@ -10,6 +10,6 @@
  * hand-written SDK surface. CI regenerates it and fails on a diff, identical to
  * the `schema.ts` wire-types tripwire (MON-1476), so it can never go stale.
  */
-export declare const OPERATION_IDS: readonly ["add_position_margin", "attach_position_tp_sl", "authenticate_backend", "batch_cancel_all", "batch_cancel_all_by_pair", "batch_cancel_orders", "batch_close_all_positions", "batch_create_orders", "batch_replace_orders", "cancel_conditional_order", "cancel_order", "close_position", "create_challenge", "create_delegated_session", "create_order", "create_sub_account_limit", "delete_sub_account_limit", "get_application_config", "get_application_stats", "get_available_collateral", "get_candles", "get_conditional_order", "get_funding_state", "get_index_price", "get_margin_account_movements", "get_margin_account_summary", "get_mark_price", "get_market_metadata", "get_market_stats", "get_my_fee_tier", "get_open_interest", "get_order_by_id", "get_orderbook_snapshot", "get_orders", "get_parent_margin_account_movements", "get_parent_margin_account_summary", "get_perp_market_config", "get_perp_market_summary", "get_portfolio_chart", "get_portfolio_stats", "get_position", "get_position_risk", "get_screener", "get_sub_account_limits", "get_trade_by_id", "get_trades", "get_trading_pair_by_id", "get_user_balance_by_asset", "get_user_balances", "get_user_movements", "get_user_profile", "get_user_trades", "get_withdrawal", "health_check", "initiate_withdrawal", "list_application_balances", "list_application_movements", "list_application_orders", "list_application_users", "list_conditional_orders", "list_delegated_agent_owners", "list_delegated_agents", "list_funding_history", "list_funding_payments", "list_margin_accounts", "list_pending_withdrawals", "list_position_history", "list_positions", "list_sub_accounts_with_balances", "list_trading_pairs", "mint_tokens", "reduce_position_margin", "refresh_session", "replace_order", "revoke_delegated_agent", "revoke_session", "simulate_fees", "simulate_order_risk", "simulate_parent_margin_order_risk", "simulate_risk_bucket_order_risk", "submit_whitelist", "transfer_collateral_from_margin_account", "transfer_collateral_from_parent_margin_account", "transfer_collateral_to_margin_account", "transfer_collateral_to_parent_margin_account", "transfer_collateral_to_risk_bucket", "update_sub_account_limit", "upsert_delegated_agent", "verify_signature"];
+export declare const OPERATION_IDS: readonly ["add_position_margin", "attach_position_tp_sl", "authenticate_backend", "batch_cancel_all", "batch_cancel_all_by_pair", "batch_cancel_orders", "batch_close_all_positions", "batch_create_orders", "batch_replace_orders", "cancel_conditional_order", "cancel_order", "close_position", "create_challenge", "create_delegated_session", "create_order", "create_sub_account_limit", "delete_sub_account_limit", "get_application_config", "get_application_stats", "get_available_collateral", "get_candles", "get_conditional_order", "get_funding_state", "get_index_price", "get_margin_account_movements", "get_margin_account_summary", "get_mark_price", "get_market_metadata", "get_market_stats", "get_my_fee_tier", "get_open_interest", "get_order_by_id", "get_orderbook_snapshot", "get_orders", "get_parent_margin_account_movements", "get_parent_margin_account_summary", "get_perp_market_config", "get_perp_market_summary", "get_portfolio_chart", "get_portfolio_stats", "get_position", "get_position_pnl_history", "get_position_risk", "get_screener", "get_sub_account_limits", "get_trade_by_id", "get_trades", "get_trading_pair_by_id", "get_user_balance_by_asset", "get_user_balances", "get_user_movements", "get_user_profile", "get_user_trades", "get_withdrawal", "health_check", "initiate_withdrawal", "list_application_balances", "list_application_movements", "list_application_orders", "list_application_users", "list_conditional_orders", "list_delegated_agent_owners", "list_delegated_agents", "list_funding_history", "list_funding_payments", "list_margin_accounts", "list_pending_withdrawals", "list_position_history", "list_positions", "list_sub_accounts_with_balances", "list_trading_pairs", "mint_tokens", "reduce_position_margin", "refresh_session", "replace_order", "revoke_delegated_agent", "revoke_session", "simulate_fees", "simulate_order_risk", "simulate_parent_margin_order_risk", "simulate_risk_bucket_order_risk", "submit_whitelist", "transfer_collateral_from_margin_account", "transfer_collateral_from_parent_margin_account", "transfer_collateral_to_margin_account", "transfer_collateral_to_parent_margin_account", "transfer_collateral_to_risk_bucket", "update_sub_account_limit", "upsert_delegated_agent", "verify_signature"];
 /** Union of every OpenAPI operationId in the spec. */
 export type OperationId = (typeof OPERATION_IDS)[number];

package/dist/wire/operations.js

@@ -52,6 +52,7 @@ export const OPERATION_IDS = [
     "get_portfolio_chart",
     "get_portfolio_stats",
     "get_position",
+    "get_position_pnl_history",
     "get_position_risk",
     "get_screener",
     "get_sub_account_limits",

package/dist/wire/schema.d.ts

@@ -1590,6 +1590,32 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/positions/{positionId}/pnl/history": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get position PnL history
+         * @description Get bucketed PnL history for one position.
+         *
+         *      Time series of PnL state samples (quantity, entry, mark, unrealized,
+         *      cumulative realized/funding/fees) for a position the caller owns, at the
+         *      requested interval. Buckets between samples are forward-filled; buckets
+         *      before the position's first sample are omitted. Distinct from
+         *      ListPositionHistory, which returns lifecycle events.
+         */
+        get: operations["get_position_pnl_history"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/positions/{positionId}/risk": {
         parameters: {
             query?: never;
@@ -3743,7 +3769,7 @@ export interface components {
              */
             feesPaid?: string | null;
             /**
-             * @description Realized PnL over the period, average-cost basis: gains/losses booked only when a position is reduced or closed, net of fees. Covers spot and perps (including funding). Excludes unrealized PnL on open positions.
+             * @description Legacy realized PnL over the period, average-cost basis: gains/losses booked only when a position is reduced or closed, net of fees, with funding folded in. Excludes unrealized PnL on open positions. For the full PnL picture use totalPnl and pnlBreakdown, whose components follow the gross-of-fees convention instead.
              * @example -0.01
              */
             pnl?: string | null;
@@ -3773,6 +3799,31 @@ export interface components {
              * @example 0.00
              */
             maxDrawdown?: string | null;
+            /**
+             * @description Current unrealized PnL across open spot holdings (cost basis vs latest close) and open perp positions (entry vs mark). A live value, independent of the period parameter.
+             * @example 12.34
+             */
+            unrealizedPnl?: string | null;
+            /**
+             * @description Current lifetime total PnL: realized + unrealized - fundingPaid - fees, with realized components gross of fees. A live value, independent of the period parameter; the addends are in pnlBreakdown.
+             * @example 10.11
+             */
+            totalPnl?: string | null;
+            pnlBreakdown?: components["schemas"]["PnlBreakdown"];
+        };
+        GetPositionPnlHistoryResponse: {
+            /**
+             * Format: uuid
+             * @description Position UUID
+             * @example 123e4567-e89b-12d3-a456-426614174000
+             */
+            positionId?: string | null;
+            /**
+             * @description Interval used for this query
+             * @example 1h
+             */
+            interval?: string | null;
+            data?: components["schemas"]["PositionPnlPoint"][] | null;
         };
         GetPositionResponse: {
             positionId?: string | null;
@@ -3790,7 +3841,16 @@ export interface components {
             /** @description Current isolated collateral for this position's margin-account bucket. */
             isolatedMargin?: string | null;
             leverage?: string | null;
+            /**
+             * @description Maintenance margin required by this position at mark_price using the
+             *      market maintenance-margin rate. Zero when the position has no open exposure.
+             */
             maintenanceMarginRequired?: string | null;
+            /**
+             * @description Initial margin required by this position at mark_price, honoring both its
+             *      effective leverage and the market initial-margin floor. Zero when the
+             *      position has no open exposure.
+             */
             initialMarginRequired?: string | null;
             liquidationPrice?: string | null;
             status?: string | null;
@@ -3805,7 +3865,16 @@ export interface components {
             unrealizedPnl?: string | null;
             liquidationPrice?: string | null;
             marginRatio?: string | null;
+            /**
+             * @description Maintenance margin required by this position at mark_price using the
+             *      market maintenance-margin rate. Zero when the position has no open exposure.
+             */
             maintenanceMarginRequired?: string | null;
+            /**
+             * @description Initial margin required by this position at mark_price, honoring both its
+             *      effective leverage and the market initial-margin floor. Zero when the
+             *      position has no open exposure.
+             */
             initialMarginRequired?: string | null;
             updatedAt?: string | null;
         };
@@ -4568,6 +4637,42 @@ export interface components {
              */
             createdAt?: string | null;
         };
+        /**
+         * @description Lifetime PnL components for the authenticated user. The fields satisfy
+         *      totalPnl = (spotRealized + perpsRealized) + (spotUnrealized + perpsUnrealized) - fundingPaid - fees.
+         */
+        PnlBreakdown: {
+            /**
+             * @description Cumulative realized spot PnL, average-cost basis, gross of fees; withdrawals realize at fair value
+             * @example 3.21
+             */
+            spotRealized?: string | null;
+            /**
+             * @description Unrealized PnL on current spot holdings: quantity x (latest close - average cost)
+             * @example 1.00
+             */
+            spotUnrealized?: string | null;
+            /**
+             * @description Cumulative realized perps PnL, gross of fees
+             * @example 5.55
+             */
+            perpsRealized?: string | null;
+            /**
+             * @description Unrealized PnL on open perp positions: quantity x (mark - entry)
+             * @example 2.00
+             */
+            perpsUnrealized?: string | null;
+            /**
+             * @description Cumulative funding paid; positive means paid, negative means received (same sign convention as the funding-payments endpoint). Subtracted in totalPnl.
+             * @example 0.50
+             */
+            fundingPaid?: string | null;
+            /**
+             * @description Cumulative trading fees; positive means charged, negative means rebated. Subtracted in totalPnl.
+             * @example 1.15
+             */
+            fees?: string | null;
+        };
         Position: {
             positionId?: string | null;
             /** @description Margin account UUID for the isolated bucket that owns this position. */
@@ -4584,7 +4689,16 @@ export interface components {
             /** @description Current isolated collateral for this position's margin-account bucket. */
             isolatedMargin?: string | null;
             leverage?: string | null;
+            /**
+             * @description Maintenance margin required by this position at mark_price using the
+             *      market maintenance-margin rate. Zero when the position has no open exposure.
+             */
             maintenanceMarginRequired?: string | null;
+            /**
+             * @description Initial margin required by this position at mark_price, honoring both its
+             *      effective leverage and the market initial-margin floor. Zero when the
+             *      position has no open exposure.
+             */
             initialMarginRequired?: string | null;
             liquidationPrice?: string | null;
             status?: string | null;
@@ -4608,6 +4722,52 @@ export interface components {
             orderId?: string | null;
             createdAt?: string | null;
         };
+        /**
+         * @description One PnL state sample for a position in one bucket. Cumulative fields are
+         *      lifetime values as of the bucket; fundingPaid and fees are cost-positive.
+         */
+        PositionPnlPoint: {
+            /**
+             * @description Bucket start timestamp (ISO 8601)
+             * @example 2026-02-18T00:00:00Z
+             */
+            bucketStart?: string | null;
+            /**
+             * @description Signed position quantity (negative for shorts)
+             * @example 1.50
+             */
+            quantity?: string | null;
+            /**
+             * @description Average entry price
+             * @example 95000.00
+             */
+            entryPrice?: string | null;
+            /**
+             * @description Mark price at the sample
+             * @example 95410.25
+             */
+            markPrice?: string | null;
+            /**
+             * @description Unrealized PnL at the sample: quantity x (mark - entry)
+             * @example 615.38
+             */
+            unrealizedPnl?: string | null;
+            /**
+             * @description Cumulative realized PnL, gross of fees
+             * @example 120.00
+             */
+            cumRealizedPnl?: string | null;
+            /**
+             * @description Cumulative funding paid; positive means paid, negative means received
+             * @example 3.20
+             */
+            cumFundingPaid?: string | null;
+            /**
+             * @description Cumulative trading fees; positive means charged, negative means rebated
+             * @example 1.75
+             */
+            cumFees?: string | null;
+        };
         PriceChange: {
             /**
              * @description Price 24 hours ago
@@ -5285,6 +5445,11 @@ export interface components {
              * @example crypto
              */
             category?: string | null;
+            /**
+             * @description Minimum order quantity increment (lot size step) in base token
+             * @example 0.00001
+             */
+            quantityStepSize?: string | null;
         };
         TransferCollateralFromMarginAccountRequest: {
             /** @description Parent margin account UUID that releases collateral. */
@@ -8745,6 +8910,63 @@ export interface operations {
             };
         };
     };
+    get_position_pnl_history: {
+        parameters: {
+            query: {
+                /** @description Sample interval */
+                interval: "1m" | "5m" | "15m" | "1h" | "4h" | "1d";
+                /** @description Start time as Unix timestamp (milliseconds) */
+                startTime?: number;
+                /** @description End time as Unix timestamp (milliseconds) */
+                endTime?: number;
+            };
+            header?: never;
+            path: {
+                positionId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GetPositionPnlHistoryResponse"];
+                };
+            };
+            /** @description Invalid interval or time range */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Authentication required */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Position not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     get_position_risk: {
         parameters: {
             query?: never;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@0xmonaco/types",
-	"version": "0.8.21",
+	"version": "0.8.22",
 	"type": "module",
 	"repository": {
 		"type": "git",
@@ -20,7 +20,7 @@
 		"lint": "biome lint ."
 	},
 	"dependencies": {
-		"@0xmonaco/contracts": "0.8.21",
+		"@0xmonaco/contracts": "0.8.22",
 		"zod": "^4.1.12"
 	},
 	"peerDependencies": {