Switch mode

GET /v1/actions/lending/mode

Build calldata for switching the active risk-category ("mode") on a lender that supports it (e.g. Aave V3 e-mode).

The "mode" terminology is the protocol-agnostic generalization of Aave V3's "e-mode" (efficiency mode); other lenders expose analogous category mechanisms.

Plain-text reference — GET /v1/actions/lending/mode

Parameters

Parameter	In	Type	Required	Description
`chainId`	query	string	yes	Chain ID See the `ChainId` schema for the full set of supported chains.
`lender`	query	string	yes	Protocol identifier See the `LenderId` schema for the full set of accepted values.
`mode`	query	integer	yes	Target mode category ID

Response 200

Field	Type	Description
`success`	`True`
`data`	object	Response from direct-mode lending operations (deposit, withdraw, borrow, repay). The calldata is NOT in `data`: send `actions.transactions` (in order) after mining `actions.permissions`. `data` carries only informational fields.
`data.rateImpact`	object[]	Projected interest-rate impact per market. Single-market actions produce 1 entry; loop actions produce 2. Null if IRM data is unavailable.
`data.rateImpact[].marketUid`	string	Market identifier (format: `lender:chainId:address`)
`data.rateImpact[].utilization`	object	A current/projected pair for a single rate metric.
`data.rateImpact[].utilization.current`	number	Current value
`data.rateImpact[].utilization.projected`	number	Projected value after the action
`data.rateImpact[].borrowRate`	object	A current/projected pair for a single rate metric.
`data.rateImpact[].borrowRate.current`	number	Current value
`data.rateImpact[].borrowRate.projected`	number	Projected value after the action
`data.rateImpact[].depositRate`	object	A current/projected pair for a single rate metric.
`data.rateImpact[].depositRate.current`	number	Current value
`data.rateImpact[].depositRate.projected`	number	Projected value after the action
`data.rateImpact[].intrinsicYield`	number	The asset's own yield in percent (LST staking yield, RWA NAV growth, a Gearbox quota rate as a negative), size-invariant, ADDED to both sides: earned on a deposit, forgone on a borrow. Absent when the lender meta was not readable when the response was built — never defaulted to 0 in that case.
`data.rateImpact[].depositRewardApr`	number	Sum of reward-stream APRs (%) on the deposit side. Absent with `intrinsicYield`.
`data.rateImpact[].borrowRewardApr`	number	Sum of reward-stream APRs (%) rebated on the borrow side. Absent with `intrinsicYield`.
`data.rateImpact[].effectiveDepositRate`	object	A current/projected pair for a single rate metric.
`data.rateImpact[].effectiveDepositRate.current`	number	Current value
`data.rateImpact[].effectiveDepositRate.projected`	number	Projected value after the action
`data.rateImpact[].effectiveBorrowRate`	object	A current/projected pair for a single rate metric.
`data.rateImpact[].effectiveBorrowRate.current`	number	Current value
`data.rateImpact[].effectiveBorrowRate.projected`	number	Projected value after the action
`data.rateImpact[].flat`	boolean	True when the market has no utilization curve to shift (Morpho Blue collateral, a fixed-rate broker): current === projected, taken from the published rates, and `utilization` is NaN. Present so the leg is not silently missing from a position preview.
`actions`	object	Transaction calldata and approvals. Null for quote-only responses (no account provided).
`actions.transactions`	object[]	Pre-trade setup transactions (e.g. e-mode switch, collateral enable). Execute these before the main swap. Empty when no setup is needed.
`actions.transactions[].chainType`	`evm`	Which VM executes this step. ABSENT means `evm`, which is the only value any endpoint returns today — every EVM response is unchanged. A non-EVM chain would return a different shape (a serialized, PERISHABLE transaction rather than `to`/`data`/`value`) carrying its own `chainType`, so a client that wants to stay forward-compatible should branch on this field rather than assume `to` is present.
`actions.transactions[].to`	string	Target contract address
`actions.transactions[].data`	string	Encoded calldata
`actions.transactions[].value`	string	ETH value to send with the transaction
`actions.transactions[].description`	string	Human-readable label. For `alternatives`, this is the aggregator name (e.g. "Paraswap"). For `transactions`, describes the setup action (e.g. "Switch e-mode to 1").
`actions.alternatives`	object[]	DEX aggregator swap transactions sorted by best output (descending). Each entry's `description` is the aggregator name. The client should pick one to execute. Present on loop action endpoints.
`actions.alternatives[].chainType`	`evm`	Which VM executes this step. ABSENT means `evm`, which is the only value any endpoint returns today — every EVM response is unchanged. A non-EVM chain would return a different shape (a serialized, PERISHABLE transaction rather than `to`/`data`/`value`) carrying its own `chainType`, so a client that wants to stay forward-compatible should branch on this field rather than assume `to` is present.
`actions.alternatives[].to`	string	Target contract address
`actions.alternatives[].data`	string	Encoded calldata
`actions.alternatives[].value`	string	ETH value to send with the transaction
`actions.alternatives[].description`	string	Human-readable label. For `alternatives`, this is the aggregator name (e.g. "Paraswap"). For `transactions`, describes the setup action (e.g. "Switch e-mode to 1").
`actions.permissions`	object[]	Approval/delegation transactions that must execute before both `transactions` and `alternatives`. Includes ERC20 allowances (targeting the composer contract) and lender borrow/withdrawal delegations (targeting the lending protocol contract directly). Filtered against on-chain state so only missing approvals are returned. Null when no approvals are needed.
`actions.permissions[].to`	string	Target contract address
`actions.permissions[].data`	string	Encoded calldata
`actions.permissions[].value`	string	ETH value

Example response

{
  "success": true,
  "data": {
    "rateImpact": [
      {
        "marketUid": "AAVE_V3:8453:0x4200000000000000000000000000000000000006",
        "utilization": {
          "current": 1.0,
          "projected": 1.0
        },
        "borrowRate": {
          "current": 1.0,
          "projected": 1.0
        },
        "depositRate": {
          "current": 1.0,
          "projected": 1.0
        },
        "intrinsicYield": 10.37,
        "depositRewardApr": 1.0,
        "borrowRewardApr": 1.0,
        "effectiveDepositRate": {
          "current": 1.0,
          "projected": 1.0
        },
        "effectiveBorrowRate": {
          "current": 1.0,
          "projected": 1.0
        },
        "flat": true
      }
    ]
  },
  "actions": {
    "transactions": [
      {
        "chainType": "evm",
        "to": "0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2",
        "data": "0x617ba037000000000000000000000000c02aaa39b2",
        "value": "0",
        "description": "string"
      }
    ],
    "alternatives": [
      {
        "chainType": "evm",
        "to": "0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2",
        "data": "0x617ba037000000000000000000000000c02aaa39b2",
        "value": "0",
        "description": "string"
      }
    ],
    "permissions": [
      {
        "to": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
        "data": "0x617ba037000000000000000000000000c02aaa39b2",
        "value": "0",
        "description": "string",
        "spender": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
        "type": "ERC20"
      }
    ],
    "signatures": [
      {
        "permitId": "string",
        "kind": "erc2612",
        "typedData": {},
        "replaces": "string",
        "spender": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
        "description": "string",
        "unscoped": true,
        "deadline": "string"
      }
    ],
    "signs": [
      {
        "purpose": "authorize-action",
        "format": "eip712",
        "typedData": {},
        "message": "string",
        "signer": "string",
        "deadline": "string",
        "spender": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
        "description": "string",
        "submit": {
          "method": "GET",
          "endpoint": "string",
          "params": {},
          "body": {},
          "signatureField": "string"
        }
      }
    ],
    "permitSkipped": [
      {
        "replaces": "string",
        "reason": "string"
      }
    ]
  }
}

Request

Responses

Transaction calldata

Rate limited. Unauthenticated callers share a per-IP budget; send an x-api-key header to lift it. Retry with exponential backoff.

An upstream data source or protocol origin failed (error.code is ORIGIN_FAILED). error.details carries the per-origin status. This is also what a missing or malformed required parameter currently returns, rather than a 400.

Switch mode

/v1/actions/lending/mode

Request​

Responses​

Request

Responses