Move one or more leveraged positions to the state you want, in ONE atomic
transaction.
List the positions to change and the end state you want for each. The API
works out whether that means opening, growing, shrinking, delevering or
closing, and does them all together.
Money freed by shrinking or closing one position pays for growing or opening
another, so shifting funds between positions needs no new deposit. Any
shortfall is taken from the Credit Account’s idle balance, and the call
returns 422 if that does not cover it either.
See the Leveraged Looping guide
for protocol and chain coverage, capital routing and the full error list.
Rebalance one or more Credit Account positions to their named end-states —
lever up or down, grow or shrink equity, open a new position, close an existing
one, or migrate (close one and open another) — all in ONE atomic transaction
from the Credit Account.
Request-level per-swap slippage tolerance in percent (including routing swaps). A per-target max_slippage_percent overrides it where set.
Required range: 0 < x <= 10
Example:
0.3
gas_sponsorship
boolean
default:false
If true, returns EIP-712 typed data for gas-sponsored execution instead of an unsigned transaction.
Example:
false
Response
Successful Response
The atomic rebalance transaction plus its guaranteed-floor preview.
preview
CreditRebalancePreview · 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. Null when the book is already at its target — nothing to execute.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Compass API Docs","colors":{"primary":"#0284c7","light":"#0e9fe9","dark":"#0284c7"},"logo":{"light":"https://mintcdn.com/compasslabs-f07467e0/x2NrFgZ7soJbH6sc/logo/light.svg?fit=max\u0026auto=format\u0026n=x2NrFgZ7soJbH6sc\u0026q=85\u0026s=80a04b06674000990914306c6a833cb9","dark":"https://mintcdn.com/compasslabs-f07467e0/x2NrFgZ7soJbH6sc/logo/dark.svg?fit=max\u0026auto=format\u0026n=x2NrFgZ7soJbH6sc\u0026q=85\u0026s=77e910ba12605c7f004ad72498f8076f"},"favicon":"https://mintcdn.com/compasslabs-f07467e0/x2NrFgZ7soJbH6sc/favicon.svg?fit=max\u0026auto=format\u0026n=x2NrFgZ7soJbH6sc\u0026q=85\u0026s=2025e9c84a2b6b167d319b28e1ecb8a0","appearance":{"default":"light","strict":true},"navbar":{"links":[{"href":"https://calendly.com/elisabeth-compasslabs/30min","label":"Book a demo"},{"href":"https://compasslabs.ai/login","label":"Login"}]},"footer":{"socials":{"x":"https://x.com/labs_compass","github":"https://github.com/CompassLabs","linkedin":"https://www.linkedin.com/company/compass-labs-ai","medium":"https://medium.com/@compasslabs","telegram":"https://discord.com/invite/ujetyJJPYr","discord":"https://discord.com/invite/ujetyJJPYr"},"links":[{"header":"Resources","items":[{"label":"Blog","href":"https://medium.com/@compasslabs"}]},{"header":"Legal","items":[{"label":"Terms \u0026 Conditions","href":"https://docs.compasslabs.ai/v1/support/terms-and-conditions"},{"label":"Privacy Policy","href":"https://docs.compasslabs.ai/v1/support/privacy-policy"}]}]},"styling":{"eyebrows":"section","codeblocks":"system","latex":false},"integrations":{"ga4":{"measurementId":"G-EQSZ3TK15C"},"gtm":{"tagId":"GTM-5NXMZG6D"}},"contextual":{"options":["chatgpt","claude"],"display":"header"},"navigation":{"global":{"tabs":[],"anchors":[]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"compasslabs-f07467e0","hasAudioNarration":false,"actualSubdomain":"compasslabs-f07467e0","customDomains":["docs.compasslabs.ai"],"gitSource":{"type":"github","owner":"compasslabs","repo":"mono","deployBranch":"production","contentDirectory":"api_docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"issues":true,"edits":true,"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af5b5300b3858d5ef253beb","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":300},{"language":"default","tag":"Documentation","count":30},{"language":"default","tag":"Aave V3","count":15},{"language":"default","tag":"Credit","count":15},{"language":"default","tag":"Perpetual Trading","count":15},{"language":"default","tag":"Tokenized Assets","count":15},{"language":"default","tag":"Earn","count":13},{"language":"default","tag":"Morpho","count":12},{"language":"default","tag":"Uniswap V3","count":10},{"language":"default","tag":"Transaction Bundler","count":9}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"button.css","content":"@keyframes jump{0%,100%{transform:translateY(0)}50%{transform:translateY(-20px)}}.jump-loop{animation:jump 0.5s ease infinite}#code-group{background-color:#EFEFEF33;box-shadow:0 4px 12px rgba(0, 0, 0, 0.08)}#code-group:hover{box-shadow:0 6px 18px rgba(0, 0, 0, 0.1)}#content-area>div.flex.flex-col.gap-8>div.mt-6.flex.w-full.flex-col.space-y-4>div{background-color:#EFEFEF33}#content-area>div.flex.flex-col.gap-8>div.mt-6.flex.w-full.flex-col.space-y-4>div{box-shadow:0 4px 12px rgba(0, 0, 0, 0.08)}#content-area>div.flex.flex-col.gap-8>div.mt-6.flex.w-full.flex-col.space-y-4>div:hover{box-shadow:0 6px 18px rgba(0, 0, 0, 0.1)}"}]}
{"page":{"pagePath":"v2/api-reference/credit/rebalance-the-leveraged-credit-book","slug":"/v2/api-reference/credit/rebalance-the-leveraged-credit-book","pageMetadata":{"title":"Rebalance the leveraged credit book","description":"Move one or more leveraged positions to the state you want, in ONE atomic\ntransaction.\n\nList the positions to change and the end state you want for each. The API\nworks out whether that means opening, growing, shrinking, delevering or\nclosing, and does them all together.\n\nMoney freed by shrinking or closing one position pays for growing or opening\nanother, so shifting funds between positions needs no new deposit. Any\nshortfall is taken from the Credit Account's idle balance, and the call\nreturns 422 if that does not cover it either.\n\nSee the [Leveraged Looping guide](https://docs.compasslabs.ai/v2/Products/Looping)\nfor protocol and chain coverage, capital routing and the full error list.","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json post /v2/credit/rebalance","href":"/v2/api-reference/credit/rebalance-the-leveraged-credit-book","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n a: \"a\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Move one or more leveraged positions to the state you want, in ONE atomic\\ntransaction.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"List the positions to change and the end state you want for each. The API\\nworks out whether that means opening, growing, shrinking, delevering or\\nclosing, and does them all together.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"Money freed by shrinking or closing one position pays for growing or opening\\nanother, so shifting funds between positions needs no new deposit. Any\\nshortfall is taken from the Credit Account’s idle balance, and the call\\nreturns 422 if that does not cover it either.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"See the \", _jsx(_components.a, {\n href: \"https://docs.compasslabs.ai/v2/Products/Looping\",\n children: \"Leveraged Looping guide\"\n }), \"\\nfor protocol and chain coverage, capital routing and the full error list.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":"system","config":{},"pageMetadata":{"title":"Rebalance the leveraged credit book","description":"Move one or more leveraged positions to the state you want, in ONE atomic\ntransaction.\n\nList the positions to change and the end state you want for each. The API\nworks out whether that means opening, growing, shrinking, delevering or\nclosing, and does them all together.\n\nMoney freed by shrinking or closing one position pays for growing or opening\nanother, so shifting funds between positions needs no new deposit. Any\nshortfall is taken from the Credit Account's idle balance, and the call\nreturns 422 if that does not cover it either.\n\nSee the [Leveraged Looping guide](https://docs.compasslabs.ai/v2/Products/Looping)\nfor protocol and chain coverage, capital routing and the full error list.","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json post /v2/credit/rebalance","href":"/v2/api-reference/credit/rebalance-the-leveraged-credit-book","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/compasslabs-f07467e0/27fd886bf35b6ed0/redeploy-trigger.js","/_mintlify/custom/compasslabs-f07467e0/5b350f94165e79a1/scripts/auth-btns.js","/_mintlify/custom/compasslabs-f07467e0/0c2ee6a003a69104/scripts/home-btn-link.js","/_mintlify/custom/compasslabs-f07467e0/17a3e2d25ff9b880/scripts/magic.js","/_mintlify/custom/compasslabs-f07467e0/2592024b81e4044f/scripts/modal.js","/_mintlify/custom/compasslabs-f07467e0/60b3db97b96f7d26/scripts/language-icon-fixer.js","/_mintlify/custom/compasslabs-f07467e0/60408501351ea2bb/scripts/disable-bundler-playground.js"],"openApiReferenceData":{"operation":{"tags":["Credit"],"summary":"Rebalance the leveraged credit book","description":"Move one or more leveraged positions to the state you want, in ONE atomic\ntransaction.\n\nList the positions to change and the end state you want for each. The API\nworks out whether that means opening, growing, shrinking, delevering or\nclosing, and does them all together.\n\nMoney freed by shrinking or closing one position pays for growing or opening\nanother, so shifting funds between positions needs no new deposit. Any\nshortfall is taken from the Credit Account's idle balance, and the call\nreturns 422 if that does not cover it either.\n\nSee the [Leveraged Looping guide](https://docs.compasslabs.ai/v2/Products/Looping)\nfor protocol and chain coverage, capital routing and the full error list.","operationId":"v2_credit_rebalance","requestBody":"1dba04bc-d9dd-4182-a696-321afcb7448f","responses":{"200":"e19cab45-8346-4abe-8958-53535d2eb4fb","422":"ad847bf4-836f-48d1-9d39-9be847e4d5af"},"x-speakeasy-name-override":"credit_rebalance","x-codeSamples":[{"lang":"python","label":"Python (SDK)","source":"from compass_api_sdk import CompassAPI, models\n\n\nwith CompassAPI(\n api_key_auth=\"\u003cYOUR_API_KEY_HERE>\",\n) as compass_api:\n\n res = compass_api.credit.credit_rebalance(owner=\"0x4D3c07d1db7E4A9E44285fae9810d6549655bc74\", chain=models.CreditRebalanceRequestChain.ETHEREUM, targets=[\n {\n \"protocol\": models.CreditProtocol.AAVE,\n \"collateral_token\": \"WETH\",\n \"borrow_token\": \"USDC\",\n \"target_multiplier\": 2.0,\n },\n ], max_slippage_percent=0.5, gas_sponsorship=False)\n\n # Handle response\n print(res)"},{"lang":"typescript","label":"Typescript (SDK)","source":"import { CompassApiSDK } from \"@compass-labs/api-sdk\";\n\nconst compassApiSDK = new CompassApiSDK({\n apiKeyAuth: \"\u003cYOUR_API_KEY_HERE>\",\n});\n\nasync function run() {\n const result = await compassApiSDK.credit.creditRebalance({\n owner: \"0x4D3c07d1db7E4A9E44285fae9810d6549655bc74\",\n chain: \"ethereum\",\n targets: [\n {\n protocol: \"AAVE\",\n collateralToken: \"WETH\",\n borrowToken: \"USDC\",\n targetMultiplier: 2,\n },\n ],\n maxSlippagePercent: 0.5,\n gasSponsorship: false,\n });\n\n console.log(result);\n}\n\nrun();"}],"method":"post","type":"path","servers":["5cc70962-0013-441d-bd6f-5cb484ceb892"],"security":["e89f6d8c-9ae7-44f6-91ab-c06b98b98bae"],"path":"/v2/credit/rebalance","baseUrlOptions":["https://api.compasslabs.ai"],"title":"Rebalance the leveraged credit book","codeSamples":[{"label":"Python (SDK)","lang":"python","source":"from compass_api_sdk import CompassAPI, models\n\n\nwith CompassAPI(\n api_key_auth=\"\u003cYOUR_API_KEY_HERE>\",\n) as compass_api:\n\n res = compass_api.credit.credit_rebalance(owner=\"0x4D3c07d1db7E4A9E44285fae9810d6549655bc74\", chain=models.CreditRebalanceRequestChain.ETHEREUM, targets=[\n {\n \"protocol\": models.CreditProtocol.AAVE,\n \"collateral_token\": \"WETH\",\n \"borrow_token\": \"USDC\",\n \"target_multiplier\": 2.0,\n },\n ], max_slippage_percent=0.5, gas_sponsorship=False)\n\n # Handle response\n print(res)"},{"label":"Typescript (SDK)","lang":"typescript","source":"import { CompassApiSDK } from \"@compass-labs/api-sdk\";\n\nconst compassApiSDK = new CompassApiSDK({\n apiKeyAuth: \"\u003cYOUR_API_KEY_HERE>\",\n});\n\nasync function run() {\n const result = await compassApiSDK.credit.creditRebalance({\n owner: \"0x4D3c07d1db7E4A9E44285fae9810d6549655bc74\",\n chain: \"ethereum\",\n targets: [\n {\n protocol: \"AAVE\",\n collateralToken: \"WETH\",\n borrowToken: \"USDC\",\n targetMultiplier: 2,\n },\n ],\n maxSlippagePercent: 0.5,\n gasSponsorship: false,\n });\n\n console.log(result);\n}\n\nrun();"}],"requiredOnlyExamples":false,"requestExampleType":"codeSamples","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"properties":{"owner":{"type":"string","title":"Owner","description":"The address that owns the Credit Account.","default":"0x4D3c07d1db7E4A9E44285fae9810d6549655bc74","examples":["0x4D3c07d1db7E4A9E44285fae9810d6549655bc74"],"isRequired":true,"uniqueKey":"owner","typeLabel":"string"},"chain":{"type":"string","enum":["arbitrum","base","bsc","ethereum","tempo"],"title":"Chain","description":"Blockchain network. Rebalance is not available on HyperEVM yet; use loop/unloop there.","default":"ethereum","examples":["ethereum"],"isRequired":true,"uniqueKey":"chain","typeLabel":"enum\u003cstring>"},"targets":{"items":{"properties":{"collateral_token":{"type":"string","title":"Token","description":"Token supplied as collateral for this position. For MORPHO it must be the market's collateral token.","examples":["wstETH","WETH"],"isRequired":true,"uniqueKey":"targets.items.[INDEX].collateral_token","typeLabel":"string"},"borrow_token":{"type":"string","title":"Token","description":"Token borrowed against the collateral for this position. For MORPHO it must be the market's loan token.","examples":["WETH","USDC"],"isRequired":true,"uniqueKey":"targets.items.[INDEX].borrow_token","typeLabel":"string"},"protocol":{"type":"string","enum":["AAVE","EULER","MORPHO"],"title":"CreditProtocol","description":"Lending protocol of this position: AAVE, MORPHO or EULER.","default":"AAVE","uniqueKey":"targets.items.[INDEX].protocol","typeLabel":"enum\u003cstring>"},"market_id":{"oneOf":[{"type":"string","title":"Market Id","description":"Morpho only: the bytes32 market id (from /v2/credit/morpho_markets). Required when protocol=MORPHO.","uniqueKey":"targets.items.[INDEX].market_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Market Id","description":"Morpho only: the bytes32 market id (from /v2/credit/morpho_markets). Required when protocol=MORPHO.","uniqueKey":"targets.items.[INDEX].market_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"targets.items.[INDEX].market_id","typeLabel":"string | null"},"collateral_vault":{"oneOf":[{"type":"string","title":"Collateral Vault","description":"Euler only: the EVK vault the collateral is supplied to (from /v2/credit/euler_markets). Required when protocol=EULER.","uniqueKey":"targets.items.[INDEX].collateral_vault.oneOf.0","typeLabel":"string"},{"type":"null","title":"Collateral Vault","description":"Euler only: the EVK vault the collateral is supplied to (from /v2/credit/euler_markets). Required when protocol=EULER.","uniqueKey":"targets.items.[INDEX].collateral_vault.oneOf.1","typeLabel":"null"}],"uniqueKey":"targets.items.[INDEX].collateral_vault","typeLabel":"string | null"},"borrow_vault":{"oneOf":[{"type":"string","title":"Borrow Vault","description":"Euler only: the EVK vault borrowed from (the sub-account's controller). Required when protocol=EULER.","uniqueKey":"targets.items.[INDEX].borrow_vault.oneOf.0","typeLabel":"string"},{"type":"null","title":"Borrow Vault","description":"Euler only: the EVK vault borrowed from (the sub-account's controller). Required when protocol=EULER.","uniqueKey":"targets.items.[INDEX].borrow_vault.oneOf.1","typeLabel":"null"}],"uniqueKey":"targets.items.[INDEX].borrow_vault","typeLabel":"string | null"},"sub_account_id":{"oneOf":[{"type":"integer","title":"Sub Account Id","description":"Euler only: the EVC sub-account (0-255) this position lives in. Omit it and the plan resolves it from the live book: the sub-account already holding this vault pair, else the lowest free sub-account for a new position. The resolved id is echoed in the preview. Pass it explicitly when the same pair is open on several sub-accounts.","maximum":255,"minimum":0,"uniqueKey":"targets.items.[INDEX].sub_account_id.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Sub Account Id","description":"Euler only: the EVC sub-account (0-255) this position lives in. Omit it and the plan resolves it from the live book: the sub-account already holding this vault pair, else the lowest free sub-account for a new position. The resolved id is echoed in the preview. Pass it explicitly when the same pair is open on several sub-accounts.","uniqueKey":"targets.items.[INDEX].sub_account_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"targets.items.[INDEX].sub_account_id","typeLabel":"integer | null"},"target_equity_usd":{"oneOf":[{"type":"number","title":"Target Equity Usd","description":"SIZE knob: the net value (collateral − debt, in USD) to commit to this position; total collateral ≈ target_equity_usd × target_multiplier. To remove a position use close=true, never target_equity_usd=0.","minimum":0,"example":10000,"exclusiveMinimum":true,"uniqueKey":"targets.items.[INDEX].target_equity_usd.oneOf.0","typeLabel":"number"},{"type":"string","title":"Target Equity Usd","description":"SIZE knob: the net value (collateral − debt, in USD) to commit to this position; total collateral ≈ target_equity_usd × target_multiplier. To remove a position use close=true, never target_equity_usd=0.","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","example":10000,"uniqueKey":"targets.items.[INDEX].target_equity_usd.oneOf.1","typeLabel":"string"},{"type":"null","title":"Target Equity Usd","description":"SIZE knob: the net value (collateral − debt, in USD) to commit to this position; total collateral ≈ target_equity_usd × target_multiplier. To remove a position use close=true, never target_equity_usd=0.","example":10000,"uniqueKey":"targets.items.[INDEX].target_equity_usd.oneOf.2","typeLabel":"null"}],"uniqueKey":"targets.items.[INDEX].target_equity_usd","typeLabel":"number | string | null"},"target_multiplier":{"oneOf":[{"type":"number","title":"Target Multiplier","description":"LEVERAGE knob: total collateral exposure ÷ equity. 1 means unlevered supplied collateral. The protocol maximum is enforced when the plan is built.","minimum":1,"example":2,"uniqueKey":"targets.items.[INDEX].target_multiplier.oneOf.0","typeLabel":"number"},{"type":"string","title":"Target Multiplier","description":"LEVERAGE knob: total collateral exposure ÷ equity. 1 means unlevered supplied collateral. The protocol maximum is enforced when the plan is built.","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","example":2,"uniqueKey":"targets.items.[INDEX].target_multiplier.oneOf.1","typeLabel":"string"},{"type":"null","title":"Target Multiplier","description":"LEVERAGE knob: total collateral exposure ÷ equity. 1 means unlevered supplied collateral. The protocol maximum is enforced when the plan is built.","example":2,"uniqueKey":"targets.items.[INDEX].target_multiplier.oneOf.2","typeLabel":"null"}],"uniqueKey":"targets.items.[INDEX].target_multiplier","typeLabel":"number | string | null"},"close":{"type":"boolean","title":"Close","description":"If true, fully unwind this position: the debt is cleared exactly (accrued interest included) and the pair collateral is returned to the Credit Account.","default":false,"uniqueKey":"targets.items.[INDEX].close","typeLabel":"boolean"},"max_slippage_percent":{"oneOf":[{"type":"number","title":"Max Slippage Percent","description":"Per-target override of the request-level per-swap slippage tolerance in percent.","maximum":10,"minimum":0,"example":0.3,"exclusiveMinimum":true,"uniqueKey":"targets.items.[INDEX].max_slippage_percent.oneOf.0","typeLabel":"number"},{"type":"string","title":"Max Slippage Percent","description":"Per-target override of the request-level per-swap slippage tolerance in percent.","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","example":0.3,"uniqueKey":"targets.items.[INDEX].max_slippage_percent.oneOf.1","typeLabel":"string"},{"type":"null","title":"Max Slippage Percent","description":"Per-target override of the request-level per-swap slippage tolerance in percent.","example":0.3,"uniqueKey":"targets.items.[INDEX].max_slippage_percent.oneOf.2","typeLabel":"null"}],"uniqueKey":"targets.items.[INDEX].max_slippage_percent","typeLabel":"number | string | null"}},"type":"object","required":["collateral_token","borrow_token"],"title":"RebalanceTarget","description":"The desired end-state of ONE position in the Credit Account.\n\nScoped-declarative: only positions named in ``targets`` are touched; anything\nunlisted is left as-is. Set ``close=true`` to fully unwind a position — never\n``target_equity_usd=0``.","uniqueKey":"targets.items.[INDEX]","typeLabel":"RebalanceTarget · object"},"type":"array","minItems":1,"title":"Targets","description":"The positions to change. Scoped: only positions named here are touched; any position not listed is left untouched.","default":[{"borrow_token":"USDC","collateral_token":"WETH","protocol":"AAVE","target_multiplier":2}],"examples":[[{"borrow_token":"USDC","collateral_token":"WETH","protocol":"AAVE","target_multiplier":2}]],"isRequired":true,"uniqueKey":"targets","typeLabel":"RebalanceTarget · object[]"},"max_slippage_percent":{"oneOf":[{"type":"number","title":"Max Slippage Percent","description":"Request-level per-swap slippage tolerance in percent (including routing swaps). A per-target max_slippage_percent overrides it where set.","default":"0.5","maximum":10,"minimum":0,"example":0.3,"exclusiveMinimum":true,"uniqueKey":"max_slippage_percent.oneOf.0","typeLabel":"number"},{"type":"string","title":"Max Slippage Percent","description":"Request-level per-swap slippage tolerance in percent (including routing swaps). A per-target max_slippage_percent overrides it where set.","default":"0.5","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","example":0.3,"uniqueKey":"max_slippage_percent.oneOf.1","typeLabel":"string"}],"uniqueKey":"max_slippage_percent","typeLabel":"number | string"},"gas_sponsorship":{"type":"boolean","title":"Gas Sponsorship","description":"If true, returns EIP-712 typed data for gas-sponsored execution instead of an unsigned transaction.","default":false,"examples":[false],"uniqueKey":"gas_sponsorship","typeLabel":"boolean"}},"type":"object","required":["owner","chain","targets"],"title":"CreditRebalanceRequest","description":"Rebalance one or more Credit Account positions to their named end-states —\nlever up or down, grow or shrink equity, open a new position, close an existing\none, or migrate (close one and open another) — all in ONE atomic transaction\nfrom the Credit Account.","default":{"owner":"0x4D3c07d1db7E4A9E44285fae9810d6549655bc74","chain":"ethereum","max_slippage_percent":0.5,"gas_sponsorship":false,"targets":[{"borrow_token":"USDC","collateral_token":"WETH","protocol":"AAVE","target_multiplier":2}]},"uniqueKey":"","typeLabel":"CreditRebalanceRequest · object"},"examples":{"Example":{"title":"Example","value":{"owner":"0x4D3c07d1db7E4A9E44285fae9810d6549655bc74","chain":"ethereum","max_slippage_percent":0.5,"gas_sponsorship":false,"targets":[{"borrow_token":"USDC","collateral_token":"WETH","protocol":"AAVE","target_multiplier":2}]}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"e19cab45-8346-4abe-8958-53535d2eb4fb":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"preview":{"properties":{"net_equity_moved_usd":{"type":"string","title":"Net Equity Moved Usd","description":"Signed net equity moved: Σ(target − current equity, in USD) over the named targets. Positive = net book growth funded from the Credit Account's idle balance; negative = surplus equity released to idle. Truncated toward zero, so the reported magnitude is never larger than the true amount in either sign.","isRequired":true,"uniqueKey":"preview.net_equity_moved_usd","typeLabel":"string"},"total_legs":{"type":"integer","title":"Total Legs","description":"Total on-chain legs across the whole transaction, including capital-routing swaps. A rebalance too large for one transaction is rejected with a 422.","isRequired":true,"uniqueKey":"preview.total_legs","typeLabel":"integer"},"estimated_max_dust":{"type":"string","title":"Estimated Max Dust","description":"Upper bound of surplus all swaps (per-target and routing) can leave in the Credit Account (sum of each swap's quote minus its guaranteed floor). It accumulates in the Credit Account, is recoverable, and is never lost.","isRequired":true,"uniqueKey":"preview.estimated_max_dust","typeLabel":"string"},"per_target":{"items":{"properties":{"protocol":{"type":"string","enum":["AAVE","EULER","MORPHO"],"title":"CreditProtocol","description":"Lending protocol of this position: AAVE, MORPHO or EULER.","isRequired":true,"uniqueKey":"preview.per_target.items.[INDEX].protocol","typeLabel":"enum\u003cstring>"},"collateral_token":{"type":"string","title":"Collateral Token","description":"Collateral token address (echoes the request target; joins against /v2/credit/looped_positions).","isRequired":true,"uniqueKey":"preview.per_target.items.[INDEX].collateral_token","typeLabel":"string"},"borrow_token":{"type":"string","title":"Borrow Token","description":"Borrow token address (echoes the request target).","isRequired":true,"uniqueKey":"preview.per_target.items.[INDEX].borrow_token","typeLabel":"string"},"direction":{"type":"string","enum":["open","close","grow","shrink","lever_up","lever_down","noop"],"title":"RebalanceDirection","description":"What the plan does to this target: open, close, grow, shrink, lever_up, lever_down, or noop (already at target).","isRequired":true,"uniqueKey":"preview.per_target.items.[INDEX].direction","typeLabel":"enum\u003cstring>"},"legs":{"type":"integer","title":"Legs","description":"On-chain legs planned for this target (loop + unloop iterations); 0 for a noop.","isRequired":true,"uniqueKey":"preview.per_target.items.[INDEX].legs","typeLabel":"integer"},"resulting_collateral":{"type":"string","title":"Resulting Collateral","description":"Guaranteed minimum collateral supplied to this position after the rebalance (token units).","isRequired":true,"uniqueKey":"preview.per_target.items.[INDEX].resulting_collateral","typeLabel":"string"},"resulting_debt":{"type":"string","title":"Resulting Debt","description":"Projected debt owed by this position after the rebalance (borrow-token units); 0 on a close.","isRequired":true,"uniqueKey":"preview.per_target.items.[INDEX].resulting_debt","typeLabel":"string"},"resulting_multiplier":{"type":"string","title":"Resulting Multiplier","description":"Projected leverage of this position after the rebalance; 1 when the debt is cleared. Never promises more leverage (or, when deleveraging, more deleverage) than is guaranteed.","isRequired":true,"uniqueKey":"preview.per_target.items.[INDEX].resulting_multiplier","typeLabel":"string"},"resulting_health_factor":{"type":"string","title":"Resulting Health Factor","description":"Projected health factor of this position after the rebalance. Never overstated at the 1.0 boundary — a liquidatable position is never presented as safe. See health_factor_scope for what it covers.","isRequired":true,"uniqueKey":"preview.per_target.items.[INDEX].resulting_health_factor","typeLabel":"string"},"health_factor_scope":{"type":"string","enum":["market","account"],"title":"Health Factor Scope","description":"'market' for Morpho and Euler (isolated health: per Morpho market, per Euler EVC sub-account). 'account' for Aave: collateral is pooled, so all collateral backs all debt and this health factor is shared by every Aave position on the account.","isRequired":true,"uniqueKey":"preview.per_target.items.[INDEX].health_factor_scope","typeLabel":"enum\u003cstring>"},"estimated_max_dust":{"type":"string","title":"Estimated Max Dust","description":"Upper bound of surplus this target's own swaps can leave in the Credit Account (sum of each swap's quote minus its guaranteed floor). Routing swaps are counted book-level, not here. It accumulates in the Credit Account, is recoverable, and is never lost.","isRequired":true,"uniqueKey":"preview.per_target.items.[INDEX].estimated_max_dust","typeLabel":"string"},"market_id":{"oneOf":[{"type":"string","title":"Market Id","description":"Morpho only: the bytes32 market id of this position.","uniqueKey":"preview.per_target.items.[INDEX].market_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Market Id","description":"Morpho only: the bytes32 market id of this position.","uniqueKey":"preview.per_target.items.[INDEX].market_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"preview.per_target.items.[INDEX].market_id","typeLabel":"string | null"},"sub_account_id":{"oneOf":[{"type":"integer","title":"Sub Account Id","description":"Euler only: the EVC sub-account (0-255) this position lives in — the id the request named, or the one the plan resolved when the target omitted it. Feed it back to /v2/credit/unloop and match it on /v2/credit/looped_positions.","uniqueKey":"preview.per_target.items.[INDEX].sub_account_id.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Sub Account Id","description":"Euler only: the EVC sub-account (0-255) this position lives in — the id the request named, or the one the plan resolved when the target omitted it. Feed it back to /v2/credit/unloop and match it on /v2/credit/looped_positions.","uniqueKey":"preview.per_target.items.[INDEX].sub_account_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"preview.per_target.items.[INDEX].sub_account_id","typeLabel":"integer | null"},"collateral_vault":{"oneOf":[{"type":"string","title":"Collateral Vault","description":"Euler only: the EVK vault holding the collateral (echoes the request target).","uniqueKey":"preview.per_target.items.[INDEX].collateral_vault.oneOf.0","typeLabel":"string"},{"type":"null","title":"Collateral Vault","description":"Euler only: the EVK vault holding the collateral (echoes the request target).","uniqueKey":"preview.per_target.items.[INDEX].collateral_vault.oneOf.1","typeLabel":"null"}],"uniqueKey":"preview.per_target.items.[INDEX].collateral_vault","typeLabel":"string | null"},"borrow_vault":{"oneOf":[{"type":"string","title":"Borrow Vault","description":"Euler only: the EVK controller vault the debt is owed to (echoes the request target).","uniqueKey":"preview.per_target.items.[INDEX].borrow_vault.oneOf.0","typeLabel":"string"},{"type":"null","title":"Borrow Vault","description":"Euler only: the EVK controller vault the debt is owed to (echoes the request target).","uniqueKey":"preview.per_target.items.[INDEX].borrow_vault.oneOf.1","typeLabel":"null"}],"uniqueKey":"preview.per_target.items.[INDEX].borrow_vault","typeLabel":"string | null"},"unloop_legs":{"items":{"properties":{"withdraw_amount":{"oneOf":[{"type":"string","title":"Withdraw Amount","description":"Collateral withdrawn this iteration (token units).","isRequired":true,"uniqueKey":"preview.per_target.items.[INDEX].unloop_legs.items.[INDEX].withdraw_amount.oneOf.0","typeLabel":"string"},{"type":"null","title":"Withdraw Amount","description":"Collateral withdrawn this iteration (token units).","isRequired":true,"uniqueKey":"preview.per_target.items.[INDEX].unloop_legs.items.[INDEX].withdraw_amount.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"preview.per_target.items.[INDEX].unloop_legs.items.[INDEX].withdraw_amount","typeLabel":"string | null"},"min_swap_out":{"oneOf":[{"type":"string","title":"Min Swap Out","description":"Guaranteed swap output (borrow-token units) — enforced on-chain by the swap's minimum-return. Null on the final collateral sweep leg, which does not swap.","uniqueKey":"preview.per_target.items.[INDEX].unloop_legs.items.[INDEX].min_swap_out.oneOf.0","typeLabel":"string"},{"type":"null","title":"Min Swap Out","description":"Guaranteed swap output (borrow-token units) — enforced on-chain by the swap's minimum-return. Null on the final collateral sweep leg, which does not swap.","uniqueKey":"preview.per_target.items.[INDEX].unloop_legs.items.[INDEX].min_swap_out.oneOf.1","typeLabel":"null"}],"uniqueKey":"preview.per_target.items.[INDEX].unloop_legs.items.[INDEX].min_swap_out","typeLabel":"string | null"},"repay_amount":{"oneOf":[{"type":"string","title":"Repay Amount","description":"Debt repaid this iteration (borrow-token units); null on the final collateral sweep leg.","uniqueKey":"preview.per_target.items.[INDEX].unloop_legs.items.[INDEX].repay_amount.oneOf.0","typeLabel":"string"},{"type":"null","title":"Repay Amount","description":"Debt repaid this iteration (borrow-token units); null on the final collateral sweep leg.","uniqueKey":"preview.per_target.items.[INDEX].unloop_legs.items.[INDEX].repay_amount.oneOf.1","typeLabel":"null"}],"uniqueKey":"preview.per_target.items.[INDEX].unloop_legs.items.[INDEX].repay_amount","typeLabel":"string | null"},"full_repay":{"type":"boolean","title":"Full Repay","description":"True on the closing leg that clears the remaining debt exactly (Aave clamps to live debt; Morpho repays the remaining shares).","default":false,"uniqueKey":"preview.per_target.items.[INDEX].unloop_legs.items.[INDEX].full_repay","typeLabel":"boolean"}},"additionalProperties":false,"type":"object","required":["withdraw_amount"],"title":"UnloopLegPreview","description":"One planned unwind iteration: withdraw [+ swap + repay].","uniqueKey":"preview.per_target.items.[INDEX].unloop_legs.items.[INDEX]","typeLabel":"UnloopLegPreview · object"},"type":"array","title":"Unloop Legs","description":"Per-iteration unwind breakdown — populated for releasers (close / shrink / lever_down).","default":[],"uniqueKey":"preview.per_target.items.[INDEX].unloop_legs","typeLabel":"UnloopLegPreview · object[]"},"loop_legs":{"items":{"properties":{"supply_amount":{"oneOf":[{"type":"string","title":"Supply Amount","description":"Collateral supplied this iteration (token units).","isRequired":true,"uniqueKey":"preview.per_target.items.[INDEX].loop_legs.items.[INDEX].supply_amount.oneOf.0","typeLabel":"string"},{"type":"null","title":"Supply Amount","description":"Collateral supplied this iteration (token units).","isRequired":true,"uniqueKey":"preview.per_target.items.[INDEX].loop_legs.items.[INDEX].supply_amount.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"preview.per_target.items.[INDEX].loop_legs.items.[INDEX].supply_amount","typeLabel":"string | null"},"borrow_amount":{"oneOf":[{"type":"string","title":"Borrow Amount","description":"Loan borrowed this iteration; null on the final supply-only iteration.","uniqueKey":"preview.per_target.items.[INDEX].loop_legs.items.[INDEX].borrow_amount.oneOf.0","typeLabel":"string"},{"type":"null","title":"Borrow Amount","description":"Loan borrowed this iteration; null on the final supply-only iteration.","uniqueKey":"preview.per_target.items.[INDEX].loop_legs.items.[INDEX].borrow_amount.oneOf.1","typeLabel":"null"}],"uniqueKey":"preview.per_target.items.[INDEX].loop_legs.items.[INDEX].borrow_amount","typeLabel":"string | null"},"min_swap_out":{"oneOf":[{"type":"string","title":"Min Swap Out","description":"Guaranteed swap output (collateral units) — the next iteration's supply. Enforced on-chain by the swap's minimum-return.","uniqueKey":"preview.per_target.items.[INDEX].loop_legs.items.[INDEX].min_swap_out.oneOf.0","typeLabel":"string"},{"type":"null","title":"Min Swap Out","description":"Guaranteed swap output (collateral units) — the next iteration's supply. Enforced on-chain by the swap's minimum-return.","uniqueKey":"preview.per_target.items.[INDEX].loop_legs.items.[INDEX].min_swap_out.oneOf.1","typeLabel":"null"}],"uniqueKey":"preview.per_target.items.[INDEX].loop_legs.items.[INDEX].min_swap_out","typeLabel":"string | null"},"expected_swap_out":{"oneOf":[{"type":"string","title":"Expected Swap Out","description":"Quoted swap output (collateral units) before the slippage floor is applied. Only min_swap_out is guaranteed on-chain; the gap between the two is the adverse-slippage tolerance, bounded by max_slippage_percent, not a surplus that is certain to arrive. Whatever the fill actually delivers above min_swap_out stays in the account, and estimated_max_dust is the upper bound on that.","uniqueKey":"preview.per_target.items.[INDEX].loop_legs.items.[INDEX].expected_swap_out.oneOf.0","typeLabel":"string"},{"type":"null","title":"Expected Swap Out","description":"Quoted swap output (collateral units) before the slippage floor is applied. Only min_swap_out is guaranteed on-chain; the gap between the two is the adverse-slippage tolerance, bounded by max_slippage_percent, not a surplus that is certain to arrive. Whatever the fill actually delivers above min_swap_out stays in the account, and estimated_max_dust is the upper bound on that.","uniqueKey":"preview.per_target.items.[INDEX].loop_legs.items.[INDEX].expected_swap_out.oneOf.1","typeLabel":"null"}],"uniqueKey":"preview.per_target.items.[INDEX].loop_legs.items.[INDEX].expected_swap_out","typeLabel":"string | null"}},"additionalProperties":false,"type":"object","required":["supply_amount"],"title":"LoopLegPreview","description":"One planned loop iteration.","uniqueKey":"preview.per_target.items.[INDEX].loop_legs.items.[INDEX]","typeLabel":"LoopLegPreview · object"},"type":"array","title":"Loop Legs","description":"Per-iteration loop breakdown — populated for consumers (open / grow / lever_up).","default":[],"uniqueKey":"preview.per_target.items.[INDEX].loop_legs","typeLabel":"LoopLegPreview · object[]"}},"additionalProperties":false,"type":"object","required":["protocol","collateral_token","borrow_token","direction","legs","resulting_collateral","resulting_debt","resulting_multiplier","resulting_health_factor","health_factor_scope","estimated_max_dust"],"title":"RebalanceTargetPreview","description":"Projected end state of ONE named target, computed on guaranteed swap floors.","uniqueKey":"preview.per_target.items.[INDEX]","typeLabel":"RebalanceTargetPreview · object"},"type":"array","title":"Per Target","description":"Per-target end state, in the same order as the request targets.","isRequired":true,"uniqueKey":"preview.per_target","typeLabel":"RebalanceTargetPreview · object[]"},"routing_swaps":{"items":{"properties":{"token_in":{"type":"string","title":"Token In","description":"Token sold by the Credit Account into this routing swap.","isRequired":true,"uniqueKey":"preview.routing_swaps.items.[INDEX].token_in","typeLabel":"string"},"token_out":{"type":"string","title":"Token Out","description":"Token bought and delivered to fund a consuming position.","isRequired":true,"uniqueKey":"preview.routing_swaps.items.[INDEX].token_out","typeLabel":"string"},"amount_in":{"type":"string","title":"Amount In","description":"Token-in amount the Credit Account gives up to this swap.","isRequired":true,"uniqueKey":"preview.routing_swaps.items.[INDEX].amount_in","typeLabel":"string"},"min_amount_out":{"type":"string","title":"Min Amount Out","description":"Guaranteed minimum output (token-out units), enforced on-chain by the swap's minimum-return. Any fill above it stays in the Credit Account as recoverable dust.","isRequired":true,"uniqueKey":"preview.routing_swaps.items.[INDEX].min_amount_out","typeLabel":"string"}},"additionalProperties":false,"type":"object","required":["token_in","token_out","amount_in","min_amount_out"],"title":"RoutingSwapPreview","description":"One Phase-B capital-routing swap that moves freed tokens between positions.\n\nBook-level: it is not attributable to a single target.","uniqueKey":"preview.routing_swaps.items.[INDEX]","typeLabel":"RoutingSwapPreview · object"},"type":"array","title":"Routing Swaps","description":"The capital-routing swaps that move freed tokens between positions, at a guaranteed minimum output enforced on-chain.","default":[],"uniqueKey":"preview.routing_swaps","typeLabel":"RoutingSwapPreview · object[]"},"aave_account_health_factor":{"oneOf":[{"type":"string","title":"Aave Account Health Factor","description":"Projected account-level Aave health factor after the rebalance — Aave collateral is pooled, so this is shared by every Aave target. Present whenever the end state holds any Aave collateral or debt; null for Morpho-only books. Never overstated at the 1.0 boundary.","uniqueKey":"preview.aave_account_health_factor.oneOf.0","typeLabel":"string"},{"type":"null","title":"Aave Account Health Factor","description":"Projected account-level Aave health factor after the rebalance — Aave collateral is pooled, so this is shared by every Aave target. Present whenever the end state holds any Aave collateral or debt; null for Morpho-only books. Never overstated at the 1.0 boundary.","uniqueKey":"preview.aave_account_health_factor.oneOf.1","typeLabel":"null"}],"uniqueKey":"preview.aave_account_health_factor","typeLabel":"string | null"}},"additionalProperties":false,"type":"object","required":["net_equity_moved_usd","total_legs","estimated_max_dust","per_target"],"title":"CreditRebalancePreview","description":"Projected end state, computed on guaranteed swap floors.","isRequired":true,"uniqueKey":"preview","typeLabel":"CreditRebalancePreview · object"},"transaction":{"oneOf":[{"type":"object","title":"UnsignedTransaction","description":"Unsigned transaction for direct execution by the owner. Present when gas_sponsorship=false. Null when the book is already at its target — nothing to execute.","required":["chainId","data","from","gas","to","value","nonce","maxFeePerGas","maxPriorityFeePerGas"],"example":{"chainId":"0x2105","data":"0x1688f0b900000000000000000000000029fcb43b46531bca003ddc8fcb67ffe91900c762000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000675f4a3d","from":"0x4A83b4413CF41C3244027e1590E35a0F48403F0c","gas":"0x7a120","maxFeePerGas":"0x59682f00","maxPriorityFeePerGas":"0x3b9aca00","nonce":"0x5","to":"0x4e1DCf7AD4e460CfD30791CCC4F9c8a4f820ec67","value":"0x0"},"properties":{"chainId":{"type":"string","title":"Chainid","description":"The chain id of the transaction","isRequired":true,"uniqueKey":"transaction.oneOf.0.chainId","typeLabel":"string"},"data":{"type":"string","title":"Data","description":"The data of the transaction","isRequired":true,"uniqueKey":"transaction.oneOf.0.data","typeLabel":"string"},"from":{"type":"string","title":"From","description":"The sender of the transaction","isRequired":true,"uniqueKey":"transaction.oneOf.0.from","typeLabel":"string"},"gas":{"oneOf":[{"type":"string","title":"Gas","description":"The gas of the transaction","isRequired":true,"uniqueKey":"transaction.oneOf.0.gas.oneOf.0","typeLabel":"string"},{"type":"null","title":"Gas","description":"The gas of the transaction","isRequired":true,"uniqueKey":"transaction.oneOf.0.gas.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"transaction.oneOf.0.gas","typeLabel":"string | null"},"to":{"type":"string","title":"To","description":"The recipient of the transaction","isRequired":true,"uniqueKey":"transaction.oneOf.0.to","typeLabel":"string"},"value":{"type":"string","title":"Value","description":"The value of the transaction","isRequired":true,"uniqueKey":"transaction.oneOf.0.value","typeLabel":"string"},"nonce":{"type":"string","title":"Nonce","description":"The nonce of the address","isRequired":true,"uniqueKey":"transaction.oneOf.0.nonce","typeLabel":"string"},"maxFeePerGas":{"type":"string","title":"Maxfeepergas","description":"The max fee per gas of the transaction","isRequired":true,"uniqueKey":"transaction.oneOf.0.maxFeePerGas","typeLabel":"string"},"maxPriorityFeePerGas":{"type":"string","title":"Maxpriorityfeepergas","description":"The max priority fee per gas of the transaction","isRequired":true,"uniqueKey":"transaction.oneOf.0.maxPriorityFeePerGas","typeLabel":"string"}},"uniqueKey":"transaction.oneOf.0","typeLabel":"UnsignedTransaction · object"},{"type":"null","description":"Unsigned transaction for direct execution by the owner. Present when gas_sponsorship=false. Null when the book is already at its target — nothing to execute.","uniqueKey":"transaction.oneOf.1","typeLabel":"null"}],"uniqueKey":"transaction","typeLabel":"UnsignedTransaction · object | null"},"eip_712":{"oneOf":[{"type":"object","title":"BatchedSafeOperationsResponse","description":"EIP-712 typed data for gas-sponsored execution. Present when gas_sponsorship=true.","required":["domain","types","primaryType","message"],"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"}]}},"properties":{"domain":{"properties":{"chainId":{"type":"integer","title":"Chainid","description":"Chain ID","isRequired":true,"uniqueKey":"eip_712.oneOf.0.domain.chainId","typeLabel":"integer"},"verifyingContract":{"type":"string","title":"Verifyingcontract","description":"Address of the Product Account","isRequired":true,"uniqueKey":"eip_712.oneOf.0.domain.verifyingContract","typeLabel":"string"}},"type":"object","required":["chainId","verifyingContract"],"title":"EIP712Domain","description":"EIP-712 domain separator","isRequired":true,"uniqueKey":"eip_712.oneOf.0.domain","typeLabel":"EIP712Domain · object"},"types":{"properties":{"EIP712Domain":{"items":{"properties":{"name":{"type":"string","title":"Name","isRequired":true,"uniqueKey":"eip_712.oneOf.0.types.EIP712Domain.items.[INDEX].name","typeLabel":"string"},"type":{"type":"string","title":"Type","isRequired":true,"uniqueKey":"eip_712.oneOf.0.types.EIP712Domain.items.[INDEX].type","typeLabel":"string"}},"type":"object","required":["name","type"],"title":"EIP712DomainField","description":"A field in the EIP712Domain type definition.","uniqueKey":"eip_712.oneOf.0.types.EIP712Domain.items.[INDEX]","typeLabel":"EIP712DomainField · object"},"type":"array","title":"Eip712Domain","description":"EIP712Domain type definition","isRequired":true,"uniqueKey":"eip_712.oneOf.0.types.EIP712Domain","typeLabel":"EIP712DomainField · object[]"},"SafeTx":{"items":{"properties":{"name":{"type":"string","title":"Name","isRequired":true,"uniqueKey":"eip_712.oneOf.0.types.SafeTx.items.[INDEX].name","typeLabel":"string"},"type":{"type":"string","title":"Type","isRequired":true,"uniqueKey":"eip_712.oneOf.0.types.SafeTx.items.[INDEX].type","typeLabel":"string"}},"type":"object","required":["name","type"],"title":"SafeTxField","description":"A field in the SafeTx type definition.","uniqueKey":"eip_712.oneOf.0.types.SafeTx.items.[INDEX]","typeLabel":"SafeTxField · object"},"type":"array","title":"Safetx","description":"SafeTx type definition","isRequired":true,"uniqueKey":"eip_712.oneOf.0.types.SafeTx","typeLabel":"SafeTxField · object[]"}},"type":"object","required":["EIP712Domain","SafeTx"],"title":"EIP712Types","description":"EIP-712 type definitions","isRequired":true,"uniqueKey":"eip_712.oneOf.0.types","typeLabel":"EIP712Types · object"},"primaryType":{"type":"string","const":"SafeTx","title":"Primarytype","description":"Primary type for the structured data","isRequired":true,"uniqueKey":"eip_712.oneOf.0.primaryType","typeLabel":"string"},"message":{"properties":{"to":{"type":"string","title":"To","description":"Destination address","isRequired":true,"uniqueKey":"eip_712.oneOf.0.message.to","typeLabel":"string"},"value":{"type":"string","title":"Value","description":"Value in wei as a string","isRequired":true,"uniqueKey":"eip_712.oneOf.0.message.value","typeLabel":"string"},"data":{"type":"string","title":"Data","description":"Transaction data as hex string","isRequired":true,"uniqueKey":"eip_712.oneOf.0.message.data","typeLabel":"string"},"operation":{"type":"integer","enum":[0,1],"title":"OperationType","description":"Operation type (0=Call, 1=DelegateCall)","isRequired":true,"uniqueKey":"eip_712.oneOf.0.message.operation","typeLabel":"enum\u003cinteger>"},"safeTxGas":{"type":"string","title":"Safetxgas","description":"Gas for the transaction","isRequired":true,"uniqueKey":"eip_712.oneOf.0.message.safeTxGas","typeLabel":"string"},"baseGas":{"type":"string","title":"Basegas","description":"Base gas costs","isRequired":true,"uniqueKey":"eip_712.oneOf.0.message.baseGas","typeLabel":"string"},"gasPrice":{"type":"string","title":"Gasprice","description":"Gas price","isRequired":true,"uniqueKey":"eip_712.oneOf.0.message.gasPrice","typeLabel":"string"},"gasToken":{"type":"string","title":"Gastoken","description":"Token address for gas payment","isRequired":true,"uniqueKey":"eip_712.oneOf.0.message.gasToken","typeLabel":"string"},"refundReceiver":{"type":"string","title":"Refundreceiver","description":"Address to receive gas refund","isRequired":true,"uniqueKey":"eip_712.oneOf.0.message.refundReceiver","typeLabel":"string"},"nonce":{"type":"string","title":"Nonce","description":"Transaction nonce","isRequired":true,"uniqueKey":"eip_712.oneOf.0.message.nonce","typeLabel":"string"}},"type":"object","required":["to","value","data","operation","safeTxGas","baseGas","gasPrice","gasToken","refundReceiver","nonce"],"title":"SafeTxMessage","description":"Safe transaction message data","isRequired":true,"uniqueKey":"eip_712.oneOf.0.message","typeLabel":"SafeTxMessage · object"}},"uniqueKey":"eip_712.oneOf.0","typeLabel":"BatchedSafeOperationsResponse · object"},{"type":"null","description":"EIP-712 typed data for gas-sponsored execution. Present when gas_sponsorship=true.","uniqueKey":"eip_712.oneOf.1","typeLabel":"null"}],"uniqueKey":"eip_712","typeLabel":"BatchedSafeOperationsResponse · object | null"}},"type":"object","required":["preview"],"title":"CreditRebalanceResponse","description":"The atomic rebalance transaction plus its guaranteed-floor preview.","uniqueKey":"","typeLabel":"CreditRebalanceResponse · object"},"examples":{"Example":{"title":"Example","value":{"preview":{"net_equity_moved_usd":"\u003cstring>","total_legs":123,"estimated_max_dust":"\u003cstring>","per_target":[{"protocol":"AAVE","collateral_token":"\u003cstring>","borrow_token":"\u003cstring>","direction":"open","legs":123,"resulting_collateral":"\u003cstring>","resulting_debt":"\u003cstring>","resulting_multiplier":"\u003cstring>","resulting_health_factor":"\u003cstring>","health_factor_scope":"market","estimated_max_dust":"\u003cstring>","market_id":"\u003cstring>","sub_account_id":123,"collateral_vault":"\u003cstring>","borrow_vault":"\u003cstring>","unloop_legs":[],"loop_legs":[]}],"routing_swaps":[],"aave_account_health_factor":"\u003cstring>"},"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"}]}}}}},"exampleType":"generated"}},"exampleType":"generated"},"ad847bf4-836f-48d1-9d39-9be847e4d5af":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"detail.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Location","isRequired":true,"uniqueKey":"detail.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Message","isRequired":true,"uniqueKey":"detail.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","title":"Error Type","isRequired":true,"uniqueKey":"detail.items.[INDEX].type","typeLabel":"string"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError","uniqueKey":"detail.items.[INDEX]","typeLabel":"ValidationError · object"},"type":"array","title":"Detail","uniqueKey":"detail","typeLabel":"ValidationError · object[]"}},"type":"object","title":"HTTPValidationError","uniqueKey":"","typeLabel":"HTTPValidationError · object"},"examples":{"Example":{"title":"Example","value":{"detail":[{"loc":["\u003cstring>"],"msg":"\u003cstring>","type":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"e89f6d8c-9ae7-44f6-91ab-c06b98b98bae":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"Your Compass API Key. Get your key [here](https://www.compasslabs.ai/dashboard).","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"5cc70962-0013-441d-bd6f-5cb484ceb892":{"url":"https://api.compasslabs.ai","description":"Production server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","description":"Your Compass API Key. Get your key [here](https://www.compasslabs.ai/dashboard).","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"x-api-key","type":"string","description":"Your Compass API Key. Get your key [here](https://www.compasslabs.ai/dashboard).","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"x-api-key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"v2/combined_spec.json"},"subdomain":"compasslabs-f07467e0","siteName":"Compass API Docs","title":"Rebalance the leveraged credit book - Compass API Docs","navMaps":{"firstHrefInVersion":{"V2":{"href":"/v2/api-reference/credit/rebalance-the-leveraged-credit-book","matchLevel":0},"V1":{"href":"/v1/api-reference/aave-v3/aave-supported-tokens","matchLevel":2}},"firstHrefInLanguage":{}},"lastModified":"2026-11-05T13:11:30.496Z","originalFileLocation":"v2/api-reference/credit/rebalance-the-leveraged-credit-book.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Move one or more leveraged positions to the state you want, in ONE atomic transaction. List the positions to change and the end state you want for each. The API works out whether that means opening, growing, shrinking, delevering or closing, and does them all together. Money freed by shrinking or closing one position pays for growing or opening another, so shifting funds between positions needs no new deposit. Any shortfall is taken from the Credit Account\u0026#x27;s idle balance, and the call returns 422 if that does not cover it either. See the Leveraged Looping guide for protocol and chain coverage, capital routing and the full error list.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Compass API Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/compasslabs-f07467e0/CejAEahS9T_GZmf_/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/compasslabs-f07467e0/CejAEahS9T_GZmf_/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/compasslabs-f07467e0/CejAEahS9T_GZmf_/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/compasslabs-f07467e0/CejAEahS9T_GZmf_/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/compasslabs-f07467e0/CejAEahS9T_GZmf_/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/compasslabs-f07467e0/CejAEahS9T_GZmf_/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/compasslabs-f07467e0/CejAEahS9T_GZmf_/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/compasslabs-f07467e0/CejAEahS9T_GZmf_/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/compasslabs-f07467e0/CejAEahS9T_GZmf_/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Rebalance the leveraged credit book - Compass API Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Move one or more leveraged positions to the state you want, in ONE atomic transaction. List the positions to change and the end state you want for each. The API works out whether that means opening, growing, shrinking, delevering or closing, and does them all together. Money freed by shrinking or closing one position pays for growing or opening another, so shifting funds between positions needs no new deposit. Any shortfall is taken from the Credit Account\u0026#x27;s idle balance, and the call returns 422 if that does not cover it either. See the Leveraged Looping guide for protocol and chain coverage, capital routing and the full error list.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Compass API Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.compasslabs.ai/v2/api-reference/credit/rebalance-the-leveraged-credit-book\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://compasslabs-f07467e0.mintlify.site/_mintlify/api/og/v2?division=Credit\u0026amp;title=Rebalance+the+leveraged+credit+book\u0026amp;description=Move+one+or+more+leveraged+positions+to+the+state+you+want%2C+in+ONE+atomic%0Atransaction.%0A%0AList+the+positions+to+change+and+the+end+state+you+want+for+each.+The+AP\u0026amp;theme=3dbf73b4b3dd364abd493b9c\u0026amp;signature=9f2b1451a29e8b35bcac8bed74f6a89b6f5be961fdc2b35aa9045c622ac1c01f\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Rebalance the leveraged credit book - Compass API Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Move one or more leveraged positions to the state you want, in ONE atomic transaction. List the positions to change and the end state you want for each. The API works out whether that means opening, growing, shrinking, delevering or closing, and does them all together. Money freed by shrinking or closing one position pays for growing or opening another, so shifting funds between positions needs no new deposit. Any shortfall is taken from the Credit Account\u0026#x27;s idle balance, and the call returns 422 if that does not cover it either. See the Leveraged Looping guide for protocol and chain coverage, capital routing and the full error list.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://compasslabs-f07467e0.mintlify.site/_mintlify/api/og/v2?division=Credit\u0026amp;title=Rebalance+the+leveraged+credit+book\u0026amp;description=Move+one+or+more+leveraged+positions+to+the+state+you+want%2C+in+ONE+atomic%0Atransaction.%0A%0AList+the+positions+to+change+and+the+end+state+you+want+for+each.+The+AP\u0026amp;theme=3dbf73b4b3dd364abd493b9c\u0026amp;signature=9f2b1451a29e8b35bcac8bed74f6a89b6f5be961fdc2b35aa9045c622ac1c01f\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/compasslabs-f07467e0/CejAEahS9T_GZmf_/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Compass API Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0284c7\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.compasslabs.ai/v2/api-reference/credit/rebalance-the-leveraged-credit-book\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/v2/api-reference/credit/rebalance-the-leveraged-credit-book.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.compasslabs.ai/#organization\",\"name\":\"Compass API Docs\",\"url\":\"https://docs.compasslabs.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/compasslabs-f07467e0/x2NrFgZ7soJbH6sc/logo/light.svg?fit=max\u0026auto=format\u0026n=x2NrFgZ7soJbH6sc\u0026q=85\u0026s=80a04b06674000990914306c6a833cb9\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.compasslabs.ai#website\",\"name\":\"Compass API Docs\",\"url\":\"https://docs.compasslabs.ai\",\"publisher\":{\"@id\":\"https://docs.compasslabs.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.compasslabs.ai/v2/api-reference/credit/rebalance-the-leveraged-credit-book#webpage\",\"url\":\"https://docs.compasslabs.ai/v2/api-reference/credit/rebalance-the-leveraged-credit-book\",\"name\":\"Rebalance the leveraged credit book\",\"description\":\"Move one or more leveraged positions to the state you want, in ONE atomic transaction. List the positions to change and the end state you want for each. The API works out whether that means opening, growing, shrinking, delevering or closing, and does them all together. Money freed by shrinking or closing one position pays for growing or opening another, so shifting funds between positions needs no new deposit. Any shortfall is taken from the Credit Account's idle balance, and the call returns 422 if that does not cover it either. See the Leveraged Looping guide for protocol and chain coverage, capital routing and the full error list.\",\"dateModified\":\"2026-11-05T13:11:30.496Z\",\"isPartOf\":{\"@id\":\"https://docs.compasslabs.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.compasslabs.ai/v2/api-reference/credit/rebalance-the-leveraged-credit-book#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.compasslabs.ai/v2/api-reference/credit/rebalance-the-leveraged-credit-book#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.compasslabs.ai/v2/api-reference/gas-sponsorship/prepare-gas-sponsored-transaction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Credit\",\"item\":\"https://docs.compasslabs.ai/v2/api-reference/credit/list-credit-positions\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Rebalance the leveraged credit book\",\"item\":\"https://docs.compasslabs.ai/v2/api-reference/credit/rebalance-the-leveraged-credit-book\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.compasslabs.ai/v2/api-reference/credit/rebalance-the-leveraged-credit-book#apireference\",\"headline\":\"Rebalance the leveraged credit book\",\"name\":\"Rebalance the leveraged credit book\",\"description\":\"Move one or more leveraged positions to the state you want, in ONE atomic transaction. List the positions to change and the end state you want for each. The API works out whether that means opening, growing, shrinking, delevering or closing, and does them all together. Money freed by shrinking or closing one position pays for growing or opening another, so shifting funds between positions needs no new deposit. Any shortfall is taken from the Credit Account's idle balance, and the call returns 422 if that does not cover it either. See the Leveraged Looping guide for protocol and chain coverage, capital routing and the full error list.\",\"url\":\"https://docs.compasslabs.ai/v2/api-reference/credit/rebalance-the-leveraged-credit-book\",\"mainEntityOfPage\":{\"@id\":\"https://docs.compasslabs.ai/v2/api-reference/credit/rebalance-the-leveraged-credit-book#webpage\"},\"dateModified\":\"2026-11-05T13:11:30.496Z\",\"publisher\":{\"@id\":\"https://docs.compasslabs.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.compasslabs.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Compass API Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Compass API Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/v2/api-reference/credit/rebalance-the-leveraged-credit-book.md","siteName":"Compass API Docs","nav":{"global":{"tabs":[],"anchors":[]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/v2/get_started/overview"}]},{"tab":"API Reference","versions":[{"version":"V2","groups":[{"group":"API Reference","pages":[{"group":"Gas Sponsorship","pages":[{"title":"Prepare gas-sponsored transaction","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json post /v2/gas_sponsorship/prepare","href":"/v2/api-reference/gas-sponsorship/prepare-gas-sponsored-transaction"},{"title":"Approve token transfer","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json post /v2/gas_sponsorship/approve_transfer","href":"/v2/api-reference/gas-sponsorship/approve-token-transfer"}]},{"group":"Earn","pages":[{"title":"List earn positions","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json get /v2/earn/positions","href":"/v2/api-reference/earn/list-earn-positions"},{"title":"List earn positions across all chains","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json get /v2/earn/positions_all","href":"/v2/api-reference/earn/list-earn-positions-across-all-chains"},{"title":"List vaults","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json get /v2/earn/vaults","href":"/v2/api-reference/earn/list-vaults"},{"title":"List aave markets","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json get /v2/earn/aave_markets","href":"/v2/api-reference/earn/list-aave-markets"},{"title":"List pendle markets","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json get /v2/earn/pendle_markets","href":"/v2/api-reference/earn/list-pendle-markets"},{"title":"List maple pools","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json get /v2/earn/maple_pools","href":"/v2/api-reference/earn/list-maple-pools"},{"title":"Quote a swap","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json get /v2/earn/swap_quote","href":"/v2/api-reference/earn/quote-a-swap"},{"title":"Get token balances","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json get /v2/earn/balances","href":"/v2/api-reference/earn/get-token-balances"},{"title":"Create earn account","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json post /v2/earn/create_account","href":"/v2/api-reference/earn/create-earn-account"},{"title":"Transfer tokens to/from account","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json post /v2/earn/transfer","href":"/v2/api-reference/earn/transfer-tokens-tofrom-account"},{"title":"Manage earn position","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json post /v2/earn/manage","href":"/v2/api-reference/earn/manage-earn-position"},{"title":"Swap tokens","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json post /v2/earn/swap","href":"/v2/api-reference/earn/swap-tokens"},{"title":"Execute multiple earn actions","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json post /v2/earn/bundle","href":"/v2/api-reference/earn/execute-multiple-earn-actions"}]},{"group":"Bridge","pages":[{"title":"Initiate USDC bridging","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json post /v2/cctp/burn","href":"/v2/api-reference/bridge/initiate-usdc-bridging"},{"title":"Complete USDC bridging","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json post /v2/cctp/mint","href":"/v2/api-reference/bridge/complete-usdc-bridging"}]},{"group":"Credit","pages":[{"title":"List credit positions","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json get /v2/credit/positions","href":"/v2/api-reference/credit/list-credit-positions"},{"title":"Get credit account token balances","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json get /v2/credit/balances","href":"/v2/api-reference/credit/get-credit-account-token-balances"},{"title":"List looped (leveraged) credit positions","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json get /v2/credit/looped_positions","href":"/v2/api-reference/credit/list-looped-leveraged-credit-positions"},{"title":"List Euler markets","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json get /v2/credit/euler_markets","href":"/v2/api-reference/credit/list-euler-markets"},{"title":"List Morpho markets","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json get /v2/credit/morpho_markets","href":"/v2/api-reference/credit/list-morpho-markets"},{"title":"List Aave markets","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json get /v2/credit/aave_markets","href":"/v2/api-reference/credit/list-aave-markets"},{"title":"Create credit account","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json post /v2/credit/create_account","href":"/v2/api-reference/credit/create-credit-account"},{"title":"Borrow against collateral","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json post /v2/credit/borrow","href":"/v2/api-reference/credit/borrow-against-collateral"},{"title":"Open a leveraged loop","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json post /v2/credit/loop","href":"/v2/api-reference/credit/open-a-leveraged-loop"},{"title":"Unwind a leveraged loop","description":"Unwind a leveraged position in ONE atomic transaction.\n\nWithdraw collateral, swap it back to the borrow token, repay, repeat — until\nthe position reaches target_multiplier, or until the debt is cleared exactly\nif you omit it. If any step fails the whole transaction reverts.\n\nSee the [Leveraged Looping guide](https://docs.compasslabs.ai/v2/Products/Looping)\nfor chain coverage, vault-share collateral, shared Aave reserves and the full\nerror list.","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json post /v2/credit/unloop","href":"/v2/api-reference/credit/unwind-a-leveraged-loop"},{"title":"Rebalance the leveraged credit book","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json post /v2/credit/rebalance","href":"/v2/api-reference/credit/rebalance-the-leveraged-credit-book"},{"title":"Transfer tokens to/from Credit Account","description":"Transfer tokens between the owner's EOA and their Credit Account.\n\n**DEPOSIT** (EOA → Credit Account):\n- With `gas_sponsorship=true`: returns Permit2 EIP-712 typed data to sign. The gas sponsor\n calls `permitTransferFrom` to pull tokens (1 signature).\n- With `gas_sponsorship=false`: returns an unsigned ERC-20 transfer transaction.\n\n**WITHDRAW** (Credit Account → EOA):\n- With `gas_sponsorship=true`: returns SafeTx EIP-712 typed data to sign. The gas sponsor\n broadcasts the `execTransaction` (1 signature).\n- With `gas_sponsorship=false`: returns an unsigned `execTransaction`.","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json post /v2/credit/transfer","href":"/v2/api-reference/credit/transfer-tokens-tofrom-credit-account"},{"title":"Swap tokens","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json post /v2/credit/swap","href":"/v2/api-reference/credit/swap-tokens"},{"title":"Repay debt and withdraw collateral","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json post /v2/credit/repay","href":"/v2/api-reference/credit/repay-debt-and-withdraw-collateral"},{"title":"Execute multiple credit actions","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json post /v2/credit/bundle","href":"/v2/api-reference/credit/execute-multiple-credit-actions"}]},{"group":"Perpetual Trading","pages":[{"title":"List perpetual trading markets","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json get /v2/perpetual_trading/opportunities","href":"/v2/api-reference/perpetual-trading/list-perpetual-trading-markets"},{"title":"List perpetual trading positions","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json get /v2/perpetual_trading/positions","href":"/v2/api-reference/perpetual-trading/list-perpetual-trading-positions"},{"title":"Get OHLCV candles","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json get /v2/perpetual_trading/candles","href":"/v2/api-reference/perpetual-trading/get-ohlcv-candles"},{"title":"Aggregated Hyperliquid activity for a user","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json get /v2/perpetual_trading/activity","href":"/v2/api-reference/perpetual-trading/aggregated-hyperliquid-activity-for-a-user"},{"title":"Deposit USDC to perpetual trading account","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json post /v2/perpetual_trading/deposit","href":"/v2/api-reference/perpetual-trading/deposit-usdc-to-perpetual-trading-account"},{"title":"Build the Bridge2 deposit tx from a signed permit","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json post /v2/perpetual_trading/deposit/sponsor_prepare","href":"/v2/api-reference/perpetual-trading/build-the-bridge2-deposit-tx-from-a-signed-permit"},{"title":"Withdraw USDC from perpetual trading account","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json post /v2/perpetual_trading/withdraw","href":"/v2/api-reference/perpetual-trading/withdraw-usdc-from-perpetual-trading-account"},{"title":"Place market order","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json post /v2/perpetual_trading/market_order","href":"/v2/api-reference/perpetual-trading/place-market-order"},{"title":"Place limit order","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json post /v2/perpetual_trading/limit_order","href":"/v2/api-reference/perpetual-trading/place-limit-order"},{"title":"Cancel order","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json post /v2/perpetual_trading/cancel_order","href":"/v2/api-reference/perpetual-trading/cancel-order"},{"title":"Execute signed action","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json post /v2/perpetual_trading/execute","href":"/v2/api-reference/perpetual-trading/execute-signed-action"},{"title":"Approve builder fee","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json post /v2/perpetual_trading/approve_builder_fee","href":"/v2/api-reference/perpetual-trading/approve-builder-fee"},{"title":"Enable unified account mode","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json post /v2/perpetual_trading/enable_unified_account","href":"/v2/api-reference/perpetual-trading/enable-unified-account-mode"},{"title":"Ensure 1x cross leverage","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json post /v2/perpetual_trading/ensure_leverage","href":"/v2/api-reference/perpetual-trading/ensure-1x-cross-leverage"},{"title":"Set leverage (defaults to market maximum)","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json post /v2/perpetual_trading/set_leverage","href":"/v2/api-reference/perpetual-trading/set-leverage-defaults-to-market-maximum"}]},{"group":"Tokenized Assets","pages":[{"title":"List markets","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json get /v2/tokenized_assets/markets","href":"/v2/api-reference/tokenized-assets/list-markets"},{"title":"Get a market","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json get /v2/tokenized_assets/markets/{symbol}","href":"/v2/api-reference/tokenized-assets/get-a-market"},{"title":"List positions","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json get /v2/tokenized_assets/positions","href":"/v2/api-reference/tokenized-assets/list-positions"},{"title":"Get token balances","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json get /v2/tokenized_assets/balances","href":"/v2/api-reference/tokenized-assets/get-token-balances"},{"title":"Get order status","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json get /v2/tokenized_assets/order/{order_hash}","href":"/v2/api-reference/tokenized-assets/get-order-status"},{"title":"List redemption requests","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json get /v2/tokenized_assets/redemptions","href":"/v2/api-reference/tokenized-assets/list-redemption-requests"},{"title":"Create account","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json post /v2/tokenized_assets/create_account","href":"/v2/api-reference/tokenized-assets/create-account"},{"title":"Transfer tokens to/from account","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json post /v2/tokenized_assets/transfer","href":"/v2/api-reference/tokenized-assets/transfer-tokens-tofrom-account"},{"title":"Quote an order","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json post /v2/tokenized_assets/quote","href":"/v2/api-reference/tokenized-assets/quote-an-order"},{"title":"Build an order","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json post /v2/tokenized_assets/order","href":"/v2/api-reference/tokenized-assets/build-an-order"},{"title":"Submit a signed order","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json post /v2/tokenized_assets/order/submit","href":"/v2/api-reference/tokenized-assets/submit-a-signed-order"},{"title":"Cancel an order","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json post /v2/tokenized_assets/order/{order_hash}/cancel","href":"/v2/api-reference/tokenized-assets/cancel-an-order"},{"title":"Charge a partner fee","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json post /v2/tokenized_assets/order/{order_hash}/charge_fee","href":"/v2/api-reference/tokenized-assets/charge-a-partner-fee"},{"title":"Buy an RWA yield token","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json post /v2/tokenized_assets/transact/buy","href":"/v2/api-reference/tokenized-assets/buy-an-rwa-yield-token"},{"title":"Sell an RWA yield token","deprecated":null,"version":null,"openapi":"/v2/combined_spec.json post /v2/tokenized_assets/transact/sell","href":"/v2/api-reference/tokenized-assets/sell-an-rwa-yield-token"}]}]}]},{"version":"V1","pages":[{"title":"V1","href":"/v1/api-reference/aave-v3/aave-supported-tokens"}]}]}]},"basePath":"","title":"Rebalance the leveraged credit book - Compass API Docs","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}