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_loop(owner="0x5e5b00ed886A6879C2B934612D2312975427fcAf", chain=models.CreditLoopRequestChain.ETHEREUM, collateral_token="WETH", borrow_token="USDC", initial_collateral_amount=1, multiplier=2, loan_to_value=70, protocol=models.CreditProtocol.AAVE, sub_account_id=0, max_slippage_percent=0.5, 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.creditLoop({
    owner: "0x5e5b00ed886A6879C2B934612D2312975427fcAf",
    chain: "ethereum",
    protocol: "AAVE",
    collateralToken: "WETH",
    borrowToken: "USDC",
    initialCollateralAmount: 1,
    multiplier: 2,
    loanToValue: 70,
    maxSlippagePercent: 0.5,
    gasSponsorship: false,
  });

  console.log(result);
}

run();

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

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

fetch('https://api.compasslabs.ai/v2/credit/loop', 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/loop",
  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' => '0x5e5b00ed886A6879C2B934612D2312975427fcAf',
    'chain' => 'ethereum',
    'protocol' => 'AAVE',
    'collateral_token' => 'WETH',
    'borrow_token' => 'USDC',
    'initial_collateral_amount' => 1,
    'multiplier' => 2,
    'loan_to_value' => 70,
    'max_slippage_percent' => 0.5,
    '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/loop"

	payload := strings.NewReader("{\n  \"owner\": \"0x5e5b00ed886A6879C2B934612D2312975427fcAf\",\n  \"chain\": \"ethereum\",\n  \"protocol\": \"AAVE\",\n  \"collateral_token\": \"WETH\",\n  \"borrow_token\": \"USDC\",\n  \"initial_collateral_amount\": 1,\n  \"multiplier\": 2,\n  \"loan_to_value\": 70,\n  \"max_slippage_percent\": 0.5,\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/loop")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"owner\": \"0x5e5b00ed886A6879C2B934612D2312975427fcAf\",\n  \"chain\": \"ethereum\",\n  \"protocol\": \"AAVE\",\n  \"collateral_token\": \"WETH\",\n  \"borrow_token\": \"USDC\",\n  \"initial_collateral_amount\": 1,\n  \"multiplier\": 2,\n  \"loan_to_value\": 70,\n  \"max_slippage_percent\": 0.5,\n  \"gas_sponsorship\": false\n}")
  .asString();

require 'uri'
require 'net/http'

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

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\": \"0x5e5b00ed886A6879C2B934612D2312975427fcAf\",\n  \"chain\": \"ethereum\",\n  \"protocol\": \"AAVE\",\n  \"collateral_token\": \"WETH\",\n  \"borrow_token\": \"USDC\",\n  \"initial_collateral_amount\": 1,\n  \"multiplier\": 2,\n  \"loan_to_value\": 70,\n  \"max_slippage_percent\": 0.5,\n  \"gas_sponsorship\": false\n}"

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

{
  "preview": {
    "iterations": 123,
    "total_collateral_supplied": "<string>",
    "total_borrowed": "<string>",
    "achieved_multiplier": "<string>",
    "projected_ltv": "<string>",
    "projected_health_factor": "<string>",
    "estimated_max_dust": "<string>",
    "estimated_swap_cost": "<string>",
    "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",
  "max_firm_multiplier": "<string>"
}

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

Credit

Open a leveraged loop

Open a leveraged loop into an Aave or Morpho market in ONE atomic transaction.

Repeatedly supplies collateral, borrows at the requested loan-to-value, and swaps the borrow back to collateral. Each iteration’s supply uses the swap’s GUARANTEED minimum output (enforced on-chain), so a fill anywhere within the slippage tolerance can never break a later step; any positive surplus stays in the Credit Account (the preview reports the bound as estimated_max_dust). Very large loops relative to pool depth can still exceed the slippage tolerance through their own cumulative price impact — size accordingly or raise max_slippage_percent. Conversely, the geometric tail can shrink below the swap router’s minimum routable size; when it does the loop simply ends early on that supply — the achieved multiplier is still guaranteed within 0.5% of the request or the call returns a clean 400.

When the collateral token is itself an ERC-4626 vault share (e.g. a Morpho vault token like steakUSDC), each conversion swaps the borrow token to the vault’s underlying asset and mints the shares via the vault’s own deposit at net asset value instead of swapping the share token on a DEX — share tokens have no honest DEX route. A direct share-token route is only ever used when it prices within 1% of net asset value.

The Credit Account must already hold initial_collateral_amount of collateral_token. For protocol=MORPHO pass a market_id from /v2/credit/morpho_markets.

POST

credit

loop

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_loop(owner="0x5e5b00ed886A6879C2B934612D2312975427fcAf", chain=models.CreditLoopRequestChain.ETHEREUM, collateral_token="WETH", borrow_token="USDC", initial_collateral_amount=1, multiplier=2, loan_to_value=70, protocol=models.CreditProtocol.AAVE, sub_account_id=0, max_slippage_percent=0.5, 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.creditLoop({
    owner: "0x5e5b00ed886A6879C2B934612D2312975427fcAf",
    chain: "ethereum",
    protocol: "AAVE",
    collateralToken: "WETH",
    borrowToken: "USDC",
    initialCollateralAmount: 1,
    multiplier: 2,
    loanToValue: 70,
    maxSlippagePercent: 0.5,
    gasSponsorship: false,
  });

  console.log(result);
}

run();

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

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

fetch('https://api.compasslabs.ai/v2/credit/loop', 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/loop",
  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' => '0x5e5b00ed886A6879C2B934612D2312975427fcAf',
    'chain' => 'ethereum',
    'protocol' => 'AAVE',
    'collateral_token' => 'WETH',
    'borrow_token' => 'USDC',
    'initial_collateral_amount' => 1,
    'multiplier' => 2,
    'loan_to_value' => 70,
    'max_slippage_percent' => 0.5,
    '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/loop"

	payload := strings.NewReader("{\n  \"owner\": \"0x5e5b00ed886A6879C2B934612D2312975427fcAf\",\n  \"chain\": \"ethereum\",\n  \"protocol\": \"AAVE\",\n  \"collateral_token\": \"WETH\",\n  \"borrow_token\": \"USDC\",\n  \"initial_collateral_amount\": 1,\n  \"multiplier\": 2,\n  \"loan_to_value\": 70,\n  \"max_slippage_percent\": 0.5,\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/loop")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"owner\": \"0x5e5b00ed886A6879C2B934612D2312975427fcAf\",\n  \"chain\": \"ethereum\",\n  \"protocol\": \"AAVE\",\n  \"collateral_token\": \"WETH\",\n  \"borrow_token\": \"USDC\",\n  \"initial_collateral_amount\": 1,\n  \"multiplier\": 2,\n  \"loan_to_value\": 70,\n  \"max_slippage_percent\": 0.5,\n  \"gas_sponsorship\": false\n}")
  .asString();

require 'uri'
require 'net/http'

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

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\": \"0x5e5b00ed886A6879C2B934612D2312975427fcAf\",\n  \"chain\": \"ethereum\",\n  \"protocol\": \"AAVE\",\n  \"collateral_token\": \"WETH\",\n  \"borrow_token\": \"USDC\",\n  \"initial_collateral_amount\": 1,\n  \"multiplier\": 2,\n  \"loan_to_value\": 70,\n  \"max_slippage_percent\": 0.5,\n  \"gas_sponsorship\": false\n}"

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

{
  "preview": {
    "iterations": 123,
    "total_collateral_supplied": "<string>",
    "total_borrowed": "<string>",
    "achieved_multiplier": "<string>",
    "projected_ltv": "<string>",
    "projected_health_factor": "<string>",
    "estimated_max_dust": "<string>",
    "estimated_swap_cost": "<string>",
    "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",
  "max_firm_multiplier": "<string>"
}

{
  "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

Open a leveraged loop: repeatedly supply collateral, borrow, and swap the borrow back to collateral — all in ONE atomic transaction from the Credit Account.

owner

string

default:0x5e5b00ed886A6879C2B934612D2312975427fcAf

required

The address that owns the Credit Account.

Example:

"0x5e5b00ed886A6879C2B934612D2312975427fcAf"

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 each iteration. Must already be in the Credit Account for the initial amount. For MORPHO it must be the market's collateral token.

Examples:

"wstETH"

"WETH"

borrow_token

string

default:USDC

required

Token borrowed each iteration and swapped back to the collateral token. For MORPHO it must be the market's loan token.

Examples:

"WETH"

"USDC"

initial_collateral_amount

default:1

required

Collateral (in token units) already held in the Credit Account to seed the loop.

Required range: x > 0

Example:

1.5

multiplier

default:2

required

Target leverage: total collateral exposure = multiplier × initial_collateral_amount. Must be achievable at the requested loan_to_value (max ≈ 0.9 / (1 − LTV)).

Required range: x > 1

Example:

2

loan_to_value

default:70

required

Per-iteration borrow LTV in percent. Must not exceed the protocol's maximum for the market (Aave reserve/e-mode LTV; Morpho LLTV with a safety margin); borrows are sized slightly inside the requested value so no leg sits on the protocol's revert boundary.

Required range: 0 < x <= 100

Example:

70

protocol

enum<string>

default:AAVE

Lending protocol to loop into: 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 address collateral is supplied to (from /v2/credit/euler_markets). Required when protocol=EULER.

borrow_vault

string | null

Euler only: the EVK vault address 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 this isolated looped position. 0 is the Credit Account itself.

Required range: 0 <= x <= 255

max_slippage_percent

default:0.5

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

Required range: 0 < x <= 10

Example:

0.3

emode_category

integer | null

Aave only: e-mode category to enable before looping (higher LTV for correlated pairs, e.g. ETH-correlated).

Required range: x >= 0

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: swap legs always route through the default aggregator and no firm RFQ quotes are requested (quote_expires_at stays null). Set it on every call made while a user is exploring parameters, and leave it false only for the build they actually intend to sign — firm quotes are single-use maker commitments, and requesting them for displays that are never executed degrades the pricing this API is offered.

Response

Successful Response

The atomic loop transaction plus its guaranteed-floor preview.

preview

CreditLoopPreview · 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' (iterative loop, slippage-bounded floors) or 'bebop' (firm zero-slippage quotes, one per swap leg, each partially filled at the leg's size — exact fills, zero dust). 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 loop'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).

max_firm_multiplier

string | null

Multiplier bound firm zero-slippage quotes can fill for the requested position size, LTV and target (estimated without spending any quote). The requested multiplier is firm-servable iff it is <= this value; above it the loop executes at market rate with slippage-bounded floors instead. Present only on preview=true responses when a firm-quote venue covers the pair; null otherwise. Recompute per parameter change - minimum-size floors make reachability target-dependent.

⌘I