@compass-labs/api-sdk 2.2.114 → 2.2.115

package/openapi_prepped_for_speakeasy.json

@@ -17166,6 +17166,17 @@
             "$ref": "#/components/schemas/LoopedPositionTotals",
             "description": "Lifetime totals across the position's history."
           },
+          "pnl": {
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/LoopedPositionPnl"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Profit or loss since the position opened, for OPEN and CLOSED positions alike. Null when it cannot be stated honestly: the position's recorded history is incomplete (it starts after the opening, or does not add up to what the position holds now), a transaction could not be priced, the position's current value could not be read or separated from another position's, or a transaction's legs cannot be told apart from another position's."
+          },
           "history": {
             "items": {
               "$ref": "#/components/schemas/LoopedPositionHistoryEntry"
@@ -17446,7 +17457,7 @@
                 "type": "null"
               }
             ],
-            "description": "The swap leg detected in this transaction, if any."
+            "description": "The swap leg of a loop (debt sold for collateral) or an unwind (collateral sold for debt), when the transaction shows one."
           },
           "events": {
             "items": {
@@ -17456,6 +17467,34 @@
             "title": "Events",
             "description": "The raw lending events that make up this transaction (Morpho supply_collateral maps to 'supply', withdraw_collateral to 'withdraw').",
             "example": []
+          },
+          "equity_flow_quote": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Equity Flow Quote",
+            "description": "Equity this transaction put into the position (positive) or took out of it (negative), in the debt token, valued when it landed. 0 for a liquidation, whose loss stays in the position's equity. Null when the transaction could not be valued."
+          },
+          "flow_basis": {
+            "anyOf": [
+              {
+                "type": "string",
+                "enum": [
+                  "swap",
+                  "oracle"
+                ]
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Flow Basis",
+            "description": "How equity_flow_quote was measured. 'swap': from this transaction's own swap, so the swap's cost shows up in PnL. 'oracle': from the net amounts at the market price; on a loop or unwind that folds the swap's cost into the flow instead. Null for a liquidation and for a transaction that could not be valued."
           }
         },
         "additionalProperties": false,
@@ -17471,6 +17510,53 @@
         "title": "LoopedPositionHistoryEntry",
         "description": "One transaction in a looped position's lifetime."
       },
+      "LoopedPositionPnl": {
+        "properties": {
+          "total_pnl_quote": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Total Pnl Quote",
+            "description": "Profit or loss since the position opened, in the position's debt token: what the position is worth now, plus everything taken out, minus everything put in, each valued when it happened. It includes the entry and exit swap costs, the carry (what the collateral earned minus the interest paid) and the collateral's price move against the debt token. Realized once the position is closed, unrealized while it is open. Where a loop or unwind's own swap could not be used (its history entry has flow_basis 'oracle'), that swap's cost is not counted and the figure reads higher by roughly that amount.\n\nMeasured in the debt token, not USD: on a correlated loop (wstHYPE against WHYPE, wstETH against WETH) a positive figure here can still be a USD loss when the debt token itself falls. total_pnl_usd carries that."
+          },
+          "total_pnl_percent": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Total Pnl Percent",
+            "description": "total_pnl_quote as a percentage of the equity put in (e.g. 4.2 = 4.2%): the return on the capital contributed, not annualized."
+          },
+          "total_pnl_usd": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Total Pnl Usd",
+            "description": "Profit or loss since the position opened, in USD: each flow at the debt token's USD price when it happened, the position's current value at its price now. Unlike total_pnl_quote it includes the debt token's own USD move. Null when any of those prices is unavailable."
+          }
+        },
+        "additionalProperties": false,
+        "type": "object",
+        "required": [
+          "total_pnl_quote"
+        ],
+        "title": "LoopedPositionPnl",
+        "description": "What a looped position has made or lost since it opened.\n\nMeasured in the position's debt token (the quote), with USD alongside.\nEvery transaction is an equity flow valued when it landed: a loop's\nprincipal goes in, an unwind's proceeds come out. PnL is what the position\nis worth now plus everything taken out, minus everything put in; each\nhistory entry carries its own flow in equity_flow_quote."
+      },
       "LoopedPositionTotals": {
         "properties": {
           "total_collateral_added": {
@@ -25157,7 +25243,7 @@
           "sold_token": {
             "type": "string",
             "title": "Sold Token",
-            "description": "Token sold in the swap (the borrowed/debt token)."
+            "description": "The token leaving the account: the debt token on a loop, the collateral token on an unwind."
           },
           "sold_symbol": {
             "type": "string",
@@ -25172,7 +25258,7 @@
           "bought_token": {
             "type": "string",
             "title": "Bought Token",
-            "description": "Token bought in the swap (the collateral token)."
+            "description": "The token arriving in the account: the collateral token on a loop, the debt token on an unwind."
           },
           "bought_symbol": {
             "type": "string",
@@ -25208,7 +25294,7 @@
           "bought_amount"
         ],
         "title": "SwapInfo",
-        "description": "The DEX swap leg detected inside a loop transaction.\n\nEvidence is token-filtered and executor-proof: the sold (debt) token left the\naccount to a non-protocol counterparty and the bought (collateral) token\narrived from a non-protocol counterparty. Aggregator fills often settle from an\nexecutor contract, so the router is recorded only when it happens to be the\noutbound counterparty \u2014 it is never required for detection."
+        "description": "The swap leg detected inside a loop or unwind transaction.\n\nEvidence is token-filtered and executor-proof: the sold token left the\naccount to a non-protocol counterparty and the bought token arrived from a\nnon-protocol counterparty. Aggregator fills often settle from an executor\ncontract, so the router is recorded only when it happens to be the outbound\ncounterparty \u2014 it is never required for detection."
       },
       "SyPosition": {
         "properties": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compass-labs/api-sdk",
-  "version": "2.2.114",
+  "version": "2.2.115",
   "author": "royalnine",
   "type": "module",
   "tshy": {

package/src/models/components/index.ts

@@ -168,6 +168,7 @@ export * from "./listaavemarketsresponse.js";
 export * from "./loopedposition.js";
 export * from "./loopedpositioncurrentstate.js";
 export * from "./loopedpositionhistoryentry.js";
+export * from "./loopedpositionpnl.js";
 export * from "./loopedpositiontotals.js";
 export * from "./looplegpreview.js";
 export * from "./lpbalance.js";

package/src/models/components/loopedposition.ts

@@ -20,6 +20,10 @@ import {
   LoopedPositionHistoryEntry,
   LoopedPositionHistoryEntry$inboundSchema,
 } from "./loopedpositionhistoryentry.js";
+import {
+  LoopedPositionPnl,
+  LoopedPositionPnl$inboundSchema,
+} from "./loopedpositionpnl.js";
 import {
   LoopedPositionTotals,
   LoopedPositionTotals$inboundSchema,
@@ -114,6 +118,10 @@ export type LoopedPosition = {
    * Lifetime totals across all of a looped position's transactions.
    */
   totals: LoopedPositionTotals;
+  /**
+   * Profit or loss since the position opened, for OPEN and CLOSED positions alike. Null when it cannot be stated honestly: the position's recorded history is incomplete (it starts after the opening, or does not add up to what the position holds now), a transaction could not be priced, the position's current value could not be read or separated from another position's, or a transaction's legs cannot be told apart from another position's.
+   */
+  pnl?: LoopedPositionPnl | null | undefined;
   /**
    * All transactions for this position, chronological.
    */
@@ -147,6 +155,7 @@ export const LoopedPosition$inboundSchema: z.ZodType<
   ).optional(),
   current: z.nullable(LoopedPositionCurrentState$inboundSchema).optional(),
   totals: LoopedPositionTotals$inboundSchema,
+  pnl: z.nullable(LoopedPositionPnl$inboundSchema).optional(),
   history: z.array(LoopedPositionHistoryEntry$inboundSchema).optional(),
 }).transform((v) => {
   return remap$(v, {

package/src/models/components/loopedpositionhistoryentry.ts

@@ -30,6 +30,12 @@ export const Classification = {
  */
 export type Classification = ClosedEnum<typeof Classification>;
 
+export const FlowBasis = {
+  Swap: "swap",
+  Oracle: "oracle",
+} as const;
+export type FlowBasis = ClosedEnum<typeof FlowBasis>;
+
 /**
  * One transaction in a looped position's lifetime.
  */
@@ -63,13 +69,21 @@ export type LoopedPositionHistoryEntry = {
    */
   debtDelta: string;
   /**
-   * The swap leg detected in this transaction, if any.
+   * The swap leg of a loop (debt sold for collateral) or an unwind (collateral sold for debt), when the transaction shows one.
    */
   swap?: SwapInfo | null | undefined;
   /**
    * The raw lending events that make up this transaction (Morpho supply_collateral maps to 'supply', withdraw_collateral to 'withdraw').
    */
   events?: Array<CreditEvent> | undefined;
+  /**
+   * Equity this transaction put into the position (positive) or took out of it (negative), in the debt token, valued when it landed. 0 for a liquidation, whose loss stays in the position's equity. Null when the transaction could not be valued.
+   */
+  equityFlowQuote?: string | null | undefined;
+  /**
+   * How equity_flow_quote was measured. 'swap': from this transaction's own swap, so the swap's cost shows up in PnL. 'oracle': from the net amounts at the market price; on a loop or unwind that folds the swap's cost into the flow instead. Null for a liquidation and for a transaction that could not be valued.
+   */
+  flowBasis?: FlowBasis | null | undefined;
 };
 
 /** @internal */
@@ -77,6 +91,10 @@ export const Classification$inboundSchema: z.ZodNativeEnum<
   typeof Classification
 > = z.nativeEnum(Classification);
 
+/** @internal */
+export const FlowBasis$inboundSchema: z.ZodNativeEnum<typeof FlowBasis> = z
+  .nativeEnum(FlowBasis);
+
 /** @internal */
 export const LoopedPositionHistoryEntry$inboundSchema: z.ZodType<
   LoopedPositionHistoryEntry,
@@ -94,6 +112,8 @@ export const LoopedPositionHistoryEntry$inboundSchema: z.ZodType<
   debt_delta: z.string(),
   swap: z.nullable(SwapInfo$inboundSchema).optional(),
   events: z.array(CreditEvent$inboundSchema).optional(),
+  equity_flow_quote: z.nullable(z.string()).optional(),
+  flow_basis: z.nullable(FlowBasis$inboundSchema).optional(),
 }).transform((v) => {
   return remap$(v, {
     "transaction_hash": "transactionHash",
@@ -101,6 +121,8 @@ export const LoopedPositionHistoryEntry$inboundSchema: z.ZodType<
     "block_timestamp": "blockTimestamp",
     "collateral_delta": "collateralDelta",
     "debt_delta": "debtDelta",
+    "equity_flow_quote": "equityFlowQuote",
+    "flow_basis": "flowBasis",
   });
 });
 

package/src/models/components/loopedpositionpnl.ts

@@ -0,0 +1,66 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+/**
+ * What a looped position has made or lost since it opened.
+ *
+ * @remarks
+ *
+ * Measured in the position's debt token (the quote), with USD alongside.
+ * Every transaction is an equity flow valued when it landed: a loop's
+ * principal goes in, an unwind's proceeds come out. PnL is what the position
+ * is worth now plus everything taken out, minus everything put in; each
+ * history entry carries its own flow in equity_flow_quote.
+ */
+export type LoopedPositionPnl = {
+  /**
+   * Profit or loss since the position opened, in the position's debt token: what the position is worth now, plus everything taken out, minus everything put in, each valued when it happened. It includes the entry and exit swap costs, the carry (what the collateral earned minus the interest paid) and the collateral's price move against the debt token. Realized once the position is closed, unrealized while it is open. Where a loop or unwind's own swap could not be used (its history entry has flow_basis 'oracle'), that swap's cost is not counted and the figure reads higher by roughly that amount.
+   *
+   * @remarks
+   *
+   * Measured in the debt token, not USD: on a correlated loop (wstHYPE against WHYPE, wstETH against WETH) a positive figure here can still be a USD loss when the debt token itself falls. total_pnl_usd carries that.
+   */
+  totalPnlQuote: string | null;
+  /**
+   * total_pnl_quote as a percentage of the equity put in (e.g. 4.2 = 4.2%): the return on the capital contributed, not annualized.
+   */
+  totalPnlPercent?: string | null | undefined;
+  /**
+   * Profit or loss since the position opened, in USD: each flow at the debt token's USD price when it happened, the position's current value at its price now. Unlike total_pnl_quote it includes the debt token's own USD move. Null when any of those prices is unavailable.
+   */
+  totalPnlUsd?: string | null | undefined;
+};
+
+/** @internal */
+export const LoopedPositionPnl$inboundSchema: z.ZodType<
+  LoopedPositionPnl,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  total_pnl_quote: z.nullable(z.string()),
+  total_pnl_percent: z.nullable(z.string()).optional(),
+  total_pnl_usd: z.nullable(z.string()).optional(),
+}).transform((v) => {
+  return remap$(v, {
+    "total_pnl_quote": "totalPnlQuote",
+    "total_pnl_percent": "totalPnlPercent",
+    "total_pnl_usd": "totalPnlUsd",
+  });
+});
+
+export function loopedPositionPnlFromJSON(
+  jsonString: string,
+): SafeParseResult<LoopedPositionPnl, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => LoopedPositionPnl$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'LoopedPositionPnl' from JSON`,
+  );
+}

package/src/models/components/swapinfo.ts

@@ -9,19 +9,19 @@ import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 /**
- * The DEX swap leg detected inside a loop transaction.
+ * The swap leg detected inside a loop or unwind transaction.
  *
  * @remarks
  *
- * Evidence is token-filtered and executor-proof: the sold (debt) token left the
- * account to a non-protocol counterparty and the bought (collateral) token
- * arrived from a non-protocol counterparty. Aggregator fills often settle from an
- * executor contract, so the router is recorded only when it happens to be the
- * outbound counterparty — it is never required for detection.
+ * Evidence is token-filtered and executor-proof: the sold token left the
+ * account to a non-protocol counterparty and the bought token arrived from a
+ * non-protocol counterparty. Aggregator fills often settle from an executor
+ * contract, so the router is recorded only when it happens to be the outbound
+ * counterparty — it is never required for detection.
  */
 export type SwapInfo = {
   /**
-   * Token sold in the swap (the borrowed/debt token).
+   * The token leaving the account: the debt token on a loop, the collateral token on an unwind.
    */
   soldToken: string;
   /**
@@ -33,7 +33,7 @@ export type SwapInfo = {
    */
   soldAmount: string;
   /**
-   * Token bought in the swap (the collateral token).
+   * The token arriving in the account: the collateral token on a loop, the debt token on an unwind.
    */
   boughtToken: string;
   /**