跳转至

创建提币订单 (v2)

V2 是创建提币订单的推荐接口。 该接口采用异步方式处理订单,可避免 V1 中可能出现的请求超时问题。

请求参数与创建提币订单(v1) 接口完全相同。

如果管理员在业务线上启用了 API 提单网页审核,则任何超过所设定的 单笔订单审核门槛(USD) 的提现请求都需要进行审核。订单只有在完成所有必需的审核流程后才会被处理。具有审核人员权限的用户可以通过网页端或使用 审核订单API 来完成审核。

请求

POST https://api.mycactus.dev/custody/v2/api/projects/{b_id}/order/create
POST https://api.mycactus.com/custody/v2/api/projects/{b_id}/order/create

参数

路径参数

字段 类型 描述

b_id
必填

String 业务线ID

请求体参数

字段类型描述
from_wallet_code
必填
String来源钱包ID
coin_name
必填
String币种名称
允许值:参考 支持的代币 中的 Coin Name (API) 列
order_no
必填
String订单号 (最多50个字符)。用于确保幂等性。
from_addressString提币交易的来源地址。
必填情况:(1) 从 DeFi 钱包提币时,或 (2) 从隔离钱包中指定地址提币时。
可选情况:执行钱包级别提币时(仅适用于地址隔离钱包)
description
可选
String订单描述 (最多50个字符)
fee_rate_level
可选
String用于BTC/ETH系列
允许值:NORMAL, HIGHER, LOW, CUSTOM
fee_rate
可选
Decimal对于 BTC/ETH 系列,当使用 CUSTOM 费率类型时,需要传入具体的 fee_rate_level 参数。其可用范围可通过 查询提币费率范围获取。对于 EIP1559 系列,该参数等同于 MaxFeeRate。
contract_transfer
可选
Boolean启用智能合约批量转账
允许值:false, true
contract_aggre
可选
Boolean启用智能合约批量归集
允许值:false, true
resource_rental
可选
Boolean尝试在TRON网络上租用能量。如果能量租用失败,系统将自动使用TRX完成交易
force_rental
可选
Boolean尝试在TRON网络上租用能量;如果不成功,订单失败
dest_address_item_list
必填
Object[]目标地址列表详情

dest_address_item_list (对象)

字段类型描述
dest_address
必填
String目标地址
amount
必填
Decimal提币金额。请输入不带小数位的整数(例如 49500000,而非 49500000.00000000)。该数值以币种的最小单位表示;请参考支持的代币列表中的 Decimals 列,或 查询币种信息 接口返回的 decimals 字段。

如果 is_all_withdrawal 设为 true,则无需填写。
is_all_withdrawal
必填
Boolean订单是否为全额余额提币
允许值:false, true
memo_type
可选
String备注类型。仅适用于 Stellar 链。
允许值:MEMO_NONE、MEMO_TEXT、MEMO_HASH
memo
可选
String备注或目标标签。附加在交易上的额外标识符。以下链支持 memo(选填):STELLAR、RIPPLE、TON、VAULTA、COSMOS、KAVA、MANTRA、BABYLON、DYDX。
remark
可选
String备注 (最多50个字符)

登录Cactus后,点击这里查看智能合约转账和智能合约归集的详细信息。

资金可能因其他原因被冻结,例如KYT或合规要求。因此,在发起提币时,始终使用 可用余额 (available_amount) 而不是总余额非常重要。

请求体示例

{
  "from_address": "mioNv7xz1es2waP77gLQYypXesBbkT8BeX",
  "from_wallet_code": "CHBTC4813422686",
  "coin_name": "ETH",
  "order_no": "TX00012345",
  "description": "test order create",
  "dest_address_item_list": [
    {
      "amount": 65000,
      "dest_address": "mioNv7xz1es2waP77gLQYypXesBbkT8BeX",
      "memo_type": "MEMO_TEXT",
      "memo": "text",
      "is_all_withdrawal": false,
      "remark": "test order item"
    }
  ]
}

响应

响应体

字段 类型 描述
code Integer 响应代码(0 = 成功)
message String 响应消息
successful Boolean 请求是否成功
data Object 显示提币订单号(详见下方 data 对象详情)

data (对象)

字段 类型 描述
OrderNo String 订单ID

响应示例

{
  "code": 0,
  "message": "",
  "successful": true,
  "data": {
    "OrderNo": "555222000000001"
  }
}