---
updatedAt: 2026-09-30T03:41:03.000Z
agentTools:
  projectIndex: https://cn.developers.tron.network/llms.txt
---

# WithdrawExpireUnfreeze

提取所有已经到期的 Stake 2.0 解质押资金——一次性回到账户余额。

> 📘 **多笔解质押合并提取**
>
> Stake 2.0 支持账户同时持有多个进行中的解质押单（最多 32 个）。本接口**一次性提取所有已到期**的解质押资金，不需要为每笔单独调用。等待期由链参数 `#70 getUnfreezeDelayDays` 控制（当前主网为 14 天）。

***

## 相关资源

* [UnfreezeBalanceV2](https://cn.developers.tron.network/reference/unfreezebalancev2-1) —— 发起解质押并进入等待期
* [GetCanWithdrawUnfreezeAmount](https://cn.developers.tron.network/reference/getcanwithdrawunfreezeamount-1) —— 调用前预查可提取金额
* [CancelAllUnfreezeV2](https://cn.developers.tron.network/reference/cancelallunfreezev2) —— 取消尚未到期的解质押
* [解质押](https://cn.developers.tron.network/docs/unstaking) —— 等待期与提取机制

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "全节点 HTTP API",
    "version": "4.8.0"
  },
  "servers": [
    {
      "url": "https://api.shasta.trongrid.io",
      "description": "Shasta 测试网"
    },
    {
      "url": "https://nile.trongrid.io",
      "description": "Nile 测试网"
    },
    {
      "url": "https://api.trongrid.io",
      "description": "TRON 主网（真实资产）"
    }
  ],
  "components": {
    "schemas": {
      "NodeHttpBusinessError": {
        "title": "错误信息",
        "type": "object",
        "description": "请求处理发生异常时，java-tron 可能随 HTTP 200 返回此格式；具体错误信息位于 `Error` 字段。",
        "required": [
          "Error"
        ],
        "properties": {
          "Error": {
            "type": "string",
            "description": "java-tron 返回的错误信息。"
          }
        },
        "examples": [
          {
            "Error": "Invalid request parameters."
          }
        ],
        "additionalProperties": false
      }
    }
  },
  "security": [
    {}
  ],
  "paths": {
    "/wallet/withdrawexpireunfreeze": {
      "post": {
        "summary": "WithdrawExpireUnfreeze",
        "description": "在 Stake 2.0 中提取已解质押的余额。用户在执行 /wallet/unfreezebalancev2 交易并等待 N 天后，可调用此 API 取回资金，N 为网络参数。",
        "operationId": "withdrawexpireunfreeze",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "owner_address": {
                    "type": "string",
                    "description": "交易发起方地址。（格式：Base58 或 Hex）",
                    "default": ""
                  },
                  "visible": {
                    "type": "boolean",
                    "description": "可选。设置为 `true` 时地址以 Base58 格式返回；设置为 `false` 时以 hex 格式返回。（默认：`false`）",
                    "default": "false"
                  },
                  "Permission_id": {
                    "type": "integer",
                    "description": "可选。用于多签账户操作的权限 ID。未指定时默认使用 owner 权限（0）。",
                    "format": "int32"
                  }
                },
                "required": [
                  "owner_address"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "请求正常完成时，响应体为接口返回结果；请求处理发生异常时，HTTP 状态仍可能为 200，此时仅返回包含 `Error` 字段的错误信息。",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "title": "返回结果",
                      "not": {
                        "type": "object",
                        "required": [
                          "Error"
                        ]
                      },
                      "type": "object",
                      "properties": {
                        "owner_address": {
                          "type": "string",
                          "description": "交易发起方地址。（格式：Base58 或 Hex）"
                        }
                      }
                    },
                    {
                      "$ref": "#/components/schemas/NodeHttpBusinessError"
                    }
                  ]
                },
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "deprecated": false,
        "security": []
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```