创建提币订单 (v1)¶
现有更新的 v2 接口,推荐使用。该接口采用异步方式处理订单,可避免 v1 中可能出现的请求超时问题。
如果管理员在业务线上启用了 API 提单网页审核,则任何超过所设定的 单笔订单审核门槛(USD) 的提现请求都需要进行审核。订单只有在完成所有必需的审核流程后才会被处理。具有审核人员权限的用户可以通过网页端或使用 审核订单API 来完成审核。
请求¶
参数¶
路径参数¶
| 字段 | 类型 | 描述 |
|---|---|---|
b_id |
String | 业务线ID |
请求体参数¶
| 字段 | 类型 | 描述 |
|---|---|---|
| from_wallet_code 必填 | String | 来源钱包ID |
| coin_name 必填 | String | 币种名称 允许值:参考 支持的代币 中的 Coin Name (API) 列 |
| order_no 必填 | String | 订单号 (最多50个字符)。用于确保幂等性。 |
| from_address | String | 提币交易的来源地址。 必填情况:(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 |