Enzyme

Load current allocation of an Enzyme vault:

GET/0.1/rebalancing/enzyme-vault/assets

Query parameters

Header parameters

Response

200

Body

application/json

AssetResponseDto (object)

Request

JavaScriptCurl

const response = await fetch('/0.1/rebalancing/enzyme-vault/assets', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{}

Calculate a rebalancing by passing an Enzyme vault address and a target allocation (tokens + percentages). Additional options are shown in the following request documentation:

Request a rebalancing for an enzyme vault with a target allocation.

POST/0.1/rebalancing/enzyme-vault

Header parameters

Body

application/json

walletAddress*string

The wallet that is used to execute the rebalancing.

maxDeviationFromTargetnumber

Maximum deviation from the target allocation. (0.01 = 1%)

maxSlippagenumber

Maximum allowed slippage for the calculated trades. (0.01 = 1%)

excludedSourcesarray of string

List of DEXs that should not be used. (Supported DEXs can be queried from the /settings/exchanges endpoint).

automatedMarketMakerEnabled*boolean

Enables AMM trades

rfqtEnabled*boolean

Enables RFQT trades

batchTrade*boolean

Enables batch trading

revertOnError*boolean

Enables reverting the whole batch transaction if one single trade fails. Otherwise the already positive executed trades are settled.

failOnMissingPricePairboolean

If true, an exception is thrown, indicating that no price pair can be found for at least one of the vault tokens. (Only assets with a balance greater than 0 are considered.) If false, the rebalancing is still calculated without considering the tokens with no pairs.

vaultAddress*string

Vault for which the rebalancing is calculated.

includeVaultTokensarray of string

Optional. If provided, only the selected tokens are considered for the base allocation. (Cannot be combined with excludeVaultTokens.)

excludeVaultTokensarray of string

Optional. If provided, the selected tokens are not considered for rebalancing. (Cannot be combined with includeVaultTokens.)

targetEntries*array of RebalancingAllocationEntryDto (object)

List of target tokens with allocation.

Response

200

Body

application/json

id*string

Unique ID of the calculated rebalancing.

estimatedResultTvlInUsd*number

Estimated total portfolio value after the rebalancing. (in USD)

minResultTvlInUsd*number

Minimal total portfolio value after the rebalancing. (in USD)

estimatedTvlLossInUsd*number

Estimated loss of total portfolio value. (in USD)

estimatedFees*all of

Estimated network fees for the rebalancing. (in WEI)

estimatedFeesInUsd*number

Estimated network fees for the rebalancing. (in USD)

allowanceNeededAddresses*array of string

List of tokens for which the allowance has to be increased before executing the rebalancing. (List based on the wallet passed in the rebalancing request.)

trades*array of TradeDto (object)

List of trades which will be executed to fulfill the rebalancing.

txHandler*string

[Just if a batch trade is requested, otherwise use txHandler per trade] Address of the contract to send the txData to. It will be our batch trade contract if it is a rebalancing transaction. However, in some special cases, it may also be a different contract, for example, in the case of wrapping ETH into WETH.

txData*object

[Just if a batch trade is requested, otherwise use txData per trade] Call data to execute the rebalancing. (Must be sent to the txHandler contract address.)

txValue*all of

Call value to execute the rebalancing. (Must be sent to the txHandler contract address.)

tokensWithoutPricePair*string

List of tokens for which no price pair could be found.

expirationTimestamp*string (date-time)

Currently, this is not a hard expiration timestamp. The rebalancing transaction can still be executed if the timestamp has expired, but there may already be substantial price changes on the market. (With the introduction of RFQ, the timestamp will be a hard deadline for executing the rebalancing transaction at a given quote. If the timestamp expires, a new quote will be issued with a new timestamp.)

Request

JavaScriptCurl

const response = await fetch('/0.1/rebalancing/enzyme-vault', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "walletAddress": "0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B",
      "automatedMarketMakerEnabled": true,
      "rfqtEnabled": true,
      "batchTrade": false,
      "revertOnError": true,
      "vaultAddress": "0x1b83ba4527C837d462D5b78d65A097dABae5ea89",
      "targetEntries": [
        {
          "tokenAddress": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
          "allocation": 0.2
        }
      ]
    }),
});
const data = await response.json();

Response

{
  "id": "0096124c-19df-4459-8cbb-7615fdc7c157",
  "estimatedResultTvlInUsd": 12345.67,
  "minResultTvlInUsd": 12325.67,
  "estimatedTvlLossInUsd": 12.34,
  "estimatedFees": {
    "_hex": "0x470de4df820000"
  },
  "estimatedFeesInUsd": 23.45,
  "allowanceNeededAddresses": [
    "0xdac17f958d2ee523a2206206994597c13d831ec7",
    "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
  ],
  "trades": [
    {
      "id": "0096124c-19df-4459-8cbb-7615fdc7c157",
      "from": "0xdac17f958d2ee523a2206206994597c13d831ec7",
      "to": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "fromAmount": {
        "_hex": "0x05f5e100"
      },
      "toAmount": {
        "_hex": "0x05ee3fe0"
      },
      "minToReceive": {
        "_hex": "0x05e69ec0"
      },
      "fromValueInEth": {
        "type": "BigNumber",
        "hex": "0xf8b0a10e470000"
      },
      "toValueInEth": {
        "type": "BigNumber",
        "hex": "0xf6e9e1bbe3c000"
      },
      "minToReceiveInEth": {
        "type": "BigNumber",
        "hex": "0xf5232269808000"
      },
      "fromValueInUsd": 100,
      "toValueInUsd": 99.5,
      "minToReceiveInUsd": 99,
      "calculatedLossPercentage": 0.005,
      "maxSlippage": 0.01,
      "price": 0.999955,
      "guaranteedPrice": 0.99,
      "previouslyRequiredTrades": [],
      "allowanceNeeded": true,
      "allowanceTarget": "0xdef1c0ded9bec7f1a1670819833240f027b25eff",
      "estimatedFees": {
        "type": "BigNumber",
        "hex": "0x11c37937e08000"
      },
      "txData": "0x6af479b200000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000005f5e1000000000000000000000000000000000000000000000000000000000005e68d620000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002bdac17f958d2ee523a2206206994597c13d831ec70001f4a0b86991c6218b36c1d19d4a2e9eb0ce3606eb48000000000000000000000000000000000000000000869584cd00000000000000000000000058ee0e1efcb86ad60d4df3c8a32b398887bb148b0000000000000000000000000000000000000000000000de6f27846963566719",
      "txHandler": "0xdef1c0ded9bec7f1a1670819833240f027b25eff",
      "expirationTimestamp": "2024-04-26T20:00:13.251Z",
      "transactions": [
        "text"
      ]
    }
  ],
  "txHandler": "text",
  "txValue": {
    "_hex": "text"
  },
  "tokensWithoutPricePair": [
    "0x3ed3b47dd13ec9a98b44e6204a523e766b225811"
  ],
  "expirationTimestamp": "2023-03-07T07:10:55.641Z"
}