@compass-labs/api-sdk 2.2.105-rc.0 → 2.2.106

package/docs/sdks/riskyield/README.md

@@ -0,0 +1,1272 @@
+# RiskYield
+
+## Overview
+
+### Available Operations
+
+* [riskYieldTokens](#riskyieldtokens) - List tokens
+* [riskYieldPools](#riskyieldpools) - List pools
+* [riskYieldPoolsPoolId](#riskyieldpoolspoolid) - Get pool detail
+* [riskYieldPositions](#riskyieldpositions) - List LP positions
+* [riskYieldRiskScenarios](#riskyieldriskscenarios) - Model impermanent loss
+* [riskYieldCreateAccount](#riskyieldcreateaccount) - Create account
+* [riskYieldTransfer](#riskyieldtransfer) - Transfer tokens to/from account
+* [riskYieldSwap](#riskyieldswap) - Swap tokens
+* [riskYieldMint](#riskyieldmint) - Open a position
+* [riskYieldIncrease](#riskyieldincrease) - Add to a position
+* [riskYieldDecrease](#riskyielddecrease) - Withdraw from a position
+* [riskYieldCollect](#riskyieldcollect) - Collect fees
+* [riskYieldRebalance](#riskyieldrebalance) - Rebalance a position
+
+## riskYieldTokens
+
+The assets that trade on Robinhood Chain.
+
+Tokenized stocks carry their issuer metadata, including the corporate-action
+multiplier — balances do not rebase on a split, so a quote for the
+underlying only becomes a token price once that is applied.
+
+Memecoins carry the launch they came from. Every price carries the source it
+was resolved from and a confidence: below 0.6 it came from a pool shallow
+enough that one trade moves it, and every dollar figure derived from it is
+indicative.
+
+### Example Usage
+
+<!-- UsageSnippet language="typescript" operationID="v2_risk_yield_tokens" method="get" path="/v2/risk_yield/tokens" -->
+```typescript
+import { CompassApiSDK } from "@compass-labs/api-sdk";
+
+const compassApiSDK = new CompassApiSDK({
+  apiKeyAuth: "<YOUR_API_KEY_HERE>",
+});
+
+async function run() {
+  const result = await compassApiSDK.riskYield.riskYieldTokens({
+    offset: 0,
+    limit: 20,
+    chain: "robinhood",
+    kind: "STOCK",
+    orderBy: "liquidity_usd",
+  });
+
+  console.log(result);
+}
+
+run();
+```
+
+### Standalone function
+
+The standalone function version of this method:
+
+```typescript
+import { CompassApiSDKCore } from "@compass-labs/api-sdk/core.js";
+import { riskYieldRiskYieldTokens } from "@compass-labs/api-sdk/funcs/riskYieldRiskYieldTokens.js";
+
+// Use `CompassApiSDKCore` for best tree-shaking performance.
+// You can create one instance of it to use across an application.
+const compassApiSDK = new CompassApiSDKCore({
+  apiKeyAuth: "<YOUR_API_KEY_HERE>",
+});
+
+async function run() {
+  const res = await riskYieldRiskYieldTokens(compassApiSDK, {
+    offset: 0,
+    limit: 20,
+    chain: "robinhood",
+    kind: "STOCK",
+    orderBy: "liquidity_usd",
+  });
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("riskYieldRiskYieldTokens failed:", res.error);
+  }
+}
+
+run();
+```
+
+### Parameters
+
+| Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `request`                                                                                                                                                                      | [operations.V2RiskYieldTokensRequest](../../models/operations/v2riskyieldtokensrequest.md)                                                                                     | :heavy_check_mark:                                                                                                                                                             | The request object to use for the request.                                                                                                                                     |
+| `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |
+| `options.fetchOptions`                                                                                                                                                         | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options)                                                                                        | :heavy_minus_sign:                                                                                                                                                             | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
+| `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |
+
+### Response
+
+**Promise\<[components.DexTokensResponse](../../models/components/dextokensresponse.md)\>**
+
+### Errors
+
+| Error Type                 | Status Code                | Content Type               |
+| -------------------------- | -------------------------- | -------------------------- |
+| errors.HTTPValidationError | 422                        | application/json           |
+| errors.APIError            | 4XX, 5XX                   | \*/\*                      |
+
+## riskYieldPools
+
+Pools you could provide liquidity to, ranked by what you would keep.
+
+**Read `lp_earns_fees` first.** The launchpad that dominates this chain
+graduates tokens into pools whose hook takes the swap fee, so they trade
+enormously and pay an external liquidity provider nothing. Those pools are
+listed — they carry the memecoin's price and volume — with a fee APR of
+exactly zero and a note saying why. Pass `lp_earns_fees=true` to hide them.
+
+The default ordering is `il_adjusted_apr_7d`: the fee APR less the expected
+impermanent-loss drag from the pair's own volatility. A pool paying 200% on
+an asset that moves 400% is not a better position than one paying 20% on an
+asset that moves 30%, and sorting on the raw APR would say it was.
+
+Pools too thin for a rate to mean anything — under 20 swaps a day, or under
+$1,000 of liquidity — are served with `ranked: false` and always sort last.
+
+### Example Usage
+
+<!-- UsageSnippet language="typescript" operationID="v2_risk_yield_pools" method="get" path="/v2/risk_yield/pools" -->
+```typescript
+import { CompassApiSDK } from "@compass-labs/api-sdk";
+
+const compassApiSDK = new CompassApiSDK({
+  apiKeyAuth: "<YOUR_API_KEY_HERE>",
+});
+
+async function run() {
+  const result = await compassApiSDK.riskYield.riskYieldPools({
+    offset: 0,
+    limit: 20,
+    chain: "robinhood",
+    pairClass: "MEME_STOCK",
+    lpEarnsFees: true,
+    lpOpen: true,
+    orderBy: "il_adjusted_apr_7d",
+  });
+
+  console.log(result);
+}
+
+run();
+```
+
+### Standalone function
+
+The standalone function version of this method:
+
+```typescript
+import { CompassApiSDKCore } from "@compass-labs/api-sdk/core.js";
+import { riskYieldRiskYieldPools } from "@compass-labs/api-sdk/funcs/riskYieldRiskYieldPools.js";
+
+// Use `CompassApiSDKCore` for best tree-shaking performance.
+// You can create one instance of it to use across an application.
+const compassApiSDK = new CompassApiSDKCore({
+  apiKeyAuth: "<YOUR_API_KEY_HERE>",
+});
+
+async function run() {
+  const res = await riskYieldRiskYieldPools(compassApiSDK, {
+    offset: 0,
+    limit: 20,
+    chain: "robinhood",
+    pairClass: "MEME_STOCK",
+    lpEarnsFees: true,
+    lpOpen: true,
+    orderBy: "il_adjusted_apr_7d",
+  });
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("riskYieldRiskYieldPools failed:", res.error);
+  }
+}
+
+run();
+```
+
+### Parameters
+
+| Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `request`                                                                                                                                                                      | [operations.V2RiskYieldPoolsRequest](../../models/operations/v2riskyieldpoolsrequest.md)                                                                                       | :heavy_check_mark:                                                                                                                                                             | The request object to use for the request.                                                                                                                                     |
+| `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |
+| `options.fetchOptions`                                                                                                                                                         | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options)                                                                                        | :heavy_minus_sign:                                                                                                                                                             | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
+| `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |
+
+### Response
+
+**Promise\<[components.DexPoolsResponse](../../models/components/dexpoolsresponse.md)\>**
+
+### Errors
+
+| Error Type                 | Status Code                | Content Type               |
+| -------------------------- | -------------------------- | -------------------------- |
+| errors.HTTPValidationError | 422                        | application/json           |
+| errors.APIError            | 4XX, 5XX                   | \*/\*                      |
+
+## riskYieldPoolsPoolId
+
+One pool, with its price history and the caveats that apply to it.
+
+For a pool holding a tokenized stock, `stock_reference` compares the pool's
+price against the stock's own. They drift: the pool trades around the clock
+while the stock trades in a session, and that gap is what a liquidity
+provider is quoting against overnight.
+
+### Example Usage
+
+<!-- UsageSnippet language="typescript" operationID="v2_risk_yield_pools_{pool_id}" method="get" path="/v2/risk_yield/pools/{pool_id}" -->
+```typescript
+import { CompassApiSDK } from "@compass-labs/api-sdk";
+
+const compassApiSDK = new CompassApiSDK({
+  apiKeyAuth: "<YOUR_API_KEY_HERE>",
+});
+
+async function run() {
+  const result = await compassApiSDK.riskYield.riskYieldPoolsPoolId({
+    poolId: 174842,
+    chain: "robinhood",
+    depthWords: 4,
+    history: "7d",
+  });
+
+  console.log(result);
+}
+
+run();
+```
+
+### Standalone function
+
+The standalone function version of this method:
+
+```typescript
+import { CompassApiSDKCore } from "@compass-labs/api-sdk/core.js";
+import { riskYieldRiskYieldPoolsPoolId } from "@compass-labs/api-sdk/funcs/riskYieldRiskYieldPoolsPoolId.js";
+
+// Use `CompassApiSDKCore` for best tree-shaking performance.
+// You can create one instance of it to use across an application.
+const compassApiSDK = new CompassApiSDKCore({
+  apiKeyAuth: "<YOUR_API_KEY_HERE>",
+});
+
+async function run() {
+  const res = await riskYieldRiskYieldPoolsPoolId(compassApiSDK, {
+    poolId: 174842,
+    chain: "robinhood",
+    depthWords: 4,
+    history: "7d",
+  });
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("riskYieldRiskYieldPoolsPoolId failed:", res.error);
+  }
+}
+
+run();
+```
+
+### Parameters
+
+| Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `request`                                                                                                                                                                      | [operations.V2RiskYieldPoolsPoolIdRequest](../../models/operations/v2riskyieldpoolspoolidrequest.md)                                                                           | :heavy_check_mark:                                                                                                                                                             | The request object to use for the request.                                                                                                                                     |
+| `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |
+| `options.fetchOptions`                                                                                                                                                         | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options)                                                                                        | :heavy_minus_sign:                                                                                                                                                             | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
+| `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |
+
+### Response
+
+**Promise\<[components.DexPoolDetailResponse](../../models/components/dexpooldetailresponse.md)\>**
+
+### Errors
+
+| Error Type                 | Status Code                | Content Type               |
+| -------------------------- | -------------------------- | -------------------------- |
+| errors.HTTPValidationError | 422                        | application/json           |
+| errors.APIError            | 4XX, 5XX                   | \*/\*                      |
+
+## riskYieldPositions
+
+Your liquidity positions: what they hold, what they cost, what they paid.
+
+Only the first of those is on chain. A position reports its liquidity and
+its range; it does not report the amounts that opened it or what has already
+been collected. Those come from recorded events, and where there are none
+`cost_basis.source` is `unavailable` and the PnL fields are null rather than
+guessed — an invented cost basis would make every number derived from it
+wrong in the same direction.
+
+`hold_value_usd` is what the deposited amounts would be worth if they had
+simply been held. The gap between that and `value_usd` is impermanent loss,
+and it is the number that decides whether the fees were worth it.
+
+`needs_rebalance` and `rebalance_reasons` say what the API would look at, not
+what it will do: rebalancing realizes the loss, pays gas twice and a swap,
+and puts the position back at risk from a new price.
+
+### Example Usage
+
+<!-- UsageSnippet language="typescript" operationID="v2_risk_yield_positions" method="get" path="/v2/risk_yield/positions" -->
+```typescript
+import { CompassApiSDK } from "@compass-labs/api-sdk";
+
+const compassApiSDK = new CompassApiSDK({
+  apiKeyAuth: "<YOUR_API_KEY_HERE>",
+});
+
+async function run() {
+  const result = await compassApiSDK.riskYield.riskYieldPositions({
+    chain: "robinhood",
+    owner: "0x06A9aF046187895AcFc7258450B15397CAc67400",
+    includeClosed: false,
+  });
+
+  console.log(result);
+}
+
+run();
+```
+
+### Standalone function
+
+The standalone function version of this method:
+
+```typescript
+import { CompassApiSDKCore } from "@compass-labs/api-sdk/core.js";
+import { riskYieldRiskYieldPositions } from "@compass-labs/api-sdk/funcs/riskYieldRiskYieldPositions.js";
+
+// Use `CompassApiSDKCore` for best tree-shaking performance.
+// You can create one instance of it to use across an application.
+const compassApiSDK = new CompassApiSDKCore({
+  apiKeyAuth: "<YOUR_API_KEY_HERE>",
+});
+
+async function run() {
+  const res = await riskYieldRiskYieldPositions(compassApiSDK, {
+    chain: "robinhood",
+    owner: "0x06A9aF046187895AcFc7258450B15397CAc67400",
+    includeClosed: false,
+  });
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("riskYieldRiskYieldPositions failed:", res.error);
+  }
+}
+
+run();
+```
+
+### Parameters
+
+| Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `request`                                                                                                                                                                      | [operations.V2RiskYieldPositionsRequest](../../models/operations/v2riskyieldpositionsrequest.md)                                                                               | :heavy_check_mark:                                                                                                                                                             | The request object to use for the request.                                                                                                                                     |
+| `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |
+| `options.fetchOptions`                                                                                                                                                         | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options)                                                                                        | :heavy_minus_sign:                                                                                                                                                             | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
+| `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |
+
+### Response
+
+**Promise\<[components.RiskYieldPositionsResponse](../../models/components/riskyieldpositionsresponse.md)\>**
+
+### Errors
+
+| Error Type                 | Status Code                | Content Type               |
+| -------------------------- | -------------------------- | -------------------------- |
+| errors.HTTPValidationError | 422                        | application/json           |
+| errors.APIError            | 4XX, 5XX                   | \*/\*                      |
+
+## riskYieldRiskScenarios
+
+What this position would do if the price moved — and how likely that is.
+
+A fee APR on a memecoin pair means nothing without the loss it is paid
+against, which is what this measures.
+
+Each scenario takes **two** independent moves, and keeping them apart is the
+point. `ratio_move_pct` is how far the pair's ratio travels, and that is
+what causes impermanent loss. `quote_usd_move_pct` is how far the stock
+moves in dollars, which scales what the position is worth without touching
+the ratio at all — a stock-only move produces an impermanent loss of exactly
+zero. "NVDA drops 10%" and "the memecoin drops 10% against NVDA" are
+different questions, and one number cannot ask both.
+
+The two most useful columns are `breakeven_fee_apr_pct` — what this position
+would have to earn for the loss to be worth taking, which you can compare
+against the pool's actual fee APR — and `days_of_fees_to_recover_il`, which
+is null when the pool pays liquidity providers nothing, because no amount of
+time fixes that.
+
+`probabilistic` runs the pair's own measured volatility through a driftless
+simulation. Driftless deliberately: nobody knows which way a memecoin goes,
+and a model that assumed one would be predicting returns rather than
+measuring risk. It is absent when the pair has no measured volatility —
+which a pool with a few hours of history does not — because a distribution
+built on zero would report that nothing can happen.
+
+### Example Usage
+
+<!-- UsageSnippet language="typescript" operationID="v2_risk_yield_risk_scenarios" method="post" path="/v2/risk_yield/risk/scenarios" -->
+```typescript
+import { CompassApiSDK } from "@compass-labs/api-sdk";
+
+const compassApiSDK = new CompassApiSDK({
+  apiKeyAuth: "<YOUR_API_KEY_HERE>",
+});
+
+async function run() {
+  const result = await compassApiSDK.riskYield.riskYieldRiskScenarios({
+    chain: "robinhood",
+    pool: {
+      poolId: 1,
+    },
+    range: {
+      type: "symmetric_pct",
+      widthPct: "30",
+    },
+    deposit: {
+      type: "usd",
+      valueUsd: "1000",
+    },
+    horizonDays: 30,
+    scenarios: [
+      {
+        name: "meme halves",
+        ratioMovePct: "-50",
+      },
+      {
+        name: "meme doubles",
+        ratioMovePct: "100",
+      },
+      {
+        name: "stock falls 10%",
+        quoteUsdMovePct: "-10",
+      },
+    ],
+  });
+
+  console.log(result);
+}
+
+run();
+```
+
+### Standalone function
+
+The standalone function version of this method:
+
+```typescript
+import { CompassApiSDKCore } from "@compass-labs/api-sdk/core.js";
+import { riskYieldRiskYieldRiskScenarios } from "@compass-labs/api-sdk/funcs/riskYieldRiskYieldRiskScenarios.js";
+
+// Use `CompassApiSDKCore` for best tree-shaking performance.
+// You can create one instance of it to use across an application.
+const compassApiSDK = new CompassApiSDKCore({
+  apiKeyAuth: "<YOUR_API_KEY_HERE>",
+});
+
+async function run() {
+  const res = await riskYieldRiskYieldRiskScenarios(compassApiSDK, {
+    chain: "robinhood",
+    pool: {
+      poolId: 1,
+    },
+    range: {
+      type: "symmetric_pct",
+      widthPct: "30",
+    },
+    deposit: {
+      type: "usd",
+      valueUsd: "1000",
+    },
+    horizonDays: 30,
+    scenarios: [
+      {
+        name: "meme halves",
+        ratioMovePct: "-50",
+      },
+      {
+        name: "meme doubles",
+        ratioMovePct: "100",
+      },
+      {
+        name: "stock falls 10%",
+        quoteUsdMovePct: "-10",
+      },
+    ],
+  });
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("riskYieldRiskYieldRiskScenarios failed:", res.error);
+  }
+}
+
+run();
+```
+
+### Parameters
+
+| Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `request`                                                                                                                                                                      | [components.RiskScenariosRequest](../../models/components/riskscenariosrequest.md)                                                                                             | :heavy_check_mark:                                                                                                                                                             | The request object to use for the request.                                                                                                                                     |
+| `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |
+| `options.fetchOptions`                                                                                                                                                         | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options)                                                                                        | :heavy_minus_sign:                                                                                                                                                             | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
+| `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |
+
+### Response
+
+**Promise\<[components.RiskScenariosResponse](../../models/components/riskscenariosresponse.md)\>**
+
+### Errors
+
+| Error Type                 | Status Code                | Content Type               |
+| -------------------------- | -------------------------- | -------------------------- |
+| errors.HTTPValidationError | 422                        | application/json           |
+| errors.APIError            | 4XX, 5XX                   | \*/\*                      |
+
+## riskYieldCreateAccount
+
+Create the Risk Yield Account that will hold your LP positions.
+
+Liquidity is provided from an account, not from your wallet, so this comes
+first. The address is deterministic from the `owner`, and it is the **same
+account as your Earn Account** on this chain — if you already have one,
+this returns it with `transaction: null` and nothing needs to be signed.
+
+**If the owner pays gas:** set `sender` to the owner's address.
+
+**If someone else pays:** set `sender` to whoever will broadcast.
+
+### Example Usage
+
+<!-- UsageSnippet language="typescript" operationID="v2_risk_yield_create_account" method="post" path="/v2/risk_yield/create_account" -->
+```typescript
+import { CompassApiSDK } from "@compass-labs/api-sdk";
+
+const compassApiSDK = new CompassApiSDK({
+  apiKeyAuth: "<YOUR_API_KEY_HERE>",
+});
+
+async function run() {
+  const result = await compassApiSDK.riskYield.riskYieldCreateAccount({
+    sender: "0xdB035cb494EEE30996fbDD25a7b1Fa38D795bdC6",
+    owner: "0xdB035cb494EEE30996fbDD25a7b1Fa38D795bdC6",
+  });
+
+  console.log(result);
+}
+
+run();
+```
+
+### Standalone function
+
+The standalone function version of this method:
+
+```typescript
+import { CompassApiSDKCore } from "@compass-labs/api-sdk/core.js";
+import { riskYieldRiskYieldCreateAccount } from "@compass-labs/api-sdk/funcs/riskYieldRiskYieldCreateAccount.js";
+
+// Use `CompassApiSDKCore` for best tree-shaking performance.
+// You can create one instance of it to use across an application.
+const compassApiSDK = new CompassApiSDKCore({
+  apiKeyAuth: "<YOUR_API_KEY_HERE>",
+});
+
+async function run() {
+  const res = await riskYieldRiskYieldCreateAccount(compassApiSDK, {
+    sender: "0xdB035cb494EEE30996fbDD25a7b1Fa38D795bdC6",
+    owner: "0xdB035cb494EEE30996fbDD25a7b1Fa38D795bdC6",
+  });
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("riskYieldRiskYieldCreateAccount failed:", res.error);
+  }
+}
+
+run();
+```
+
+### Parameters
+
+| Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `request`                                                                                                                                                                      | [components.CreateRiskYieldAccountRequest](../../models/components/createriskyieldaccountrequest.md)                                                                           | :heavy_check_mark:                                                                                                                                                             | The request object to use for the request.                                                                                                                                     |
+| `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |
+| `options.fetchOptions`                                                                                                                                                         | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options)                                                                                        | :heavy_minus_sign:                                                                                                                                                             | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
+| `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |
+
+### Response
+
+**Promise\<[components.CreateRiskYieldAccountResponse](../../models/components/createriskyieldaccountresponse.md)\>**
+
+### Errors
+
+| Error Type                 | Status Code                | Content Type               |
+| -------------------------- | -------------------------- | -------------------------- |
+| errors.HTTPValidationError | 422                        | application/json           |
+| errors.APIError            | 4XX, 5XX                   | \*/\*                      |
+
+## riskYieldTransfer
+
+Move tokens between your wallet and your Risk Yield Account.
+
+`DEPOSIT` pulls from the owner's wallet into the account; `WITHDRAW` sends
+them back. Native ETH is supported, which matters here because many pools on
+this chain are quoted in it.
+
+The account is shared with Earn, so a deposit made through either product is
+available to both.
+
+### Example Usage
+
+<!-- UsageSnippet language="typescript" operationID="v2_risk_yield_transfer" method="post" path="/v2/risk_yield/transfer" -->
+```typescript
+import { CompassApiSDK } from "@compass-labs/api-sdk";
+
+const compassApiSDK = new CompassApiSDK({
+  apiKeyAuth: "<YOUR_API_KEY_HERE>",
+});
+
+async function run() {
+  const result = await compassApiSDK.riskYield.riskYieldTransfer({
+    owner: "0x06A9aF046187895AcFc7258450B15397CAc67400",
+    chain: "robinhood",
+    token: "USDG",
+    amount: "10",
+    action: "DEPOSIT",
+  });
+
+  console.log(result);
+}
+
+run();
+```
+
+### Standalone function
+
+The standalone function version of this method:
+
+```typescript
+import { CompassApiSDKCore } from "@compass-labs/api-sdk/core.js";
+import { riskYieldRiskYieldTransfer } from "@compass-labs/api-sdk/funcs/riskYieldRiskYieldTransfer.js";
+
+// Use `CompassApiSDKCore` for best tree-shaking performance.
+// You can create one instance of it to use across an application.
+const compassApiSDK = new CompassApiSDKCore({
+  apiKeyAuth: "<YOUR_API_KEY_HERE>",
+});
+
+async function run() {
+  const res = await riskYieldRiskYieldTransfer(compassApiSDK, {
+    owner: "0x06A9aF046187895AcFc7258450B15397CAc67400",
+    chain: "robinhood",
+    token: "USDG",
+    amount: "10",
+    action: "DEPOSIT",
+  });
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("riskYieldRiskYieldTransfer failed:", res.error);
+  }
+}
+
+run();
+```
+
+### Parameters
+
+| Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `request`                                                                                                                                                                      | [components.RiskYieldTransferRequest](../../models/components/riskyieldtransferrequest.md)                                                                                     | :heavy_check_mark:                                                                                                                                                             | The request object to use for the request.                                                                                                                                     |
+| `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |
+| `options.fetchOptions`                                                                                                                                                         | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options)                                                                                        | :heavy_minus_sign:                                                                                                                                                             | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
+| `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |
+
+### Response
+
+**Promise\<[components.EarnTransferResponse](../../models/components/earntransferresponse.md)\>**
+
+### Errors
+
+| Error Type                 | Status Code                | Content Type               |
+| -------------------------- | -------------------------- | -------------------------- |
+| errors.HTTPValidationError | 422                        | application/json           |
+| errors.APIError            | 4XX, 5XX                   | \*/\*                      |
+
+## riskYieldSwap
+
+Trade one token for another from inside your Risk Yield Account.
+
+Mostly used to reach the ratio a range needs before opening a position:
+a range fixes the proportion of the two assets, and a caller holding one of
+them has to swap to it.
+
+There is no aggregator on this chain, so the route is a Uniswap v3 pool. The
+API quotes every enabled fee tier and takes whichever returns the most — a
+1% pool with depth beats a 0.05% pool with none, which here is the common
+case rather than the corner one.
+
+The transaction is simulated before it is returned. A failing simulation is
+a 422 rather than something to sign: on this chain a token may tax
+transfers, block an address or be paused, and none of that is visible until
+the call is actually made.
+
+### Example Usage
+
+<!-- UsageSnippet language="typescript" operationID="v2_risk_yield_swap" method="post" path="/v2/risk_yield/swap" -->
+```typescript
+import { CompassApiSDK } from "@compass-labs/api-sdk";
+
+const compassApiSDK = new CompassApiSDK({
+  apiKeyAuth: "<YOUR_API_KEY_HERE>",
+});
+
+async function run() {
+  const result = await compassApiSDK.riskYield.riskYieldSwap({
+    owner: "0x06A9aF046187895AcFc7258450B15397CAc67400",
+    chain: "robinhood",
+    tokenIn: "USDG",
+    tokenOut: "WETH",
+    amountIn: "100",
+  });
+
+  console.log(result);
+}
+
+run();
+```
+
+### Standalone function
+
+The standalone function version of this method:
+
+```typescript
+import { CompassApiSDKCore } from "@compass-labs/api-sdk/core.js";
+import { riskYieldRiskYieldSwap } from "@compass-labs/api-sdk/funcs/riskYieldRiskYieldSwap.js";
+
+// Use `CompassApiSDKCore` for best tree-shaking performance.
+// You can create one instance of it to use across an application.
+const compassApiSDK = new CompassApiSDKCore({
+  apiKeyAuth: "<YOUR_API_KEY_HERE>",
+});
+
+async function run() {
+  const res = await riskYieldRiskYieldSwap(compassApiSDK, {
+    owner: "0x06A9aF046187895AcFc7258450B15397CAc67400",
+    chain: "robinhood",
+    tokenIn: "USDG",
+    tokenOut: "WETH",
+    amountIn: "100",
+  });
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("riskYieldRiskYieldSwap failed:", res.error);
+  }
+}
+
+run();
+```
+
+### Parameters
+
+| Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `request`                                                                                                                                                                      | [components.RiskYieldSwapRequest](../../models/components/riskyieldswaprequest.md)                                                                                             | :heavy_check_mark:                                                                                                                                                             | The request object to use for the request.                                                                                                                                     |
+| `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |
+| `options.fetchOptions`                                                                                                                                                         | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options)                                                                                        | :heavy_minus_sign:                                                                                                                                                             | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
+| `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |
+
+### Response
+
+**Promise\<[components.RiskYieldSwapResponse](../../models/components/riskyieldswapresponse.md)\>**
+
+### Errors
+
+| Error Type                 | Status Code                | Content Type               |
+| -------------------------- | -------------------------- | -------------------------- |
+| errors.HTTPValidationError | 422                        | application/json           |
+| errors.APIError            | 4XX, 5XX                   | \*/\*                      |
+
+## riskYieldMint
+
+Provide liquidity to a pool over a price range.
+
+The range you ask for is not quite the range you get: ticks are discrete, so
+a 30% band becomes the usable ticks that bracket it — snapped outward, never
+inward, because a position that stops earning sooner than you expected is
+the worse surprise. The `range` in the response is what will actually be
+opened.
+
+A range also fixes the proportion of the two assets, so a deposit rarely
+uses all of both. What does not fit is reported as `leftover` and stays in
+your account rather than being quietly swept.
+
+Set `preview` to see the plan and its simulation without building anything.
+
+### Example Usage
+
+<!-- UsageSnippet language="typescript" operationID="v2_risk_yield_mint" method="post" path="/v2/risk_yield/mint" -->
+```typescript
+import { CompassApiSDK } from "@compass-labs/api-sdk";
+
+const compassApiSDK = new CompassApiSDK({
+  apiKeyAuth: "<YOUR_API_KEY_HERE>",
+});
+
+async function run() {
+  const result = await compassApiSDK.riskYield.riskYieldMint({
+    owner: "0x06A9aF046187895AcFc7258450B15397CAc67400",
+    chain: "robinhood",
+    pool: {
+      poolId: 1,
+    },
+    range: {
+      type: "symmetric_pct",
+      widthPct: "30",
+    },
+    deposit: {
+      type: "both",
+      amount0: "100",
+      amount1: "0.04",
+    },
+  });
+
+  console.log(result);
+}
+
+run();
+```
+
+### Standalone function
+
+The standalone function version of this method:
+
+```typescript
+import { CompassApiSDKCore } from "@compass-labs/api-sdk/core.js";
+import { riskYieldRiskYieldMint } from "@compass-labs/api-sdk/funcs/riskYieldRiskYieldMint.js";
+
+// Use `CompassApiSDKCore` for best tree-shaking performance.
+// You can create one instance of it to use across an application.
+const compassApiSDK = new CompassApiSDKCore({
+  apiKeyAuth: "<YOUR_API_KEY_HERE>",
+});
+
+async function run() {
+  const res = await riskYieldRiskYieldMint(compassApiSDK, {
+    owner: "0x06A9aF046187895AcFc7258450B15397CAc67400",
+    chain: "robinhood",
+    pool: {
+      poolId: 1,
+    },
+    range: {
+      type: "symmetric_pct",
+      widthPct: "30",
+    },
+    deposit: {
+      type: "both",
+      amount0: "100",
+      amount1: "0.04",
+    },
+  });
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("riskYieldRiskYieldMint failed:", res.error);
+  }
+}
+
+run();
+```
+
+### Parameters
+
+| Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `request`                                                                                                                                                                      | [components.RiskYieldMintRequest](../../models/components/riskyieldmintrequest.md)                                                                                             | :heavy_check_mark:                                                                                                                                                             | The request object to use for the request.                                                                                                                                     |
+| `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |
+| `options.fetchOptions`                                                                                                                                                         | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options)                                                                                        | :heavy_minus_sign:                                                                                                                                                             | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
+| `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |
+
+### Response
+
+**Promise\<[components.RiskYieldLiquidityResponse](../../models/components/riskyieldliquidityresponse.md)\>**
+
+### Errors
+
+| Error Type                 | Status Code                | Content Type               |
+| -------------------------- | -------------------------- | -------------------------- |
+| errors.HTTPValidationError | 422                        | application/json           |
+| errors.APIError            | 4XX, 5XX                   | \*/\*                      |
+
+## riskYieldIncrease
+
+Add liquidity to a position you already hold, over its existing range.
+
+### Example Usage
+
+<!-- UsageSnippet language="typescript" operationID="v2_risk_yield_increase" method="post" path="/v2/risk_yield/increase" -->
+```typescript
+import { CompassApiSDK } from "@compass-labs/api-sdk";
+
+const compassApiSDK = new CompassApiSDK({
+  apiKeyAuth: "<YOUR_API_KEY_HERE>",
+});
+
+async function run() {
+  const result = await compassApiSDK.riskYield.riskYieldIncrease({
+    owner: "0x06A9aF046187895AcFc7258450B15397CAc67400",
+    chain: "robinhood",
+    positionId: 1076416,
+    deposit: {
+      type: "both",
+      amount0: "50",
+      amount1: "0.02",
+    },
+  });
+
+  console.log(result);
+}
+
+run();
+```
+
+### Standalone function
+
+The standalone function version of this method:
+
+```typescript
+import { CompassApiSDKCore } from "@compass-labs/api-sdk/core.js";
+import { riskYieldRiskYieldIncrease } from "@compass-labs/api-sdk/funcs/riskYieldRiskYieldIncrease.js";
+
+// Use `CompassApiSDKCore` for best tree-shaking performance.
+// You can create one instance of it to use across an application.
+const compassApiSDK = new CompassApiSDKCore({
+  apiKeyAuth: "<YOUR_API_KEY_HERE>",
+});
+
+async function run() {
+  const res = await riskYieldRiskYieldIncrease(compassApiSDK, {
+    owner: "0x06A9aF046187895AcFc7258450B15397CAc67400",
+    chain: "robinhood",
+    positionId: 1076416,
+    deposit: {
+      type: "both",
+      amount0: "50",
+      amount1: "0.02",
+    },
+  });
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("riskYieldRiskYieldIncrease failed:", res.error);
+  }
+}
+
+run();
+```
+
+### Parameters
+
+| Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `request`                                                                                                                                                                      | [components.RiskYieldIncreaseRequest](../../models/components/riskyieldincreaserequest.md)                                                                                     | :heavy_check_mark:                                                                                                                                                             | The request object to use for the request.                                                                                                                                     |
+| `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |
+| `options.fetchOptions`                                                                                                                                                         | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options)                                                                                        | :heavy_minus_sign:                                                                                                                                                             | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
+| `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |
+
+### Response
+
+**Promise\<[components.RiskYieldLiquidityResponse](../../models/components/riskyieldliquidityresponse.md)\>**
+
+### Errors
+
+| Error Type                 | Status Code                | Content Type               |
+| -------------------------- | -------------------------- | -------------------------- |
+| errors.HTTPValidationError | 422                        | application/json           |
+| errors.APIError            | 4XX, 5XX                   | \*/\*                      |
+
+## riskYieldDecrease
+
+Take liquidity back out of a position.
+
+The collect is bundled in by default and should stay that way:
+`decreaseLiquidity` only *credits* the tokens to the position, it does not
+move them. Without the collect the position looks emptied while the funds
+sit in the position manager.
+
+### Example Usage
+
+<!-- UsageSnippet language="typescript" operationID="v2_risk_yield_decrease" method="post" path="/v2/risk_yield/decrease" -->
+```typescript
+import { CompassApiSDK } from "@compass-labs/api-sdk";
+
+const compassApiSDK = new CompassApiSDK({
+  apiKeyAuth: "<YOUR_API_KEY_HERE>",
+});
+
+async function run() {
+  const result = await compassApiSDK.riskYield.riskYieldDecrease({
+    owner: "0x06A9aF046187895AcFc7258450B15397CAc67400",
+    chain: "robinhood",
+    positionId: 1076416,
+    percent: "100",
+  });
+
+  console.log(result);
+}
+
+run();
+```
+
+### Standalone function
+
+The standalone function version of this method:
+
+```typescript
+import { CompassApiSDKCore } from "@compass-labs/api-sdk/core.js";
+import { riskYieldRiskYieldDecrease } from "@compass-labs/api-sdk/funcs/riskYieldRiskYieldDecrease.js";
+
+// Use `CompassApiSDKCore` for best tree-shaking performance.
+// You can create one instance of it to use across an application.
+const compassApiSDK = new CompassApiSDKCore({
+  apiKeyAuth: "<YOUR_API_KEY_HERE>",
+});
+
+async function run() {
+  const res = await riskYieldRiskYieldDecrease(compassApiSDK, {
+    owner: "0x06A9aF046187895AcFc7258450B15397CAc67400",
+    chain: "robinhood",
+    positionId: 1076416,
+    percent: "100",
+  });
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("riskYieldRiskYieldDecrease failed:", res.error);
+  }
+}
+
+run();
+```
+
+### Parameters
+
+| Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `request`                                                                                                                                                                      | [components.RiskYieldDecreaseRequest](../../models/components/riskyielddecreaserequest.md)                                                                                     | :heavy_check_mark:                                                                                                                                                             | The request object to use for the request.                                                                                                                                     |
+| `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |
+| `options.fetchOptions`                                                                                                                                                         | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options)                                                                                        | :heavy_minus_sign:                                                                                                                                                             | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
+| `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |
+
+### Response
+
+**Promise\<[components.RiskYieldLiquidityResponse](../../models/components/riskyieldliquidityresponse.md)\>**
+
+### Errors
+
+| Error Type                 | Status Code                | Content Type               |
+| -------------------------- | -------------------------- | -------------------------- |
+| errors.HTTPValidationError | 422                        | application/json           |
+| errors.APIError            | 4XX, 5XX                   | \*/\*                      |
+
+## riskYieldCollect
+
+Sweep the fees a position has earned into your account.
+
+### Example Usage
+
+<!-- UsageSnippet language="typescript" operationID="v2_risk_yield_collect" method="post" path="/v2/risk_yield/collect" -->
+```typescript
+import { CompassApiSDK } from "@compass-labs/api-sdk";
+
+const compassApiSDK = new CompassApiSDK({
+  apiKeyAuth: "<YOUR_API_KEY_HERE>",
+});
+
+async function run() {
+  const result = await compassApiSDK.riskYield.riskYieldCollect({
+    owner: "0x06A9aF046187895AcFc7258450B15397CAc67400",
+    chain: "robinhood",
+    positionId: 1076416,
+  });
+
+  console.log(result);
+}
+
+run();
+```
+
+### Standalone function
+
+The standalone function version of this method:
+
+```typescript
+import { CompassApiSDKCore } from "@compass-labs/api-sdk/core.js";
+import { riskYieldRiskYieldCollect } from "@compass-labs/api-sdk/funcs/riskYieldRiskYieldCollect.js";
+
+// Use `CompassApiSDKCore` for best tree-shaking performance.
+// You can create one instance of it to use across an application.
+const compassApiSDK = new CompassApiSDKCore({
+  apiKeyAuth: "<YOUR_API_KEY_HERE>",
+});
+
+async function run() {
+  const res = await riskYieldRiskYieldCollect(compassApiSDK, {
+    owner: "0x06A9aF046187895AcFc7258450B15397CAc67400",
+    chain: "robinhood",
+    positionId: 1076416,
+  });
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("riskYieldRiskYieldCollect failed:", res.error);
+  }
+}
+
+run();
+```
+
+### Parameters
+
+| Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `request`                                                                                                                                                                      | [components.RiskYieldCollectRequest](../../models/components/riskyieldcollectrequest.md)                                                                                       | :heavy_check_mark:                                                                                                                                                             | The request object to use for the request.                                                                                                                                     |
+| `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |
+| `options.fetchOptions`                                                                                                                                                         | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options)                                                                                        | :heavy_minus_sign:                                                                                                                                                             | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
+| `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |
+
+### Response
+
+**Promise\<[components.RiskYieldLiquidityResponse](../../models/components/riskyieldliquidityresponse.md)\>**
+
+### Errors
+
+| Error Type                 | Status Code                | Content Type               |
+| -------------------------- | -------------------------- | -------------------------- |
+| errors.HTTPValidationError | 422                        | application/json           |
+| errors.APIError            | 4XX, 5XX                   | \*/\*                      |
+
+## riskYieldRebalance
+
+Move a position to a new range, in one transaction.
+
+**`NOOP` is a real answer and often the right one.** Rebalancing realizes
+the impermanent loss the position has taken so far, pays gas twice and a
+swap, and puts the position back at risk from a new price. If the position
+is already centred at the requested width, that is what you will get.
+
+When there is something to do, the transaction unwinds the old position,
+sweeps it together with the fees, opens the new range and burns the empty
+NFT. Every leg is sized from the **floor** the previous one guarantees
+rather than from its quote — they execute in the same transaction, and a
+mint sized from a quote reverts when the decrease comes back a wei short,
+leaving the owner having paid gas to dismantle a position. `estimated_dust`
+is what that safety costs.
+
+The default `vol_scaled` strategy sizes the new range from the pair's own
+measured volatility: two standard deviations over the horizon. A range
+narrower than the asset's ordinary movement spends most of its life out of
+range earning nothing, which is the most common way to lose money doing
+this on purpose.
+
+### Example Usage
+
+<!-- UsageSnippet language="typescript" operationID="v2_risk_yield_rebalance" method="post" path="/v2/risk_yield/rebalance" -->
+```typescript
+import { CompassApiSDK } from "@compass-labs/api-sdk";
+
+const compassApiSDK = new CompassApiSDK({
+  apiKeyAuth: "<YOUR_API_KEY_HERE>",
+});
+
+async function run() {
+  const result = await compassApiSDK.riskYield.riskYieldRebalance({
+    owner: "0x06A9aF046187895AcFc7258450B15397CAc67400",
+    chain: "robinhood",
+    positionId: 1076416,
+    strategy: "vol_scaled",
+    horizonDays: 7,
+  });
+
+  console.log(result);
+}
+
+run();
+```
+
+### Standalone function
+
+The standalone function version of this method:
+
+```typescript
+import { CompassApiSDKCore } from "@compass-labs/api-sdk/core.js";
+import { riskYieldRiskYieldRebalance } from "@compass-labs/api-sdk/funcs/riskYieldRiskYieldRebalance.js";
+
+// Use `CompassApiSDKCore` for best tree-shaking performance.
+// You can create one instance of it to use across an application.
+const compassApiSDK = new CompassApiSDKCore({
+  apiKeyAuth: "<YOUR_API_KEY_HERE>",
+});
+
+async function run() {
+  const res = await riskYieldRiskYieldRebalance(compassApiSDK, {
+    owner: "0x06A9aF046187895AcFc7258450B15397CAc67400",
+    chain: "robinhood",
+    positionId: 1076416,
+    strategy: "vol_scaled",
+    horizonDays: 7,
+  });
+  if (res.ok) {
+    const { value: result } = res;
+    console.log(result);
+  } else {
+    console.log("riskYieldRiskYieldRebalance failed:", res.error);
+  }
+}
+
+run();
+```
+
+### Parameters
+
+| Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `request`                                                                                                                                                                      | [components.RiskYieldRebalanceRequest](../../models/components/riskyieldrebalancerequest.md)                                                                                   | :heavy_check_mark:                                                                                                                                                             | The request object to use for the request.                                                                                                                                     |
+| `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |
+| `options.fetchOptions`                                                                                                                                                         | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options)                                                                                        | :heavy_minus_sign:                                                                                                                                                             | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
+| `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |
+
+### Response
+
+**Promise\<[components.RiskYieldRebalanceResponse](../../models/components/riskyieldrebalanceresponse.md)\>**
+
+### Errors
+
+| Error Type                 | Status Code                | Content Type               |
+| -------------------------- | -------------------------- | -------------------------- |
+| errors.HTTPValidationError | 422                        | application/json           |
+| errors.APIError            | 4XX, 5XX                   | \*/\*                      |