Build Morpho Blue withdrawal calls
Builds and simulates wallet calls for withdrawing an exact loan-asset amount, burning an exact number of supply shares, or withdrawing the maximum available amount from a Morpho Blue market.
When the market lacks liquidity, the withdrawal may pull liquidity from other markets through Morpho shared liquidity. all burns the full share balance when the market alone can cover the position, including interest that accrues before execution. Otherwise it withdraws an assets amount, which can leave a small residual. If the market and shared liquidity together cannot cover the position, it withdraws only the available amount and leaves the rest supplied. Any signature_mode other than none requests Morpho authorization typed data instead of an authorization call when available.
Authorization
ApiKeyAuth Send your Morpho-issued key on every action request. JWKS needs no key on every host; public documentation needs no key.
In: header
Path Parameters
Morpho Blue market selector formatted as <chain_id>:<market_id>. The chain ID is at most 9007199254740991.
^(?:[1-9][0-9]{0,14}|[1-8][0-9]{15}|900[0-6][0-9]{12}|90070[0-9]{11}|90071[0-8][0-9]{10}|900719[0-8][0-9]{9}|9007199[0-1][0-9]{8}|90071992[0-4][0-9]{7}|900719925[0-3][0-9]{6}|9007199254[0-6][0-9]{5}|90071992547[0-3][0-9]{4}|9007199254740[0-8][0-9]{2}|90071992547409[0-8][0-9]{1}|9007199254740990|9007199254740991):0x[0-9a-fA-F]{64}$Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v0/actions/blue/markets/{market-selector}/withdraw" \ -H "Content-Type: application/json" \ -d '{ "account": "0x545b6Cc751F0C47C202694cf835db2E3C071400A", "amount": { "unit": "assets", "value": "1000000" } }'{ "data": { "action_id": "act_0123456789abcdef0123456789abcdef", "status": "prepared", "action": "blue.withdraw", "chain_id": 8453, "account": "0x545b6Cc751F0C47C202694cf835db2E3C071400A", "expires_at": 4000000000, "market": { "id": "0x9103c3b4e834476c9a62ea009ba2c884ee42e94e6e314a26f04d312434191836", "loan_asset": { "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913" } }, "amount": { "unit": "assets", "value": "1000000" }, "calls": [ { "id": "call_0", "kind": "blue_withdraw", "to": "0x4D28D900e381eCE4B351302f1Abe588496793A2b", "data": "0xc0229fe8000000000000000000000000833589fcd6edb6e08f4c7c32d4f71b54bda02913000000000000000000000000cbb7c0000ab88b473b1f5afd9ef808440eed33bf000000000000000000000000663becd10dae6c4a3dcd89f1d76c1174199639b900000000000000000000000046415998764c29ab2a25cbea6254146d50d226870000000000000000000000000000000000000000000000000bef55718ad6000000000000000000000000000000000000000000000000000000000000000f424000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ee6b28000000000000000000000000000000000000000000000000000000000000000000", "value": "0" } ], "simulation": { "status": "success", "block": { "number": "21000000", "timestamp": 1760000000 }, "wallet_changes": [ { "asset": { "type": "erc20", "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913" }, "difference": "1000000" } ], "position_changes": { "supply_shares": "-900000", "borrow_shares": "0", "collateral_assets": "0" }, "effects": { "gross_assets": "1000000", "referral_fee_assets": "0", "net_assets": "1000000" } }, "resolved_amount": { "unit": "assets", "value": "1000000" } }}The amount must be a positive decimal string that fits uint256.
{ "error": { "code": "VALIDATION_FAILED", "message": "Validation failed", "details": [ { "code": "invalid_format", "message": "Expected a positive decimal string", "path": [ "amount", "value" ] }, { "code": "custom", "message": "Expected an amount that fits in uint256", "path": [ "amount", "value" ] } ], "request_id": "req_0123456789abcdef" }}The selected Morpho Blue market was not found on this chain.
{ "error": { "code": "MARKET_NOT_FOUND", "message": "The Morpho Blue market does not exist on this chain.", "details": null, "request_id": "req_0123456789abcdef" }}Request bodies must not exceed 16384 bytes.
{ "error": { "code": "PAYLOAD_TOO_LARGE", "message": "Request body too large.", "details": [ { "code": "too_big", "message": "Request body exceeds the 16384-byte limit", "path": [ "body" ] } ], "request_id": "req_0123456789abcdef" }}Restart the same action without the continuation, sign the newly returned typed data, then finalize with the new continuation.
{ "error": { "code": "SIGNATURE_REFRESH_REQUIRED", "message": "The prepared signature nonce or deadline is no longer usable.", "details": null, "request_id": "req_0123456789abcdef" }}{ "error": { "code": "INTERNAL_ERROR", "message": "string", "details": [ { "code": "string", "message": "string", "path": [ "string" ], "rule": "string", "details": { "min_assets": "string", "loan_token": "string" } } ], "request_id": "string" }}Chain state is temporarily unavailable; retry.
{ "error": { "code": "STATE_UNAVAILABLE", "message": "Chain state is temporarily unavailable.", "details": null, "request_id": "req_0123456789abcdef" }}POSTBuild Morpho Blue supply calls
Builds and simulates wallet calls for supplying an exact gross loan-asset amount to an existing market on the registered Morpho Blue deployment.
POSTBuild Vault V2 deposit calls
Builds the ordered wallet calls for a deposit into an approved Morpho Vault V2 vault and simulates them. Amounts use the vault asset's base units.