MarginBuildResponse

Full build response (account provided). Includes transaction calldata.

lenderstringrequired

Protocol identifier

quotes object[]required

Candidate routes, best output first. Execute exactly one.

Array [

deltas object

aggregatorstring

Aggregator source

tradeInputnumber

Trade input amount

tradeOutputnumber

Trade output amount

deltas object

Balance deltas

property name*any

Balance deltas

tx object

An EVM transaction ready to sign and broadcast. Send to, data and value as-is; do not re-encode them.

tostringrequired

Target contract address

Example: 0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2

datastringrequired

Encoded calldata

Example: 0x617ba037000000000000000000000000c02aaa39b2

valuestringrequired

ETH value to send with the transaction

Example: 0

descriptionstring

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").

rateImpact object[]

Projected interest-rate impact per market for THIS quote (its own trade amounts). Omitted if IRM data is unavailable.

Array [

marketUidstringrequired

Market identifier (format: lender:chainId:address)

Example: AAVE_V3:8453:0x4200000000000000000000000000000000000006

utilization objectrequired

Utilization ratio (0–1)

currentnumberrequired

Current value

projectednumberrequired

Projected value after the action

borrowRate objectrequired

Borrow APR (%)

currentnumberrequired

Current value

projectednumberrequired

Projected value after the action

depositRate objectrequired

Deposit/supply APR (%)

currentnumberrequired

Current value

projectednumberrequired

Projected value after the action

]

]

permissionTxns object[]required

Approvals needed for this specific quote. Most integrators should use the deduplicated envelope-level actions.permissions instead.

Array [

tostringrequired

Target contract address

datastringrequired

Encoded calldata

valuestringrequired

ETH value

Example: 0

descriptionstring

Human-readable description of the approval (e.g. "Approve borrow for AAVE_V3", "Approve ERC20")

spenderstring

ERC-20 approve spender (x-chain permissions). Match it against the selected quote's approvalTarget — several bridges can share one spender, so do not match by description.

]

rateImpact object[]nullable

Projected interest-rate impact per market. Single-market actions produce 1 entry; loop actions produce 2. Null if IRM data is unavailable.

Array [

marketUidstringrequired

Market identifier (format: lender:chainId:address)

Example: AAVE_V3:8453:0x4200000000000000000000000000000000000006

utilization objectrequired

Utilization ratio (0–1)

currentnumberrequired

Current value

projectednumberrequired

Projected value after the action

borrowRate objectrequired

Borrow APR (%)

currentnumberrequired

Current value

projectednumberrequired

Projected value after the action

depositRate objectrequired

Deposit/supply APR (%)

currentnumberrequired

Current value

projectednumberrequired

Projected value after the action

]

MarginBuildResponse

{
  "lender": "string",
  "quotes": [
    {
      "deltas": {
        "aggregator": "string",
        "tradeInput": 0,
        "tradeOutput": 0,
        "deltas": {}
      },
      "tx": {
        "to": "0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2",
        "data": "0x617ba037000000000000000000000000c02aaa39b2",
        "value": "0",
        "description": "string"
      },
      "rateImpact": [
        {
          "marketUid": "AAVE_V3:8453:0x4200000000000000000000000000000000000006",
          "utilization": {
            "current": 0.85,
            "projected": 0.83
          },
          "borrowRate": {
            "current": 3.2,
            "projected": 3
          },
          "depositRate": {
            "current": 2.1,
            "projected": 1.9
          }
        }
      ]
    }
  ],
  "permissionTxns": [
    {
      "to": "string",
      "data": "string",
      "value": "0",
      "description": "string",
      "spender": "string"
    }
  ],
  "rateImpact": [
    {
      "marketUid": "AAVE_V3:8453:0x4200000000000000000000000000000000000006",
      "utilization": {
        "current": 0.85,
        "projected": 0.83
      },
      "borrowRate": {
        "current": 3.2,
        "projected": 3
      },
      "depositRate": {
        "current": 2.1,
        "projected": 1.9
      }
    }
  ]
}