Python (SDK)

from compass_api_sdk import CompassAPI, models


with CompassAPI(
    api_key_auth="<YOUR_API_KEY_HERE>",
) as compass_api:

    res = compass_api.credit.credit_unloop(owner="0x0E407CdeBD8e078E6966ef6740540d25F5897082", chain=models.CreditUnloopRequestChain.ETHEREUM, collateral_token="WETH", borrow_token="USDC", protocol=models.CreditProtocol.AAVE, sub_account_id=0, max_slippage_percent=0.5, allow_partial=False, gas_sponsorship=False, preview=False)

    # Handle response
    print(res)

import { CompassApiSDK } from "@compass-labs/api-sdk";

const compassApiSDK = new CompassApiSDK({
  apiKeyAuth: "<YOUR_API_KEY_HERE>",
});

async function run() {
  const result = await compassApiSDK.credit.creditUnloop({
    owner: "0x0E407CdeBD8e078E6966ef6740540d25F5897082",
    chain: "ethereum",
    protocol: "AAVE",
    collateralToken: "WETH",
    borrowToken: "USDC",
    maxSlippagePercent: 0.5,
    allowPartial: false,
    gasSponsorship: false,
  });

  console.log(result);
}

run();

curl --request POST \
  --url https://api.compasslabs.ai/v2/credit/unloop \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "owner": "0x0E407CdeBD8e078E6966ef6740540d25F5897082",
  "chain": "ethereum",
  "protocol": "AAVE",
  "collateral_token": "WETH",
  "borrow_token": "USDC",
  "max_slippage_percent": 0.5,
  "allow_partial": false,
  "gas_sponsorship": false
}
'

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    owner: '0x0E407CdeBD8e078E6966ef6740540d25F5897082',
    chain: 'ethereum',
    protocol: 'AAVE',
    collateral_token: 'WETH',
    borrow_token: 'USDC',
    max_slippage_percent: 0.5,
    allow_partial: false,
    gas_sponsorship: false
  })
};

fetch('https://api.compasslabs.ai/v2/credit/unloop', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.compasslabs.ai/v2/credit/unloop",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'owner' => '0x0E407CdeBD8e078E6966ef6740540d25F5897082',
    'chain' => 'ethereum',
    'protocol' => 'AAVE',
    'collateral_token' => 'WETH',
    'borrow_token' => 'USDC',
    'max_slippage_percent' => 0.5,
    'allow_partial' => false,
    'gas_sponsorship' => false
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.compasslabs.ai/v2/credit/unloop"

	payload := strings.NewReader("{\n  \"owner\": \"0x0E407CdeBD8e078E6966ef6740540d25F5897082\",\n  \"chain\": \"ethereum\",\n  \"protocol\": \"AAVE\",\n  \"collateral_token\": \"WETH\",\n  \"borrow_token\": \"USDC\",\n  \"max_slippage_percent\": 0.5,\n  \"allow_partial\": false,\n  \"gas_sponsorship\": false\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.compasslabs.ai/v2/credit/unloop")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"owner\": \"0x0E407CdeBD8e078E6966ef6740540d25F5897082\",\n  \"chain\": \"ethereum\",\n  \"protocol\": \"AAVE\",\n  \"collateral_token\": \"WETH\",\n  \"borrow_token\": \"USDC\",\n  \"max_slippage_percent\": 0.5,\n  \"allow_partial\": false,\n  \"gas_sponsorship\": false\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.compasslabs.ai/v2/credit/unloop")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"owner\": \"0x0E407CdeBD8e078E6966ef6740540d25F5897082\",\n  \"chain\": \"ethereum\",\n  \"protocol\": \"AAVE\",\n  \"collateral_token\": \"WETH\",\n  \"borrow_token\": \"USDC\",\n  \"max_slippage_percent\": 0.5,\n  \"allow_partial\": false,\n  \"gas_sponsorship\": false\n}"

response = http.request(request)
puts response.read_body

{
  "preview": {
    "iterations": 123,
    "total_collateral_withdrawn": "<string>",
    "total_debt_repaid": "<string>",
    "ending_collateral": "<string>",
    "ending_debt": "<string>",
    "ending_multiplier": "<string>",
    "projected_ltv": "<string>",
    "projected_health_factor": "<string>",
    "estimated_max_dust": "<string>",
    "fully_unwound": true,
    "legs": []
  },
  "transaction": {
    "chainId": "0x2105",
    "data": "0x1688f0b900000000000000000000000029fcb43b46531bca003ddc8fcb67ffe91900c762000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000675f4a3d",
    "from": "0x4A83b4413CF41C3244027e1590E35a0F48403F0c",
    "gas": "0x7a120",
    "maxFeePerGas": "0x59682f00",
    "maxPriorityFeePerGas": "0x3b9aca00",
    "nonce": "0x5",
    "to": "0x4e1DCf7AD4e460CfD30791CCC4F9c8a4f820ec67",
    "value": "0x0"
  },
  "eip_712": {
    "domain": {
      "chainId": 8453,
      "verifyingContract": "0x6B90E8B4E3E971E74C1A47a3a20976377E2dB4b1"
    },
    "message": {
      "baseGas": "0",
      "data": "0x8d80ff0a0000000000000000000000000000000000000000000000000000000000000020",
      "gasPrice": "0",
      "gasToken": "0x0000000000000000000000000000000000000000",
      "nonce": "7",
      "operation": 1,
      "refundReceiver": "0x0000000000000000000000000000000000000000",
      "safeTxGas": "0",
      "to": "0x93C23AAE4793C14D6DF35D2A2A2234204e1559dA",
      "value": "0"
    },
    "primaryType": "SafeTx",
    "types": {
      "EIP712Domain": [
        {
          "name": "chainId",
          "type": "uint256"
        },
        {
          "name": "verifyingContract",
          "type": "address"
        }
      ],
      "SafeTx": [
        {
          "name": "to",
          "type": "address"
        },
        {
          "name": "value",
          "type": "uint256"
        },
        {
          "name": "data",
          "type": "bytes"
        },
        {
          "name": "operation",
          "type": "uint8"
        },
        {
          "name": "safeTxGas",
          "type": "uint256"
        },
        {
          "name": "baseGas",
          "type": "uint256"
        },
        {
          "name": "gasPrice",
          "type": "uint256"
        },
        {
          "name": "gasToken",
          "type": "address"
        },
        {
          "name": "refundReceiver",
          "type": "address"
        },
        {
          "name": "nonce",
          "type": "uint256"
        }
      ]
    }
  },
  "swap_provider": "one_inch",
  "quote_expires_at": "2023-11-07T05:31:56Z",
  "firm_available": true
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Credit

Unwind a leveraged loop

Unwind an Aave or Morpho loop in ONE atomic transaction.

Repeatedly withdraws collateral, swaps it to the borrow token at a GUARANTEED minimum output (enforced on-chain), and repays. The floor discipline means a swap filling anywhere within the slippage tolerance can never break a later step; any positive surplus stays in the Credit Account as borrow-token dust (the preview reports the bound as estimated_max_dust).

When the collateral token is itself an ERC-4626 vault share (e.g. a Morpho vault token like steakUSDC), each conversion redeems the shares through the vault at net asset value and swaps the underlying asset to the borrow token instead of swapping the share token on a DEX; a direct share-token route is only ever used when it prices within 1% of net asset value.

Omit target_multiplier for a full close: the debt is cleared exactly — accrued interest included — and the pair collateral is returned to the Credit Account. Pass 1 to clear the debt but keep the collateral supplied, or a value above 1 to delever to that multiplier (it must be below the position’s current multiplier).

Each withdrawal is sized to keep the position’s health factor ≥ 1.02 at that step, so a position opened very close to the liquidation threshold may need more than one transaction to fully close — set allow_partial=true to return the maximum single-transaction progress (preview.fully_unwound=false), then call unloop again to finish. Very large unwinds relative to pool depth can still exceed the slippage tolerance through their own cumulative price impact.

Positions are unwound as far as the swap router can route; on a router-minimum stop the engine still withdraws all collateral not needed to back the residual, and completes a true full close whenever the unwind’s own guaranteed swap surpluses (or the Credit Account’s idle balance) cover the remainder — a residual below the router’s minimum routable size never fails the call, it is reported honestly in the preview (fully_unwound=false).

When other open Aave loops share this position’s collateral reserve, a full close withdraws only this position’s attributed share of the pooled collateral (event-ledger bookkeeping), leaving the rest supplied for the other positions.

For protocol=MORPHO pass a market_id from /v2/credit/morpho_markets; inspect open loops via /v2/credit/looped_positions.

POST

credit

unloop

Python (SDK)

from compass_api_sdk import CompassAPI, models


with CompassAPI(
    api_key_auth="<YOUR_API_KEY_HERE>",
) as compass_api:

    res = compass_api.credit.credit_unloop(owner="0x0E407CdeBD8e078E6966ef6740540d25F5897082", chain=models.CreditUnloopRequestChain.ETHEREUM, collateral_token="WETH", borrow_token="USDC", protocol=models.CreditProtocol.AAVE, sub_account_id=0, max_slippage_percent=0.5, allow_partial=False, gas_sponsorship=False, preview=False)

    # Handle response
    print(res)

import { CompassApiSDK } from "@compass-labs/api-sdk";

const compassApiSDK = new CompassApiSDK({
  apiKeyAuth: "<YOUR_API_KEY_HERE>",
});

async function run() {
  const result = await compassApiSDK.credit.creditUnloop({
    owner: "0x0E407CdeBD8e078E6966ef6740540d25F5897082",
    chain: "ethereum",
    protocol: "AAVE",
    collateralToken: "WETH",
    borrowToken: "USDC",
    maxSlippagePercent: 0.5,
    allowPartial: false,
    gasSponsorship: false,
  });

  console.log(result);
}

run();

curl --request POST \
  --url https://api.compasslabs.ai/v2/credit/unloop \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "owner": "0x0E407CdeBD8e078E6966ef6740540d25F5897082",
  "chain": "ethereum",
  "protocol": "AAVE",
  "collateral_token": "WETH",
  "borrow_token": "USDC",
  "max_slippage_percent": 0.5,
  "allow_partial": false,
  "gas_sponsorship": false
}
'

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    owner: '0x0E407CdeBD8e078E6966ef6740540d25F5897082',
    chain: 'ethereum',
    protocol: 'AAVE',
    collateral_token: 'WETH',
    borrow_token: 'USDC',
    max_slippage_percent: 0.5,
    allow_partial: false,
    gas_sponsorship: false
  })
};

fetch('https://api.compasslabs.ai/v2/credit/unloop', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.compasslabs.ai/v2/credit/unloop",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'owner' => '0x0E407CdeBD8e078E6966ef6740540d25F5897082',
    'chain' => 'ethereum',
    'protocol' => 'AAVE',
    'collateral_token' => 'WETH',
    'borrow_token' => 'USDC',
    'max_slippage_percent' => 0.5,
    'allow_partial' => false,
    'gas_sponsorship' => false
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.compasslabs.ai/v2/credit/unloop"

	payload := strings.NewReader("{\n  \"owner\": \"0x0E407CdeBD8e078E6966ef6740540d25F5897082\",\n  \"chain\": \"ethereum\",\n  \"protocol\": \"AAVE\",\n  \"collateral_token\": \"WETH\",\n  \"borrow_token\": \"USDC\",\n  \"max_slippage_percent\": 0.5,\n  \"allow_partial\": false,\n  \"gas_sponsorship\": false\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.compasslabs.ai/v2/credit/unloop")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"owner\": \"0x0E407CdeBD8e078E6966ef6740540d25F5897082\",\n  \"chain\": \"ethereum\",\n  \"protocol\": \"AAVE\",\n  \"collateral_token\": \"WETH\",\n  \"borrow_token\": \"USDC\",\n  \"max_slippage_percent\": 0.5,\n  \"allow_partial\": false,\n  \"gas_sponsorship\": false\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.compasslabs.ai/v2/credit/unloop")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"owner\": \"0x0E407CdeBD8e078E6966ef6740540d25F5897082\",\n  \"chain\": \"ethereum\",\n  \"protocol\": \"AAVE\",\n  \"collateral_token\": \"WETH\",\n  \"borrow_token\": \"USDC\",\n  \"max_slippage_percent\": 0.5,\n  \"allow_partial\": false,\n  \"gas_sponsorship\": false\n}"

response = http.request(request)
puts response.read_body

{
  "preview": {
    "iterations": 123,
    "total_collateral_withdrawn": "<string>",
    "total_debt_repaid": "<string>",
    "ending_collateral": "<string>",
    "ending_debt": "<string>",
    "ending_multiplier": "<string>",
    "projected_ltv": "<string>",
    "projected_health_factor": "<string>",
    "estimated_max_dust": "<string>",
    "fully_unwound": true,
    "legs": []
  },
  "transaction": {
    "chainId": "0x2105",
    "data": "0x1688f0b900000000000000000000000029fcb43b46531bca003ddc8fcb67ffe91900c762000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000675f4a3d",
    "from": "0x4A83b4413CF41C3244027e1590E35a0F48403F0c",
    "gas": "0x7a120",
    "maxFeePerGas": "0x59682f00",
    "maxPriorityFeePerGas": "0x3b9aca00",
    "nonce": "0x5",
    "to": "0x4e1DCf7AD4e460CfD30791CCC4F9c8a4f820ec67",
    "value": "0x0"
  },
  "eip_712": {
    "domain": {
      "chainId": 8453,
      "verifyingContract": "0x6B90E8B4E3E971E74C1A47a3a20976377E2dB4b1"
    },
    "message": {
      "baseGas": "0",
      "data": "0x8d80ff0a0000000000000000000000000000000000000000000000000000000000000020",
      "gasPrice": "0",
      "gasToken": "0x0000000000000000000000000000000000000000",
      "nonce": "7",
      "operation": 1,
      "refundReceiver": "0x0000000000000000000000000000000000000000",
      "safeTxGas": "0",
      "to": "0x93C23AAE4793C14D6DF35D2A2A2234204e1559dA",
      "value": "0"
    },
    "primaryType": "SafeTx",
    "types": {
      "EIP712Domain": [
        {
          "name": "chainId",
          "type": "uint256"
        },
        {
          "name": "verifyingContract",
          "type": "address"
        }
      ],
      "SafeTx": [
        {
          "name": "to",
          "type": "address"
        },
        {
          "name": "value",
          "type": "uint256"
        },
        {
          "name": "data",
          "type": "bytes"
        },
        {
          "name": "operation",
          "type": "uint8"
        },
        {
          "name": "safeTxGas",
          "type": "uint256"
        },
        {
          "name": "baseGas",
          "type": "uint256"
        },
        {
          "name": "gasPrice",
          "type": "uint256"
        },
        {
          "name": "gasToken",
          "type": "address"
        },
        {
          "name": "refundReceiver",
          "type": "address"
        },
        {
          "name": "nonce",
          "type": "uint256"
        }
      ]
    }
  },
  "swap_provider": "one_inch",
  "quote_expires_at": "2023-11-07T05:31:56Z",
  "firm_available": true
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

x-api-key

string

header

required

Your Compass API Key. Get your key here.

Body

application/json

Unwind a leveraged loop: repeatedly withdraw collateral, swap it back to the borrow token at a guaranteed minimum output, and repay — all in ONE atomic transaction from the Credit Account.

owner

string

default:0x0E407CdeBD8e078E6966ef6740540d25F5897082

required

The address that owns the Credit Account.

Example:

"0x0E407CdeBD8e078E6966ef6740540d25F5897082"

chain

enum<string>

default:ethereum

required

Blockchain network.

Available options:

arbitrum,

base,

bsc,

ethereum,

hyperevm,

tempo

Example:

"ethereum"

collateral_token

string

default:WETH

required

Token supplied as collateral in the loop being unwound. For MORPHO it must be the market's collateral token.

Examples:

"wstETH"

"WETH"

borrow_token

string

default:USDC

required

Token borrowed in the loop; withdrawn collateral is swapped back to it and used to repay. For MORPHO it must be the market's loan token.

Examples:

"WETH"

"USDC"

protocol

enum<string>

default:AAVE

Lending protocol to unwind: AAVE, MORPHO, or EULER.

Available options:

AAVE,

EULER,

MORPHO

Example:

"AAVE"

market_id

string | null

Morpho only: the bytes32 market id (from /v2/credit/morpho_markets). Required when protocol=MORPHO.

collateral_vault

string | null

Euler only: the EVK vault the loop's collateral is in. Required when protocol=EULER.

borrow_vault

string | null

Euler only: the EVK vault the loop borrowed from (the sub-account's controller). Required when protocol=EULER.

sub_account_id

integer

default:0

Euler only: the EVC sub-account (0-255) holding the looped position to unwind. 0 is the Credit Account itself.

Required range: 0 <= x <= 255

target_multiplier

Target leverage after the unwind. Omit (null) for a FULL unwind: the debt is cleared exactly — accrued interest included — and all pair collateral is withdrawn back to the Credit Account. 1 runs the same exact debt close but leaves the collateral supplied (earning). A value greater than 1 delevers the position to that multiplier. Must be below the position's current multiplier.

Required range: x >= 1

Example:

2

max_slippage_percent

default:0.5

Per-swap slippage tolerance in percent. Unwind dust is bounded by this per iteration, so tighter slippage means less dust.

Required range: 0 < x <= 10

Example:

0.3

allow_partial

boolean

default:false

If the target cannot be reached in one transaction (e.g. a position opened very close to the liquidation threshold), return the maximum-progress plan (preview.fully_unwound=false) instead of a 400. A second unloop call, now from a much lower leverage, finishes the job.

Example:

false

gas_sponsorship

boolean

default:false

If true, returns EIP-712 typed data for gas-sponsored execution instead of an unsigned transaction.

Example:

false

preview

boolean

default:false

If true, build a display estimate only: the swap legs are priced at market rate and no single-use firm quote is ever spent. Set it on every parameter-exploration call and omit it only on the build the user is about to sign.

Response

Successful Response

The atomic unwind transaction plus its guaranteed-floor preview.

preview

CreditUnloopPreview · object

required

Projected end state, computed on guaranteed swap floors.

Show child attributes

transaction

UnsignedTransaction · object | null

Unsigned transaction for direct execution by the owner. Present when gas_sponsorship=false — except firm-priced previews (preview=true with swap_provider='bebop'), which carry numbers only: the firm quotes are fetched at execution time, so there is no payload to sign yet.

Show child attributes

Example:

{
  "chainId": "0x2105",
  "data": "0x1688f0b900000000000000000000000029fcb43b46531bca003ddc8fcb67ffe91900c762000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000675f4a3d",
  "from": "0x4A83b4413CF41C3244027e1590E35a0F48403F0c",
  "gas": "0x7a120",
  "maxFeePerGas": "0x59682f00",
  "maxPriorityFeePerGas": "0x3b9aca00",
  "nonce": "0x5",
  "to": "0x4e1DCf7AD4e460CfD30791CCC4F9c8a4f820ec67",
  "value": "0x0"
}

eip_712

BatchedSafeOperationsResponse · object | null

EIP-712 typed data for gas-sponsored execution. Present when gas_sponsorship=true.

Show child attributes

Example:

{
  "domain": {
    "chainId": 8453,
    "verifyingContract": "0x6B90E8B4E3E971E74C1A47a3a20976377E2dB4b1"
  },
  "message": {
    "baseGas": "0",
    "data": "0x8d80ff0a0000000000000000000000000000000000000000000000000000000000000020",
    "gasPrice": "0",
    "gasToken": "0x0000000000000000000000000000000000000000",
    "nonce": "7",
    "operation": 1,
    "refundReceiver": "0x0000000000000000000000000000000000000000",
    "safeTxGas": "0",
    "to": "0x93C23AAE4793C14D6DF35D2A2A2234204e1559dA",
    "value": "0"
  },
  "primaryType": "SafeTx",
  "types": {
    "EIP712Domain": [
      { "name": "chainId", "type": "uint256" },
      {
        "name": "verifyingContract",
        "type": "address"
      }
    ],
    "SafeTx": [
      { "name": "to", "type": "address" },
      { "name": "value", "type": "uint256" },
      { "name": "data", "type": "bytes" },
      { "name": "operation", "type": "uint8" },
      { "name": "safeTxGas", "type": "uint256" },
      { "name": "baseGas", "type": "uint256" },
      { "name": "gasPrice", "type": "uint256" },
      { "name": "gasToken", "type": "address" },
      {
        "name": "refundReceiver",
        "type": "address"
      },
      { "name": "nonce", "type": "uint256" }
    ]
  }
}

swap_provider

enum<string>

default:one_inch

Which venue priced the swap leg(s): 'one_inch' (market route, slippage-bounded floors) or 'bebop' (firm quotes, one per swap leg, each partially filled at the leg's size). On preview=true responses, 'bebop' means the numbers are INDICATIVE, computed from the firm venue's live maker price levels without spending any quote; execution fetches the firm quotes at signing time. Always present, including on fallbacks.

Available options:

one_inch,

bebop

quote_expires_at

string<date-time> | null

Deadline of the firm swap quotes (the earliest across the unwind's swap legs) — sign and broadcast before it or the transaction reverts on-chain; refresh by re-calling this endpoint (discard the previous payload). Present only on executable swap_provider='bebop' builds; null on previews (no quote is spent for a preview).

firm_available

boolean | null

Preview-only advisory: whether a firm-quote venue can serve this unwind's swap legs (estimated without spending any quote). Present only on preview=true responses; null otherwise.

⌘I