@0xmonaco/types 1.0.85 → 1.0.86

package/dist/market/index.d.ts

@@ -201,7 +201,7 @@ export interface ScreenerSnapshotPoint {
     quoteVolume: string;
     /** Percent price change (close - open) / open * 100 for the day */
     priceChangePercent: string;
-    /** Daily average of the valued completed-UTC-minute gross open-interest notionals; null for spot or when fewer than 95% of the day's 1440 minutes (1368) are valued */
+    /** Daily average of the valued completed-UTC-minute one-sided LONG open-interest notionals; null for spot or when fewer than 95% of the day's 1440 minutes (1368) are valued */
     openInterestNotionalAvg: string | null;
 }
 /**
@@ -252,22 +252,24 @@ export interface ScreenerItem {
      */
     lastFundingTime: string | null;
     /**
-     * Gross open interest (longs plus shorts) in base-asset units (e.g. BTC);
-     * null for spot pairs, "0" for a margin pair with no open positions
+     * One-sided LONG open interest (each contract counted once) in base-asset units
+     * (e.g. BTC), from the latest completed-minute sample; null for spot pairs or
+     * when no sample was recorded in the last five minutes, "0" for a margin pair with no
+     * open positions
      */
     openInterestBase: string | null;
     /**
-     * Gross open-interest notional (longs plus shorts) in quote units
+     * One-sided LONG open-interest notional in quote units
      * (openInterestBase × latest trade price); null for spot pairs. Valued at the pair's latest trade price (a
      * snapshot); the mark-accurate notional lives on getPerpMarketSummary /
      * getOpenInterest
      */
     openInterestNotional: string | null;
-    /** Average of the valued completed-UTC-minute gross open-interest notionals over the last 60 minutes; null for spot or when fewer than 95% of them (57) are valued */
+    /** Average of the valued completed-UTC-minute one-sided LONG open-interest notionals over the last 60 minutes; null for spot or when fewer than 95% of them (57) are valued */
     openInterestNotionalAvg1h: string | null;
-    /** Average of the valued completed-UTC-minute gross open-interest notionals over the last 1440 minutes; null for spot or when fewer than 95% of them (1368) are valued */
+    /** Average of the valued completed-UTC-minute one-sided LONG open-interest notionals over the last 1440 minutes; null for spot or when fewer than 95% of them (1368) are valued */
     openInterestNotionalAvg24h: string | null;
-    /** Average of the valued completed-UTC-minute gross open-interest notionals over the last 10080 minutes; null for spot or when fewer than 95% of them (9576) are valued */
+    /** Average of the valued completed-UTC-minute one-sided LONG open-interest notionals over the last 10080 minutes; null for spot or when fewer than 95% of them (9576) are valued */
     openInterestNotionalAvg7d: string | null;
     /**
      * Estimated rate for the in-progress funding window (decimal fraction per
@@ -436,11 +438,11 @@ export interface PerpMarketSummary {
     quoteVolume24h?: string;
     priceChange24h?: string;
     priceChangePercent24h?: string;
-    /** Gross open interest (longs plus shorts) in base-asset units (legacy alias of openInterestBase) */
+    /** One-sided LONG open interest (each contract counted once) in base-asset units (legacy alias of openInterestBase) */
     openInterest: string;
-    /** Gross open interest (longs plus shorts) in base-asset units (e.g. BTC) */
+    /** One-sided LONG open interest (each contract counted once) in base-asset units (e.g. BTC) */
     openInterestBase?: string;
-    /** Gross open-interest notional (longs plus shorts) in quote units (openInterestBase × mark price, falling back to the last trade price when no mark is available) */
+    /** One-sided LONG open-interest notional in quote units (openInterestBase × mark price, falling back to the last trade price when no mark is available) */
     openInterestNotional?: string;
     currentFundingRate?: string;
     estimatedNextFundingRate?: string;
@@ -595,11 +597,11 @@ export interface ListAllFundingHistoryResponse {
 }
 export interface OpenInterest {
     tradingPairId: string;
-    /** Gross open interest (longs plus shorts) in base-asset units (legacy alias of openInterestBase) */
+    /** One-sided LONG open interest (each contract counted once) in base-asset units (legacy alias of openInterestBase) */
     openInterest?: string;
-    /** Gross open interest (longs plus shorts) in base-asset units */
+    /** One-sided LONG open interest (each contract counted once) in base-asset units */
     openInterestBase: string;
-    /** Gross open-interest notional (longs plus shorts) in quote units (openInterestBase × mark price, falling back to the last trade price when no mark is available) */
+    /** One-sided LONG open-interest notional in quote units (openInterestBase × mark price, falling back to the last trade price when no mark is available) */
     openInterestNotional: string;
     updatedAt: string;
 }

package/dist/websocket/events/market-stats-events.d.ts

@@ -45,7 +45,8 @@ export interface MarketStatsData {
     /** Best ask price (decimal string) */
     bestAskPrice?: string;
     /**
-     * Gross open interest (longs plus shorts) in base units (decimal string).
+     * One-sided LONG open interest (each contract counted once) in base
+     * units (decimal string).
      * Perp-only; omitted for spot, and omitted (never zero) until the market's
      * open interest is known.
      */
@@ -58,8 +59,8 @@ export interface MarketStatsData {
     openInterestLimit?: string;
     /**
      * What is left of `openInterestLimit` at the mark, in quote (USD) notional,
-     * never below zero (decimal string): the cap minus the gross `openInterest`
-     * × `markPrice`. At zero, orders that open exposure are refused until open
+     * never below zero (decimal string): the cap minus the gross open interest
+     * (longs plus shorts, not derivable from `openInterest`) × `markPrice`. At zero, orders that open exposure are refused until open
      * interest or the mark falls. Perp-only; omitted for spot, when there is no
      * mark, and until open interest is known.
      */
@@ -147,7 +148,8 @@ export interface MarketStatsSummary {
     /** 24h low price (decimal string) */
     dailyPriceLow?: string;
     /**
-     * Gross open interest (longs plus shorts) in base units (decimal string).
+     * One-sided LONG open interest (each contract counted once) in base
+     * units (decimal string).
      * Perp-only; omitted for spot, and omitted (never zero) until the market's
      * open interest is known.
      */
@@ -169,8 +171,7 @@ export interface MarketStatsSummary {
     /** Funding premium (decimal string). Perp-only; omitted for spot. */
     premium?: string;
     /**
-     * Gross open interest (longs plus shorts) in quote notional (decimal
-     * string): `openInterest` priced at the mark, falling back to the last trade
+     * One-sided LONG open interest in quote notional (decimal string): `openInterest` priced at the mark, falling back to the last trade
      * price. Perp-only; omitted for spot,
      * and omitted (never zero) until both open interest and a price are known.
      */

package/dist/wire/schema.d.ts

@@ -2242,7 +2242,7 @@ export interface paths {
         };
         /**
          * Open Interest
-         * @description Gross open interest (longs plus shorts) for a perp market.
+         * @description One-sided LONG open interest (each open contract counted once) for a perp market.
          */
         get: operations["get_open_interest"];
         put?: never;
@@ -6384,7 +6384,7 @@ export interface components {
             /** @description Cursor for the next page; empty when there are no more. */
             nextPageToken?: string | null;
         };
-        /** @description Latest public gross open interest (longs plus shorts) for a trading pair. */
+        /** @description Latest public one-sided LONG open interest (each open contract counted once) for a trading pair. */
         GetOpenInterestResponse: {
             /**
              * Format: uuid
@@ -6393,7 +6393,7 @@ export interface components {
              */
             tradingPairId?: string | null;
             /**
-             * @description Current gross open interest (longs plus shorts) in base-asset units
+             * @description Current one-sided LONG open interest (each open contract counted once) in base-asset units
              * @example 12345.67
              */
             openInterest?: string | null;
@@ -6403,12 +6403,12 @@ export interface components {
              */
             updatedAt?: string | null;
             /**
-             * @description Current gross open interest (longs plus shorts) in base-asset units
+             * @description Current one-sided LONG open interest (each open contract counted once) in base-asset units
              * @example 12345.67
              */
             openInterestBase?: string | null;
             /**
-             * @description Current gross open-interest notional (longs plus shorts) in quote units (openInterestBase x mark price, falling back to the last trade price when no mark is available)
+             * @description Current one-sided LONG open-interest notional in quote units (openInterestBase x mark price, falling back to the last trade price when no mark is available)
              * @example 1172836500.00
              */
             openInterestNotional?: string | null;
@@ -6754,7 +6754,7 @@ export interface components {
             priceChange24h?: string | null;
             priceChangePercent24h?: string | null;
             /**
-             * @description Gross open interest (longs plus shorts) in base-asset units (legacy alias of openInterestBase)
+             * @description One-sided LONG open interest (each open contract counted once) in base-asset units (legacy alias of openInterestBase)
              * @example 12345.67
              */
             openInterest?: string | null;
@@ -6765,12 +6765,12 @@ export interface components {
             marketRegime?: string | null;
             updatedAt?: string | null;
             /**
-             * @description Gross open interest (longs plus shorts) in base-asset units (e.g. BTC)
+             * @description One-sided LONG open interest (each open contract counted once) in base-asset units (e.g. BTC)
              * @example 12345.67
              */
             openInterestBase?: string | null;
             /**
-             * @description Gross open-interest notional (longs plus shorts) in quote units (openInterestBase x mark price, falling back to the last trade price when no mark is available)
+             * @description One-sided LONG open-interest notional in quote units (openInterestBase x mark price, falling back to the last trade price when no mark is available)
              * @example 1172836500.00
              */
             openInterestNotional?: string | null;
@@ -9996,27 +9996,27 @@ export interface components {
              */
             lastFundingTime?: string | null;
             /**
-             * @description Gross open interest (longs plus shorts) in base-asset units (e.g. BTC); null for spot pairs, "0" for a margin pair with no open positions
+             * @description One-sided LONG open interest (each open contract counted once) in base-asset units (e.g. BTC), from the latest completed-minute sample; null for spot pairs or when no sample was recorded in the last five minutes, "0" for a margin pair with no open positions
              * @example 12345.67
              */
             openInterestBase?: string | null;
             /**
-             * @description Gross open-interest notional (longs plus shorts) in quote units (openInterestBase x latest trade price); null for spot pairs. Valued at the pair's latest trade price (a snapshot); the mark-accurate notional lives on getPerpMarketSummary / getOpenInterest
+             * @description One-sided LONG open-interest notional in quote units (openInterestBase x latest trade price); null for spot pairs. Valued at the pair's latest trade price (a snapshot); the mark-accurate notional lives on getPerpMarketSummary / getOpenInterest
              * @example 1172836500.00
              */
             openInterestNotional?: string | null;
             /**
-             * @description Arithmetic mean of the valued gross open-interest notional observations (one per completed UTC minute) over the last 60 completed minutes ending at floor(now to minute); published once at least 95% of those minutes (57) carry a valued sample. Null for spot pairs or below that coverage; a minute without a trade price is unvalued, never zero; known zero is "0". Each sample is gross open position size x latest trade price in quote units. No historical backfill; this window warms after deployment.
+             * @description Arithmetic mean of the valued one-sided LONG open-interest notional observations (one per completed UTC minute) over the last 60 completed minutes ending at floor(now to minute); published once at least 95% of those minutes (57) carry a valued sample. Null for spot pairs or below that coverage; a minute without a trade price is unvalued, never zero; known zero is "0". Each sample is the LONG open position size x latest trade price in quote units. No historical backfill; this window warms after deployment.
              * @example 1172836500.00
              */
             openInterestNotionalAvg1h?: string | null;
             /**
-             * @description Arithmetic mean of the valued gross open-interest notional observations (one per completed UTC minute) over the last 1440 completed minutes ending at floor(now to minute); published once at least 95% of those minutes (1368) carry a valued sample. Null for spot pairs or below that coverage; a minute without a trade price is unvalued, never zero; known zero is "0". Each sample is gross open position size x latest trade price in quote units. No historical backfill; this window warms after deployment.
+             * @description Arithmetic mean of the valued one-sided LONG open-interest notional observations (one per completed UTC minute) over the last 1440 completed minutes ending at floor(now to minute); published once at least 95% of those minutes (1368) carry a valued sample. Null for spot pairs or below that coverage; a minute without a trade price is unvalued, never zero; known zero is "0". Each sample is the LONG open position size x latest trade price in quote units. No historical backfill; this window warms after deployment.
              * @example 1172836500.00
              */
             openInterestNotionalAvg24h?: string | null;
             /**
-             * @description Arithmetic mean of the valued gross open-interest notional observations (one per completed UTC minute) over the last 10080 completed minutes ending at floor(now to minute); published once at least 95% of those minutes (9576) carry a valued sample. Null for spot pairs or below that coverage; a minute without a trade price is unvalued, never zero; known zero is "0". Each sample is gross open position size x latest trade price in quote units. No historical backfill; this window warms after deployment.
+             * @description Arithmetic mean of the valued one-sided LONG open-interest notional observations (one per completed UTC minute) over the last 10080 completed minutes ending at floor(now to minute); published once at least 95% of those minutes (9576) carry a valued sample. Null for spot pairs or below that coverage; a minute without a trade price is unvalued, never zero; known zero is "0". Each sample is the LONG open position size x latest trade price in quote units. No historical backfill; this window warms after deployment.
              * @example 1172836500.00
              */
             openInterestNotionalAvg7d?: string | null;
@@ -10044,7 +10044,7 @@ export interface components {
              */
             priceChangePercent?: string | null;
             /**
-             * @description Arithmetic mean of the valued gross open-interest notional observations (one per completed UTC minute) in this completed UTC day; published once at least 95% of its 1440 minutes (1368) carry a valued sample, null for spot pairs or below that coverage. Samples use gross open position size x latest trade price in quote units; a minute without a trade price is unvalued, never zero; known zero remains "0". No historical backfill.
+             * @description Arithmetic mean of the valued one-sided LONG open-interest notional observations (one per completed UTC minute) in this completed UTC day; published once at least 95% of its 1440 minutes (1368) carry a valued sample, null for spot pairs or below that coverage. Samples use the LONG open position size x latest trade price in quote units; a minute without a trade price is unvalued, never zero; known zero remains "0". No historical backfill.
              * @example 1172836500.00
              */
             openInterestNotionalAvg?: string | null;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@0xmonaco/types",
-	"version": "1.0.85",
+	"version": "1.0.86",
 	"type": "module",
 	"homepage": "https://docs.0xmonaco.com/sdk/typescript",
 	"main": "./dist/index.js",
@@ -16,7 +16,7 @@
 		"lint": "biome lint ."
 	},
 	"dependencies": {
-		"@0xmonaco/contracts": "1.0.85",
+		"@0xmonaco/contracts": "1.0.86",
 		"zod": "^4.1.12"
 	},
 	"peerDependencies": {