compass_api_sdk 2.2.60__tar.gz → 2.2.61__tar.gz

{compass_api_sdk-2.2.60 → compass_api_sdk-2.2.61}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: compass_api_sdk
-Version: 2.2.60
+Version: 2.2.61
 Summary: Compass API SDK.
 Author: royalnine
 Requires-Python: >=3.10
@@ -253,6 +253,7 @@ with CompassAPI(
 * [earn_vaults](docs/sdks/earn/README.md#earn_vaults) - List vaults
 * [earn_aave_markets](docs/sdks/earn/README.md#earn_aave_markets) - List aave markets
 * [earn_pendle_markets](docs/sdks/earn/README.md#earn_pendle_markets) - List pendle markets
+* [earn_swap_quote](docs/sdks/earn/README.md#earn_swap_quote) - Quote a swap (read-only)
 * [earn_balances](docs/sdks/earn/README.md#earn_balances) - Get token balances
 * [earn_create_account](docs/sdks/earn/README.md#earn_create_account) - Create earn account
 * [earn_transfer](docs/sdks/earn/README.md#earn_transfer) - Transfer tokens to/from account
@@ -493,8 +494,8 @@ with CompassAPI(
 
 
 **Inherit from [`CompassAPIError`](./src/compass_api_sdk/errors/compassapierror.py)**:
-* [`TokenizedEquitiesErrorResponse`](./src/compass_api_sdk/errors/tokenizedequitieserrorresponse.py): Standard error envelope returned by every non-2xx response.  Surfaced in OpenAPI ``responses`` declarations so SDK consumers can decode failures uniformly without inspecting per-status-code shapes. Applicable to 8 of 125 methods.*
-* [`MintPrepareNotFoundResponseError`](./src/compass_api_sdk/errors/mintpreparenotfoundresponseerror.py): Response when the burn event has not been found yet.  This means the burn transaction hasn't been confirmed on-chain yet, or the user hasn't broadcast the burn transaction. Status code `404`. Applicable to 1 of 125 methods.*
+* [`TokenizedEquitiesErrorResponse`](./src/compass_api_sdk/errors/tokenizedequitieserrorresponse.py): Standard error envelope returned by every non-2xx response.  Surfaced in OpenAPI ``responses`` declarations so SDK consumers can decode failures uniformly without inspecting per-status-code shapes. Applicable to 8 of 126 methods.*
+* [`MintPrepareNotFoundResponseError`](./src/compass_api_sdk/errors/mintpreparenotfoundresponseerror.py): Response when the burn event has not been found yet.  This means the burn transaction hasn't been confirmed on-chain yet, or the user hasn't broadcast the burn transaction. Status code `404`. Applicable to 1 of 126 methods.*
 * [`ResponseValidationError`](./src/compass_api_sdk/errors/responsevalidationerror.py): Type mismatch between the response data and the expected Pydantic model. Provides access to the Pydantic validation error via the `cause` attribute.
 
 </details>

{compass_api_sdk-2.2.60 → compass_api_sdk-2.2.61}/README-PYPI.md

@@ -235,6 +235,7 @@ with CompassAPI(
 * [earn_vaults](docs/sdks/earn/README.md#earn_vaults) - List vaults
 * [earn_aave_markets](docs/sdks/earn/README.md#earn_aave_markets) - List aave markets
 * [earn_pendle_markets](docs/sdks/earn/README.md#earn_pendle_markets) - List pendle markets
+* [earn_swap_quote](docs/sdks/earn/README.md#earn_swap_quote) - Quote a swap (read-only)
 * [earn_balances](docs/sdks/earn/README.md#earn_balances) - Get token balances
 * [earn_create_account](docs/sdks/earn/README.md#earn_create_account) - Create earn account
 * [earn_transfer](docs/sdks/earn/README.md#earn_transfer) - Transfer tokens to/from account
@@ -475,8 +476,8 @@ with CompassAPI(
 
 
 **Inherit from [`CompassAPIError`](./src/compass_api_sdk/errors/compassapierror.py)**:
-* [`TokenizedEquitiesErrorResponse`](./src/compass_api_sdk/errors/tokenizedequitieserrorresponse.py): Standard error envelope returned by every non-2xx response.  Surfaced in OpenAPI ``responses`` declarations so SDK consumers can decode failures uniformly without inspecting per-status-code shapes. Applicable to 8 of 125 methods.*
-* [`MintPrepareNotFoundResponseError`](./src/compass_api_sdk/errors/mintpreparenotfoundresponseerror.py): Response when the burn event has not been found yet.  This means the burn transaction hasn't been confirmed on-chain yet, or the user hasn't broadcast the burn transaction. Status code `404`. Applicable to 1 of 125 methods.*
+* [`TokenizedEquitiesErrorResponse`](./src/compass_api_sdk/errors/tokenizedequitieserrorresponse.py): Standard error envelope returned by every non-2xx response.  Surfaced in OpenAPI ``responses`` declarations so SDK consumers can decode failures uniformly without inspecting per-status-code shapes. Applicable to 8 of 126 methods.*
+* [`MintPrepareNotFoundResponseError`](./src/compass_api_sdk/errors/mintpreparenotfoundresponseerror.py): Response when the burn event has not been found yet.  This means the burn transaction hasn't been confirmed on-chain yet, or the user hasn't broadcast the burn transaction. Status code `404`. Applicable to 1 of 126 methods.*
 * [`ResponseValidationError`](./src/compass_api_sdk/errors/responsevalidationerror.py): Type mismatch between the response data and the expected Pydantic model. Provides access to the Pydantic validation error via the `cause` attribute.
 
 </details>

{compass_api_sdk-2.2.60 → compass_api_sdk-2.2.61}/pyproject.toml

@@ -1,7 +1,7 @@
 
 [project]
 name = "compass_api_sdk"
-version = "2.2.60"
+version = "2.2.61"
 description = "Compass API SDK."
 authors = [{ name = "royalnine" },]
 readme = "README-PYPI.md"
@@ -14,7 +14,7 @@ dependencies = [
 
 [tool.poetry]
 name = "compass_api_sdk"
-version = "2.2.60"
+version = "2.2.61"
 description = "Compass API SDK."
 authors = ["Compass Labs"]
 repository = "https://github.com/CompassLabs/mono.git"

{compass_api_sdk-2.2.60 → compass_api_sdk-2.2.61}/src/compass_api_sdk/_version.py

@@ -5,8 +5,8 @@ import importlib.metadata
 __title__: str = "compass_api_sdk"
 __version__: str = "2.0.0"
 __openapi_doc_version__: str = "0.0.1"
-__gen_version__: str = "2.893.0"
-__user_agent__: str = "speakeasy-sdk/python 2.0.0 2.893.0 0.0.1 compass_api_sdk"
+__gen_version__: str = "2.897.1"
+__user_agent__: str = "speakeasy-sdk/python 2.0.0 2.897.1 0.0.1 compass_api_sdk"
 
 try:
     if __package__ is not None:

{compass_api_sdk-2.2.60 → compass_api_sdk-2.2.61}/src/compass_api_sdk/earn.py

@@ -1077,6 +1077,240 @@ class Earn(BaseSDK):
 
         raise errors.APIError("Unexpected response received", http_res)
 
+    def earn_swap_quote(
+        self,
+        *,
+        chain: models.V2EarnSwapQuoteChain,
+        token_in: str,
+        amount_in: Union[
+            models.V2EarnSwapQuoteAmountIn, models.V2EarnSwapQuoteAmountInTypedDict
+        ],
+        token_out: Optional[str] = None,
+        sy_address: OptionalNullable[str] = UNSET,
+        slippage: Optional[
+            Union[
+                models.V2EarnSwapQuoteSlippage, models.V2EarnSwapQuoteSlippageTypedDict
+            ]
+        ] = None,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> models.EarnSwapQuoteResponse:
+        r"""Quote a swap (read-only)
+
+        Estimate the output of a swap without building a transaction.
+
+        Returns the expected amount of `token_out` received for selling `amount_in`
+        of `token_in`, routed via 1inch. This is read-only: it does not build a
+        transaction, require an account, or check balances.
+
+        Use it to gauge exit liquidity and price impact for a token before entering
+        a position — for example, to warn when a market's underlying asset cannot be
+        swapped back to a stablecoin without large slippage.
+
+        :param chain: Target blockchain network.
+        :param token_in: Token to sell (input). A token symbol (e.g. 'WETH') or any token address.
+        :param amount_in: Human-readable amount of `token_in` to quote (token units, not wei).
+        :param token_out: Token to buy (output). A token symbol (e.g. 'USDC') or any token address.
+        :param sy_address: Optional Pendle SY (Standardized Yield) address. When provided, `token_in` is overridden with the token the PT actually redeems into on withdrawal (the SY asset if it is a valid token-out, else the SY yield token) — use this to gauge a Pendle position's real exit liquidity rather than the reported underlying.
+        :param slippage: Maximum slippage tolerance as a percentage (e.g., 1 = 1%).
+        :param retries: Override the default retry configuration for this method
+        :param server_url: Override the default server URL for this method
+        :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
+        :param http_headers: Additional headers to set or replace on requests.
+        """
+        base_url = None
+        url_variables = None
+        if timeout_ms is None:
+            timeout_ms = self.sdk_configuration.timeout_ms
+
+        if server_url is not None:
+            base_url = server_url
+        else:
+            base_url = self._get_url(base_url, url_variables)
+
+        request = models.V2EarnSwapQuoteRequest(
+            chain=chain,
+            token_in=token_in,
+            token_out=token_out,
+            sy_address=sy_address,
+            amount_in=amount_in,
+            slippage=slippage,
+        )
+
+        req = self._build_request(
+            method="GET",
+            path="/v2/earn/swap_quote",
+            base_url=base_url,
+            url_variables=url_variables,
+            request=request,
+            request_body_required=False,
+            request_has_path_params=False,
+            request_has_query_params=True,
+            user_agent_header="user-agent",
+            accept_header_value="application/json",
+            http_headers=http_headers,
+            security=self.sdk_configuration.security,
+            allow_empty_value=None,
+            timeout_ms=timeout_ms,
+        )
+
+        if retries == UNSET:
+            if self.sdk_configuration.retry_config is not UNSET:
+                retries = self.sdk_configuration.retry_config
+
+        retry_config = None
+        if isinstance(retries, utils.RetryConfig):
+            retry_config = (retries, ["429", "500", "502", "503", "504"])
+
+        http_res = self.do_request(
+            hook_ctx=HookContext(
+                config=self.sdk_configuration,
+                base_url=base_url or "",
+                operation_id="v2_earn_swap_quote",
+                oauth2_scopes=None,
+                security_source=self.sdk_configuration.security,
+            ),
+            request=req,
+            is_error_status_code=lambda c: utils.match_status_codes(["4XX", "5XX"], c),
+            retry_config=retry_config,
+        )
+
+        response_data: Any = None
+        if utils.match_response(http_res, "200", "application/json"):
+            return unmarshal_json_response(models.EarnSwapQuoteResponse, http_res)
+        if utils.match_response(http_res, "422", "application/json"):
+            response_data = unmarshal_json_response(
+                errors.HTTPValidationErrorData, http_res
+            )
+            raise errors.HTTPValidationError(response_data, http_res)
+        if utils.match_response(http_res, "4XX", "*"):
+            http_res_text = utils.stream_to_text(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+        if utils.match_response(http_res, "5XX", "*"):
+            http_res_text = utils.stream_to_text(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+
+        raise errors.APIError("Unexpected response received", http_res)
+
+    async def earn_swap_quote_async(
+        self,
+        *,
+        chain: models.V2EarnSwapQuoteChain,
+        token_in: str,
+        amount_in: Union[
+            models.V2EarnSwapQuoteAmountIn, models.V2EarnSwapQuoteAmountInTypedDict
+        ],
+        token_out: Optional[str] = None,
+        sy_address: OptionalNullable[str] = UNSET,
+        slippage: Optional[
+            Union[
+                models.V2EarnSwapQuoteSlippage, models.V2EarnSwapQuoteSlippageTypedDict
+            ]
+        ] = None,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> models.EarnSwapQuoteResponse:
+        r"""Quote a swap (read-only)
+
+        Estimate the output of a swap without building a transaction.
+
+        Returns the expected amount of `token_out` received for selling `amount_in`
+        of `token_in`, routed via 1inch. This is read-only: it does not build a
+        transaction, require an account, or check balances.
+
+        Use it to gauge exit liquidity and price impact for a token before entering
+        a position — for example, to warn when a market's underlying asset cannot be
+        swapped back to a stablecoin without large slippage.
+
+        :param chain: Target blockchain network.
+        :param token_in: Token to sell (input). A token symbol (e.g. 'WETH') or any token address.
+        :param amount_in: Human-readable amount of `token_in` to quote (token units, not wei).
+        :param token_out: Token to buy (output). A token symbol (e.g. 'USDC') or any token address.
+        :param sy_address: Optional Pendle SY (Standardized Yield) address. When provided, `token_in` is overridden with the token the PT actually redeems into on withdrawal (the SY asset if it is a valid token-out, else the SY yield token) — use this to gauge a Pendle position's real exit liquidity rather than the reported underlying.
+        :param slippage: Maximum slippage tolerance as a percentage (e.g., 1 = 1%).
+        :param retries: Override the default retry configuration for this method
+        :param server_url: Override the default server URL for this method
+        :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
+        :param http_headers: Additional headers to set or replace on requests.
+        """
+        base_url = None
+        url_variables = None
+        if timeout_ms is None:
+            timeout_ms = self.sdk_configuration.timeout_ms
+
+        if server_url is not None:
+            base_url = server_url
+        else:
+            base_url = self._get_url(base_url, url_variables)
+
+        request = models.V2EarnSwapQuoteRequest(
+            chain=chain,
+            token_in=token_in,
+            token_out=token_out,
+            sy_address=sy_address,
+            amount_in=amount_in,
+            slippage=slippage,
+        )
+
+        req = self._build_request_async(
+            method="GET",
+            path="/v2/earn/swap_quote",
+            base_url=base_url,
+            url_variables=url_variables,
+            request=request,
+            request_body_required=False,
+            request_has_path_params=False,
+            request_has_query_params=True,
+            user_agent_header="user-agent",
+            accept_header_value="application/json",
+            http_headers=http_headers,
+            security=self.sdk_configuration.security,
+            allow_empty_value=None,
+            timeout_ms=timeout_ms,
+        )
+
+        if retries == UNSET:
+            if self.sdk_configuration.retry_config is not UNSET:
+                retries = self.sdk_configuration.retry_config
+
+        retry_config = None
+        if isinstance(retries, utils.RetryConfig):
+            retry_config = (retries, ["429", "500", "502", "503", "504"])
+
+        http_res = await self.do_request_async(
+            hook_ctx=HookContext(
+                config=self.sdk_configuration,
+                base_url=base_url or "",
+                operation_id="v2_earn_swap_quote",
+                oauth2_scopes=None,
+                security_source=self.sdk_configuration.security,
+            ),
+            request=req,
+            is_error_status_code=lambda c: utils.match_status_codes(["4XX", "5XX"], c),
+            retry_config=retry_config,
+        )
+
+        response_data: Any = None
+        if utils.match_response(http_res, "200", "application/json"):
+            return unmarshal_json_response(models.EarnSwapQuoteResponse, http_res)
+        if utils.match_response(http_res, "422", "application/json"):
+            response_data = unmarshal_json_response(
+                errors.HTTPValidationErrorData, http_res
+            )
+            raise errors.HTTPValidationError(response_data, http_res)
+        if utils.match_response(http_res, "4XX", "*"):
+            http_res_text = await utils.stream_to_text_async(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+        if utils.match_response(http_res, "5XX", "*"):
+            http_res_text = await utils.stream_to_text_async(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+
+        raise errors.APIError("Unexpected response received", http_res)
+
     def earn_balances(
         self,
         *,

{compass_api_sdk-2.2.60 → compass_api_sdk-2.2.61}/src/compass_api_sdk/models/__init__.py

@@ -573,6 +573,10 @@ if TYPE_CHECKING:
         EarnSwapParamsSlippageTypedDict,
         EarnSwapParamsTypedDict,
     )
+    from .earnswapquoteresponse import (
+        EarnSwapQuoteResponse,
+        EarnSwapQuoteResponseTypedDict,
+    )
     from .earnswaprequest import (
         EarnSwapRequest,
         EarnSwapRequestAmountIn,
@@ -1040,6 +1044,7 @@ if TYPE_CHECKING:
     from .quotefee import QuoteFee, QuoteFeeTypedDict
     from .repay import Repay, RepayTypedDict
     from .reserve import Reserve, ReserveTypedDict
+    from .reserveinfo import ReserveInfo, ReserveInfoTypedDict
     from .safemessageeip712response import (
         SafeMessageEip712Response,
         SafeMessageEip712ResponseTypedDict,
@@ -1620,6 +1625,15 @@ if TYPE_CHECKING:
         V2EarnPositionsRequest,
         V2EarnPositionsRequestTypedDict,
     )
+    from .v2_earn_swap_quoteop import (
+        V2EarnSwapQuoteAmountIn,
+        V2EarnSwapQuoteAmountInTypedDict,
+        V2EarnSwapQuoteChain,
+        V2EarnSwapQuoteRequest,
+        V2EarnSwapQuoteRequestTypedDict,
+        V2EarnSwapQuoteSlippage,
+        V2EarnSwapQuoteSlippageTypedDict,
+    )
     from .v2_earn_vaultsop import (
         MinDepositCapUsd,
         MinDepositCapUsdTypedDict,
@@ -2114,6 +2128,8 @@ __all__ = [
     "EarnSwapParamsSlippage",
     "EarnSwapParamsSlippageTypedDict",
     "EarnSwapParamsTypedDict",
+    "EarnSwapQuoteResponse",
+    "EarnSwapQuoteResponseTypedDict",
     "EarnSwapRequest",
     "EarnSwapRequestAmountIn",
     "EarnSwapRequestAmountInTypedDict",
@@ -2471,6 +2487,8 @@ __all__ = [
     "RepayAmountTypedDict",
     "RepayTypedDict",
     "Reserve",
+    "ReserveInfo",
+    "ReserveInfoTypedDict",
     "ReserveTypedDict",
     "Response200V2CctpMint",
     "Response200V2CctpMintTypedDict",
@@ -2879,6 +2897,13 @@ __all__ = [
     "V2EarnPositionsChain",
     "V2EarnPositionsRequest",
     "V2EarnPositionsRequestTypedDict",
+    "V2EarnSwapQuoteAmountIn",
+    "V2EarnSwapQuoteAmountInTypedDict",
+    "V2EarnSwapQuoteChain",
+    "V2EarnSwapQuoteRequest",
+    "V2EarnSwapQuoteRequestTypedDict",
+    "V2EarnSwapQuoteSlippage",
+    "V2EarnSwapQuoteSlippageTypedDict",
     "V2EarnVaultsDirection",
     "V2EarnVaultsMinTvlUsd",
     "V2EarnVaultsMinTvlUsdTypedDict",
@@ -3347,6 +3372,8 @@ _dynamic_imports: dict[str, str] = {
     "EarnSwapParamsSlippage": ".earnswapparams",
     "EarnSwapParamsSlippageTypedDict": ".earnswapparams",
     "EarnSwapParamsTypedDict": ".earnswapparams",
+    "EarnSwapQuoteResponse": ".earnswapquoteresponse",
+    "EarnSwapQuoteResponseTypedDict": ".earnswapquoteresponse",
     "EarnSwapRequest": ".earnswaprequest",
     "EarnSwapRequestAmountIn": ".earnswaprequest",
     "EarnSwapRequestAmountInTypedDict": ".earnswaprequest",
@@ -3685,6 +3712,8 @@ _dynamic_imports: dict[str, str] = {
     "RepayTypedDict": ".repay",
     "Reserve": ".reserve",
     "ReserveTypedDict": ".reserve",
+    "ReserveInfo": ".reserveinfo",
+    "ReserveInfoTypedDict": ".reserveinfo",
     "SafeMessageEip712Response": ".safemessageeip712response",
     "SafeMessageEip712ResponseTypedDict": ".safemessageeip712response",
     "SafeMessageEip712Types": ".safemessageeip712types",
@@ -4090,6 +4119,13 @@ _dynamic_imports: dict[str, str] = {
     "V2EarnPositionsChain": ".v2_earn_positionsop",
     "V2EarnPositionsRequest": ".v2_earn_positionsop",
     "V2EarnPositionsRequestTypedDict": ".v2_earn_positionsop",
+    "V2EarnSwapQuoteAmountIn": ".v2_earn_swap_quoteop",
+    "V2EarnSwapQuoteAmountInTypedDict": ".v2_earn_swap_quoteop",
+    "V2EarnSwapQuoteChain": ".v2_earn_swap_quoteop",
+    "V2EarnSwapQuoteRequest": ".v2_earn_swap_quoteop",
+    "V2EarnSwapQuoteRequestTypedDict": ".v2_earn_swap_quoteop",
+    "V2EarnSwapQuoteSlippage": ".v2_earn_swap_quoteop",
+    "V2EarnSwapQuoteSlippageTypedDict": ".v2_earn_swap_quoteop",
     "MinDepositCapUsd": ".v2_earn_vaultsop",
     "MinDepositCapUsdTypedDict": ".v2_earn_vaultsop",
     "MinLiquidityUsd": ".v2_earn_vaultsop",

compass_api_sdk-2.2.61/src/compass_api_sdk/models/chainmarketinfo.py

@@ -0,0 +1,95 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+
+from __future__ import annotations
+from .reserveinfo import ReserveInfo, ReserveInfoTypedDict
+from compass_api_sdk.types import BaseModel, UNSET_SENTINEL
+from pydantic import model_serializer
+from typing import List, Optional
+from typing_extensions import NotRequired, TypedDict
+
+
+class ChainMarketInfoTypedDict(TypedDict):
+    r"""Rate information for a token on a specific chain.
+
+    The top-level fields describe the canonical (highest-liquidity) reserve for this
+    token on this chain, preserving the original single-reserve shape. `reserves`
+    lists every reserve for the token on this chain so clients can disambiguate
+    cases like native USDC vs bridged USDC.e on Arbitrum.
+    """
+
+    address: str
+    r"""Underlying token (reserve) contract address on this chain. This is Aave's canonical per-reserve identifier."""
+    a_token_address: str
+    r"""Aave aToken contract address on this chain. This is the interest-bearing token that represents the supply position."""
+    supply_apy: str
+    r"""Variable rate APY for deposits, in percentage (e.g., 4.5 means 4.5%)."""
+    borrow_apy: str
+    r"""Variable rate APY for loans, in percentage (e.g., 6.2 means 6.2%)."""
+    supply_apy_avg: str
+    r"""Variable rate APY for deposits averaged over the `days` window in the request (default 30 days), in percentage. Computed the same way as the v1 `/v1/aave/avg_rate` endpoint."""
+    borrow_apy_avg: str
+    r"""Variable rate APY for loans averaged over the `days` window in the request (default 30 days), in percentage. Computed the same way as the v1 `/v1/aave/avg_rate` endpoint."""
+    total_borrowed: str
+    r"""Total amount currently borrowed from this market, in token units (e.g., 1234567.89 USDC)."""
+    available_liquidity: str
+    r"""Amount of tokens available to borrow, in token units. Equals total supplied minus total borrowed."""
+    utilization_rate: str
+    r"""Percentage of supplied tokens that are currently borrowed (e.g., 85.0 means 85%)."""
+    reserves: NotRequired[List[ReserveInfoTypedDict]]
+    r"""Every Aave reserve for this token on this chain, ordered by liquidity (highest first). Identified by underlying `address`. For most tokens this has a single entry equal to the canonical reserve above; where a chain has multiple reserves for one symbol (e.g. Arbitrum native USDC and bridged USDC.e), all are listed with their individual rates."""
+
+
+class ChainMarketInfo(BaseModel):
+    r"""Rate information for a token on a specific chain.
+
+    The top-level fields describe the canonical (highest-liquidity) reserve for this
+    token on this chain, preserving the original single-reserve shape. `reserves`
+    lists every reserve for the token on this chain so clients can disambiguate
+    cases like native USDC vs bridged USDC.e on Arbitrum.
+    """
+
+    address: str
+    r"""Underlying token (reserve) contract address on this chain. This is Aave's canonical per-reserve identifier."""
+
+    a_token_address: str
+    r"""Aave aToken contract address on this chain. This is the interest-bearing token that represents the supply position."""
+
+    supply_apy: str
+    r"""Variable rate APY for deposits, in percentage (e.g., 4.5 means 4.5%)."""
+
+    borrow_apy: str
+    r"""Variable rate APY for loans, in percentage (e.g., 6.2 means 6.2%)."""
+
+    supply_apy_avg: str
+    r"""Variable rate APY for deposits averaged over the `days` window in the request (default 30 days), in percentage. Computed the same way as the v1 `/v1/aave/avg_rate` endpoint."""
+
+    borrow_apy_avg: str
+    r"""Variable rate APY for loans averaged over the `days` window in the request (default 30 days), in percentage. Computed the same way as the v1 `/v1/aave/avg_rate` endpoint."""
+
+    total_borrowed: str
+    r"""Total amount currently borrowed from this market, in token units (e.g., 1234567.89 USDC)."""
+
+    available_liquidity: str
+    r"""Amount of tokens available to borrow, in token units. Equals total supplied minus total borrowed."""
+
+    utilization_rate: str
+    r"""Percentage of supplied tokens that are currently borrowed (e.g., 85.0 means 85%)."""
+
+    reserves: Optional[List[ReserveInfo]] = None
+    r"""Every Aave reserve for this token on this chain, ordered by liquidity (highest first). Identified by underlying `address`. For most tokens this has a single entry equal to the canonical reserve above; where a chain has multiple reserves for one symbol (e.g. Arbitrum native USDC and bridged USDC.e), all are listed with their individual rates."""
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["reserves"])
+        serialized = handler(self)
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k, serialized.get(n))
+
+            if val != UNSET_SENTINEL:
+                if val is not None or k not in optional_fields:
+                    m[k] = val
+
+        return m

compass_api_sdk-2.2.61/src/compass_api_sdk/models/earnswapquoteresponse.py

@@ -0,0 +1,29 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+
+from __future__ import annotations
+from compass_api_sdk.types import BaseModel
+from typing_extensions import TypedDict
+
+
+class EarnSwapQuoteResponseTypedDict(TypedDict):
+    r"""Estimated output of a read-only swap quote."""
+
+    amount_out: str
+    r"""Estimated amount of `token_out` received, in human-readable units. Zero when no route / insufficient liquidity exists for the pair."""
+    token_in: str
+    r"""The token address actually quoted as input. Usually the requested `token_in`; for Pendle (when `sy_address` is supplied) it is the resolved redeem token, which callers should use to value the input."""
+    token_out: str
+    r"""The token address quoted as output — what `amount_out` is denominated in (the resolved `token_out` from the request)."""
+
+
+class EarnSwapQuoteResponse(BaseModel):
+    r"""Estimated output of a read-only swap quote."""
+
+    amount_out: str
+    r"""Estimated amount of `token_out` received, in human-readable units. Zero when no route / insufficient liquidity exists for the pair."""
+
+    token_in: str
+    r"""The token address actually quoted as input. Usually the requested `token_in`; for Pendle (when `sy_address` is supplied) it is the resolved redeem token, which callers should use to value the input."""
+
+    token_out: str
+    r"""The token address quoted as output — what `amount_out` is denominated in (the resolved `token_out` from the request)."""

compass_api_sdk-2.2.60/src/compass_api_sdk/models/chainmarketinfo.py → compass_api_sdk-2.2.61/src/compass_api_sdk/models/reserveinfo.py

@@ -5,11 +5,17 @@ from compass_api_sdk.types import BaseModel
 from typing_extensions import TypedDict
 
 
-class ChainMarketInfoTypedDict(TypedDict):
-    r"""Rate information for a token on a specific chain."""
+class ReserveInfoTypedDict(TypedDict):
+    r"""Rate and liquidity information for a single Aave reserve on a chain.
+
+    A reserve is identified by its underlying token `address` — Aave's canonical
+    reserve identifier. The same token symbol can map to more than one reserve on a
+    chain (e.g. native USDC and bridged USDC.e on Arbitrum), each with its own rates
+    and liquidity.
+    """
 
     address: str
-    r"""Token contract address on this chain."""
+    r"""Underlying token (reserve) contract address on this chain. This is Aave's canonical per-reserve identifier."""
     a_token_address: str
     r"""Aave aToken contract address on this chain. This is the interest-bearing token that represents the supply position."""
     supply_apy: str
@@ -28,11 +34,17 @@ class ChainMarketInfoTypedDict(TypedDict):
     r"""Percentage of supplied tokens that are currently borrowed (e.g., 85.0 means 85%)."""
 
 
-class ChainMarketInfo(BaseModel):
-    r"""Rate information for a token on a specific chain."""
+class ReserveInfo(BaseModel):
+    r"""Rate and liquidity information for a single Aave reserve on a chain.
+
+    A reserve is identified by its underlying token `address` — Aave's canonical
+    reserve identifier. The same token symbol can map to more than one reserve on a
+    chain (e.g. native USDC and bridged USDC.e on Arbitrum), each with its own rates
+    and liquidity.
+    """
 
     address: str
-    r"""Token contract address on this chain."""
+    r"""Underlying token (reserve) contract address on this chain. This is Aave's canonical per-reserve identifier."""
 
     a_token_address: str
     r"""Aave aToken contract address on this chain. This is the interest-bearing token that represents the supply position."""