Docs

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.


POST
/v0/actions/blue/markets/{market-selector}/withdraw

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
x-api-key<token>

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

market-selector*string

Morpho Blue market selector formatted as <chain_id>:<market_id>. The chain ID is at most 9007199254740991.

Match^(?:[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"  }}

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