@0xmonaco/types 1.0.16 → 1.0.21

package/dist/index.d.ts

@@ -14,6 +14,7 @@ export * from "./fees";
 export * from "./margin-accounts";
 export * from "./market";
 export * from "./pitpass";
+export * from "./portfolio";
 export * from "./positions";
 export * from "./profile";
 export * from "./sdk";

package/dist/index.js

@@ -15,6 +15,7 @@ export * from "./fees";
 export * from "./margin-accounts";
 export * from "./market";
 export * from "./pitpass";
+export * from "./portfolio";
 export * from "./positions";
 export * from "./profile";
 export * from "./sdk";

package/dist/portfolio/index.d.ts

@@ -0,0 +1,162 @@
+import type { BaseAPI } from "../api";
+/** Closed rolling windows supported by the authoritative portfolio APIs. */
+export type PortfolioAnalyticsPeriod = "1d" | "1w" | "1m" | "all";
+export type PortfolioCoverage = "complete" | "partial" | "none";
+export type PortfolioValuationStatus = "complete" | "partial";
+export type PortfolioDisplayInterval = "5m" | "1h" | "4h" | "1d";
+export type PortfolioCalculationInterval = "1m" | "5m" | "15m" | "1h" | "4h" | "1d";
+export interface PortfolioPeriodParams {
+    /** Defaults to `all` when omitted. */
+    period?: PortfolioAnalyticsPeriod;
+}
+export interface PortfolioWindow {
+    period: PortfolioAnalyticsPeriod;
+    asOf: string;
+    dataThrough?: string;
+    requestedStartsAt?: string;
+    effectiveStartsAt?: string;
+    historyStartsAt?: string;
+    coverage: PortfolioCoverage;
+}
+export interface PortfolioSeriesWindow extends PortfolioWindow {
+    displayInterval: PortfolioDisplayInterval;
+    calculationInterval: PortfolioCalculationInterval;
+}
+export interface PortfolioSummaryCurrent {
+    totalEquity?: string;
+    spotEquity?: string;
+    perpsEquity: string;
+    unrealizedPnl?: string;
+    availableValue?: string;
+}
+export interface PortfolioSummaryActivity {
+    volume: string;
+    tradeCount: number;
+    orderCount: number;
+    feesPaid: string;
+}
+export interface PortfolioSummary {
+    window: PortfolioWindow;
+    valuationStatus: PortfolioValuationStatus;
+    current: PortfolioSummaryCurrent;
+    activity: PortfolioSummaryActivity;
+}
+export interface PortfolioPerformanceDrawdown {
+    /** Positive transfer-neutral loss magnitude. */
+    amount: string;
+    /** Peak-to-trough sampled-TWR percentage. */
+    pct: string;
+    peakAt: string;
+    troughAt: string;
+}
+export interface PortfolioPerformancePoint {
+    timestamp: string;
+    equity: string;
+    cumulativePnl: string;
+    cumulativeReturnPct?: string;
+}
+export interface PortfolioPerformance {
+    window: PortfolioSeriesWindow;
+    calculationMethod: "sampled_twr";
+    valuationStatus: PortfolioValuationStatus;
+    startingEquity?: string;
+    endingEquity?: string;
+    deposits: string;
+    withdrawals: string;
+    netExternalFlows: string;
+    pnl?: string;
+    returnPct?: string;
+    maxDrawdown?: PortfolioPerformanceDrawdown;
+    points: PortfolioPerformancePoint[];
+}
+export interface PortfolioRealizedTotals {
+    perpsClosedPnl: string;
+    spotTradePnl: string;
+    fundingPnl: string;
+    feesPaid: string;
+    netRealizedPnl: string;
+}
+export interface PortfolioClosedTradeStats {
+    count: number;
+    winners: number;
+    losers: number;
+    breakEven: number;
+    winRatePct?: string;
+}
+export interface PortfolioBestDay {
+    /** UTC calendar date in YYYY-MM-DD form. */
+    date: string;
+    netRealizedPnl: string;
+}
+export interface PortfolioRealizedPnlPoint extends PortfolioRealizedTotals {
+    timestamp: string;
+}
+export interface PortfolioRealizedPnl {
+    window: PortfolioSeriesWindow;
+    bucketInterval: "1h" | "1d";
+    totals: PortfolioRealizedTotals;
+    closedTrades: PortfolioClosedTradeStats;
+    bestDay?: PortfolioBestDay;
+    points: PortfolioRealizedPnlPoint[];
+}
+export interface PortfolioAssetsPerformance {
+    pnl?: string;
+    returnPct?: string;
+    calculationMethod: "sampled_twr";
+}
+export interface PortfolioAssetRow {
+    assetId: string;
+    symbol: string;
+    totalBalance: string;
+    availableBalance: string;
+    lockedBalance: string;
+    markPrice?: string;
+    value?: string;
+    allocationPct?: string;
+    priceAsOf?: string;
+    pricingStatus: "priced" | "unpriced";
+}
+export interface PortfolioAssets {
+    window: PortfolioSeriesWindow;
+    valuationStatus: PortfolioValuationStatus;
+    totalSpotEquity?: string;
+    performance: PortfolioAssetsPerformance;
+    assets: PortfolioAssetRow[];
+}
+export interface PortfolioMarginTotal {
+    equity: string;
+    collateralBalance: string;
+    /** Free collateral in the parent account only; risk-bucket free collateral is not added. */
+    parentAvailableCollateral: string;
+    initialMarginRequired: string;
+    maintenanceMarginRequired: string;
+    unrealizedPnl: string;
+}
+export interface PortfolioMarginPositionCounts {
+    total: number;
+    cross: number;
+    isolated: number;
+}
+export interface PortfolioRiskBucket {
+    riskBucketId: string;
+    collateral: string;
+    freeCollateral: string;
+    initialMarginRequired: string;
+    maintenanceMarginRequired: string;
+    unrealizedPnl: string;
+    positionCount: number;
+}
+export interface PortfolioMargin {
+    asOf: string;
+    total: PortfolioMarginTotal;
+    positions: PortfolioMarginPositionCounts;
+    riskBuckets: PortfolioRiskBucket[];
+}
+/** Authoritative, application-scoped portfolio analytics. */
+export interface PortfolioAPI extends BaseAPI {
+    getSummary(params?: PortfolioPeriodParams): Promise<PortfolioSummary>;
+    getPerformance(params?: PortfolioPeriodParams): Promise<PortfolioPerformance>;
+    getRealizedPnl(params?: PortfolioPeriodParams): Promise<PortfolioRealizedPnl>;
+    getAssets(params?: PortfolioPeriodParams): Promise<PortfolioAssets>;
+    getMargin(): Promise<PortfolioMargin>;
+}

package/dist/sdk/index.d.ts

@@ -7,6 +7,7 @@ import type { FeesAPI } from "../fees";
 import type { MarginAccountsAPI } from "../margin-accounts";
 import type { Interval, MarketAPI } from "../market";
 import type { PitpassAPI } from "../pitpass";
+import type { PortfolioAPI } from "../portfolio";
 import type { PositionsAPI } from "../positions";
 import type { ProfileAPI } from "../profile";
 import type { SubAccountsAPI } from "../sub-accounts";
@@ -80,6 +81,8 @@ export interface MonacoSDK {
     marginAccounts: MarginAccountsAPI;
     /** Perp position operations API */
     positions: PositionsAPI;
+    /** Authoritative portfolio analytics API */
+    portfolio: PortfolioAPI;
     /** Sub-account management API */
     subAccounts: SubAccountsAPI;
     /** PitPass TraderCode referral and rewards API */

package/dist/validation/market.d.ts

@@ -12,8 +12,8 @@ export declare const IntervalSchema: z.ZodEnum<{
     "1h": "1h";
     "4h": "4h";
     "1d": "1d";
-    "30m": "30m";
     "1w": "1w";
+    "30m": "30m";
     "1M": "1M";
 }>;
 /**
@@ -80,8 +80,8 @@ export declare const GetCandlesticksSchema: z.ZodObject<{
         "1h": "1h";
         "4h": "4h";
         "1d": "1d";
-        "30m": "30m";
         "1w": "1w";
+        "30m": "30m";
         "1M": "1M";
     }>;
     startTime: z.ZodNumber;
@@ -164,8 +164,8 @@ export declare const GetCandlesticksByPairIdSchema: z.ZodObject<{
         "1h": "1h";
         "4h": "4h";
         "1d": "1d";
-        "30m": "30m";
         "1w": "1w";
+        "30m": "30m";
         "1M": "1M";
     }>;
     startTime: z.ZodOptional<z.ZodNumber>;
@@ -184,8 +184,8 @@ export declare const GetCandlesticksBySymbolSchema: z.ZodObject<{
         "1h": "1h";
         "4h": "4h";
         "1d": "1d";
-        "30m": "30m";
         "1w": "1w";
+        "30m": "30m";
         "1M": "1M";
     }>;
     startTime: z.ZodOptional<z.ZodNumber>;

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_my_trader_code", "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_rewards_balance", "get_screener", "get_sub_account_limits", "get_trade_by_id", "get_trader_code_info", "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", "transfer_rewards", "update_sub_account_limit", "upsert_delegated_agent", "verify_signature"];
+export declare const OPERATION_IDS: readonly ["add_position_margin", "attach_position_tp_sl", "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_my_trader_code", "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_assets", "get_portfolio_chart", "get_portfolio_margin", "get_portfolio_performance", "get_portfolio_realized_pnl", "get_portfolio_stats", "get_portfolio_summary", "get_position", "get_position_pnl_history", "get_position_risk", "get_rewards_balance", "get_screener", "get_sub_account_limits", "get_trade_by_id", "get_trader_code_info", "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", "transfer_rewards", "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

@@ -13,7 +13,6 @@
 export const OPERATION_IDS = [
     "add_position_margin",
     "attach_position_tp_sl",
-    "authenticate_backend",
     "batch_cancel_all",
     "batch_cancel_all_by_pair",
     "batch_cancel_orders",
@@ -50,8 +49,13 @@ export const OPERATION_IDS = [
     "get_parent_margin_account_summary",
     "get_perp_market_config",
     "get_perp_market_summary",
+    "get_portfolio_assets",
     "get_portfolio_chart",
+    "get_portfolio_margin",
+    "get_portfolio_performance",
+    "get_portfolio_realized_pnl",
     "get_portfolio_stats",
+    "get_portfolio_summary",
     "get_position",
     "get_position_pnl_history",
     "get_position_risk",

package/dist/wire/schema.d.ts

@@ -121,6 +121,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/accounts/me/portfolio/assets": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get portfolio assets
+         * @description Get authoritative spot asset values and spot-subportfolio performance.
+         */
+        get: operations["get_portfolio_assets"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/accounts/me/portfolio/chart": {
         parameters: {
             query?: never;
@@ -144,6 +164,86 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/accounts/me/portfolio/margin": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get portfolio margin
+         * @description Get the current authoritative parent margin and risk-bucket projection.
+         */
+        get: operations["get_portfolio_margin"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/accounts/me/portfolio/performance": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get portfolio performance
+         * @description Get transfer-neutral portfolio performance and sampled-TWR history.
+         */
+        get: operations["get_portfolio_performance"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/accounts/me/portfolio/realized-pnl": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get portfolio realized PnL
+         * @description Get bucketed closed-trade, funding, and fee PnL.
+         */
+        get: operations["get_portfolio_realized_pnl"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/accounts/me/portfolio/summary": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get portfolio summary
+         * @description Get authoritative portfolio summary and activity for one rolling period.
+         */
+        get: operations["get_portfolio_summary"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/accounts/movements": {
         parameters: {
             query?: never;
@@ -431,29 +531,6 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/api/v1/auth/backend": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Backend service authentication
-         * @description Backend service authentication.
-         *
-         *      Authenticate a backend service using a secret key. Returns a long-lived
-         *      access token for server-to-server API access.
-         */
-        post: operations["authenticate_backend"];
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
     "/api/v1/auth/challenge": {
         parameters: {
             query?: never;
@@ -2213,30 +2290,6 @@ export interface components {
             status?: string | null;
             message?: string | null;
         };
-        BackendAuthRequest: {
-            /**
-             * @description Backend secret key (sk_xxx)
-             * @example sk_live_abc123def456
-             */
-            secretKey: string;
-        };
-        BackendAuthResponse: {
-            /**
-             * @description Application UUID
-             * @example 123e4567-e89b-12d3-a456-426614174000
-             */
-            appId?: string | null;
-            /**
-             * @description Application client identifier
-             * @example monaco-frontend
-             */
-            clientId?: string | null;
-            /**
-             * @description Application display name
-             * @example Monaco Trading Frontend
-             */
-            name?: string | null;
-        };
         BatchCancelAllResponse: {
             /**
              * Format: int32
@@ -3871,6 +3924,14 @@ export interface components {
             marketRegime?: string | null;
             updatedAt?: string | null;
         };
+        GetPortfolioAssetsResponse: {
+            window?: components["schemas"]["PortfolioSeriesWindow"];
+            /** @enum {string|null} */
+            valuationStatus?: "complete" | "partial" | null;
+            totalSpotEquity?: string | null;
+            performance?: components["schemas"]["PortfolioAssetsPerformance"];
+            assets?: components["schemas"]["PortfolioAssetRow"][] | null;
+        };
         GetPortfolioChartResponse: {
             /**
              * @description Metric used for this query
@@ -3884,6 +3945,37 @@ export interface components {
             period?: string | null;
             data?: components["schemas"]["ChartDataPoint"][] | null;
         };
+        GetPortfolioMarginResponse: {
+            asOf?: string | null;
+            total?: components["schemas"]["PortfolioMarginTotal"];
+            positions?: components["schemas"]["PortfolioMarginPositionCounts"];
+            riskBuckets?: components["schemas"]["PortfolioRiskBucket"][] | null;
+        };
+        GetPortfolioPerformanceResponse: {
+            window?: components["schemas"]["PortfolioSeriesWindow"];
+            /** @enum {string|null} */
+            calculationMethod?: "sampled_twr" | null;
+            /** @enum {string|null} */
+            valuationStatus?: "complete" | "partial" | null;
+            startingEquity?: string | null;
+            endingEquity?: string | null;
+            deposits?: string | null;
+            withdrawals?: string | null;
+            netExternalFlows?: string | null;
+            pnl?: string | null;
+            returnPct?: string | null;
+            maxDrawdown?: components["schemas"]["PortfolioPerformanceDrawdown"];
+            points?: components["schemas"]["PortfolioPerformancePoint"][] | null;
+        };
+        GetPortfolioRealizedPnlResponse: {
+            window?: components["schemas"]["PortfolioSeriesWindow"];
+            /** @enum {string|null} */
+            bucketInterval?: "1h" | "1d" | null;
+            totals?: components["schemas"]["PortfolioRealizedTotals"];
+            closedTrades?: components["schemas"]["PortfolioClosedTradeStats"];
+            bestDay?: components["schemas"]["PortfolioBestDay"];
+            points?: components["schemas"]["PortfolioRealizedPnlPoint"][] | null;
+        };
         GetPortfolioStatsResponse: {
             /**
              * @description Period used for this query
@@ -3953,6 +4045,13 @@ export interface components {
             totalPnl?: string | null;
             pnlBreakdown?: components["schemas"]["PnlBreakdown"];
         };
+        GetPortfolioSummaryResponse: {
+            window?: components["schemas"]["PortfolioWindow"];
+            /** @enum {string|null} */
+            valuationStatus?: "complete" | "partial" | null;
+            current?: components["schemas"]["PortfolioSummaryCurrent"];
+            activity?: components["schemas"]["PortfolioSummaryActivity"];
+        };
         GetPositionPnlHistoryResponse: {
             /**
              * Format: uuid
@@ -4884,6 +4983,152 @@ export interface components {
              */
             fees?: string | null;
         };
+        PortfolioAssetRow: {
+            /** Format: uuid */
+            assetId?: string | null;
+            symbol?: string | null;
+            totalBalance?: string | null;
+            availableBalance?: string | null;
+            lockedBalance?: string | null;
+            markPrice?: string | null;
+            value?: string | null;
+            allocationPct?: string | null;
+            priceAsOf?: string | null;
+            /** @enum {string|null} */
+            pricingStatus?: "priced" | "unpriced" | null;
+        };
+        PortfolioAssetsPerformance: {
+            pnl?: string | null;
+            returnPct?: string | null;
+            /** @enum {string|null} */
+            calculationMethod?: "sampled_twr" | null;
+        };
+        PortfolioBestDay: {
+            /**
+             * Format: date
+             * @description UTC calendar date
+             */
+            date?: string | null;
+            netRealizedPnl?: string | null;
+        };
+        PortfolioClosedTradeStats: {
+            count?: string | null;
+            winners?: string | null;
+            losers?: string | null;
+            breakEven?: string | null;
+            winRatePct?: string | null;
+        };
+        PortfolioMarginPositionCounts: {
+            total?: string | null;
+            cross?: string | null;
+            isolated?: string | null;
+        };
+        PortfolioMarginTotal: {
+            equity?: string | null;
+            collateralBalance?: string | null;
+            parentAvailableCollateral?: string | null;
+            initialMarginRequired?: string | null;
+            maintenanceMarginRequired?: string | null;
+            unrealizedPnl?: string | null;
+        };
+        PortfolioPerformanceDrawdown: {
+            /** @description Positive transfer-neutral loss magnitude */
+            amount?: string | null;
+            /** @description Peak-to-trough sampled-TWR percentage */
+            pct?: string | null;
+            peakAt?: string | null;
+            troughAt?: string | null;
+        };
+        PortfolioPerformancePoint: {
+            timestamp?: string | null;
+            equity?: string | null;
+            cumulativePnl?: string | null;
+            cumulativeReturnPct?: string | null;
+        };
+        PortfolioRealizedPnlPoint: {
+            timestamp?: string | null;
+            perpsClosedPnl?: string | null;
+            spotTradePnl?: string | null;
+            fundingPnl?: string | null;
+            feesPaid?: string | null;
+            netRealizedPnl?: string | null;
+        };
+        PortfolioRealizedTotals: {
+            perpsClosedPnl?: string | null;
+            spotTradePnl?: string | null;
+            fundingPnl?: string | null;
+            feesPaid?: string | null;
+            netRealizedPnl?: string | null;
+        };
+        PortfolioRiskBucket: {
+            /** Format: uuid */
+            riskBucketId?: string | null;
+            collateral?: string | null;
+            freeCollateral?: string | null;
+            initialMarginRequired?: string | null;
+            maintenanceMarginRequired?: string | null;
+            unrealizedPnl?: string | null;
+            positionCount?: string | null;
+        };
+        PortfolioSeriesWindow: {
+            /**
+             * @description Closed portfolio period token
+             * @enum {string|null}
+             */
+            period?: "1d" | "1w" | "1m" | "all" | null;
+            asOf?: string | null;
+            dataThrough?: string | null;
+            requestedStartsAt?: string | null;
+            effectiveStartsAt?: string | null;
+            historyStartsAt?: string | null;
+            /** @enum {string|null} */
+            coverage?: "complete" | "partial" | "none" | null;
+            /**
+             * @description Interval of returned chart points
+             * @enum {string|null}
+             */
+            displayInterval?: "5m" | "1h" | "4h" | "1d" | null;
+            /**
+             * @description Finest retained interval used before display downsampling
+             * @enum {string|null}
+             */
+            calculationInterval?: "1m" | "5m" | "15m" | "1h" | "4h" | "1d" | null;
+        };
+        PortfolioSummaryActivity: {
+            volume?: string | null;
+            tradeCount?: string | null;
+            orderCount?: string | null;
+            feesPaid?: string | null;
+        };
+        PortfolioSummaryCurrent: {
+            totalEquity?: string | null;
+            spotEquity?: string | null;
+            perpsEquity?: string | null;
+            unrealizedPnl?: string | null;
+            availableValue?: string | null;
+        };
+        PortfolioWindow: {
+            /**
+             * @description Closed portfolio period token
+             * @enum {string|null}
+             */
+            period?: "1d" | "1w" | "1m" | "all" | null;
+            /** @description Exclusive response query cutoff (RFC3339) */
+            asOf?: string | null;
+            /** @description Newest underlying observation used (RFC3339) */
+            dataThrough?: string | null;
+            /** @description Requested rolling-window start; null for all (RFC3339) */
+            requestedStartsAt?: string | null;
+            /** @description Actual calculation start after retained-history constraints (RFC3339) */
+            effectiveStartsAt?: string | null;
+            /** @description First observation with complete endpoint semantics (RFC3339) */
+            historyStartsAt?: string | null;
+            /**
+             * @description History coverage for the requested period
+             * @enum {string|null}
+             */
+            coverage?: "complete" | "partial" | "none" | null;
+        };
         Position: {
             positionId?: string | null;
             /** @description Margin account UUID for the isolated bucket that owns this position. */
@@ -6290,6 +6535,56 @@ export interface operations {
             };
         };
     };
+    get_portfolio_assets: {
+        parameters: {
+            query?: {
+                period?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GetPortfolioAssetsResponse"];
+                };
+            };
+            /** @description Invalid period parameter */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Authentication required */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Portfolio data unavailable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     get_portfolio_chart: {
         parameters: {
             query?: {
@@ -6334,6 +6629,197 @@ export interface operations {
             };
         };
     };
+    get_portfolio_margin: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GetPortfolioMarginResponse"];
+                };
+            };
+            /** @description Authentication required */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Portfolio data unavailable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    get_portfolio_performance: {
+        parameters: {
+            query?: {
+                period?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GetPortfolioPerformanceResponse"];
+                };
+            };
+            /** @description Invalid period parameter */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Authentication required */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Portfolio data or flow reconciliation unavailable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    get_portfolio_realized_pnl: {
+        parameters: {
+            query?: {
+                period?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GetPortfolioRealizedPnlResponse"];
+                };
+            };
+            /** @description Invalid period parameter */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Authentication required */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Portfolio data unavailable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    get_portfolio_summary: {
+        parameters: {
+            query?: {
+                period?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GetPortfolioSummaryResponse"];
+                };
+            };
+            /** @description Invalid period parameter */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Authentication required */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Portfolio data unavailable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     get_user_movements: {
         parameters: {
             query?: {
@@ -7034,51 +7520,6 @@ export interface operations {
             };
         };
     };
-    authenticate_backend: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["BackendAuthRequest"];
-            };
-        };
-        responses: {
-            /** @description OK */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["BackendAuthResponse"];
-                };
-            };
-            /** @description Invalid request parameters */
-            400: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
-            /** @description Invalid secret key or inactive application */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
-            /** @description Internal server error */
-            500: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
-        };
-    };
     create_challenge: {
         parameters: {
             query?: never;

package/package.json

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