curl --request POST \
--url https://api.qbank.cl/platform/v1/crypto/withdrawals \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"chain": "tron",
"to_address": "TVJ6njG5Fyrq6XwYok3xPQx8kR7HQx6vXk",
"amount": "100.000000",
"idempotency_key": "withdrawal-2026-07-07-a"
}
'
{
"withdrawal_id": "6c5d4e3f-2a1b-0c9d-8e7f-6a5b4c3d2e1f",
"account_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
"idempotency_key": "withdrawal-2026-07-07-a",
"chain": "tron",
"asset": "USDT",
"to_address": "TVJ6njG5Fyrq6XwYok3xPQx8kR7HQx6vXk",
"amount": "100.000000",
"fee": "1.000000",
"total_debit": "101.000000",
"status": "processing",
"status_code": "",
"status_message": "broadcasted",
"tx_id": "b1946ac92492d2347c6235b4d2611184e0f0f8c9d3a1e2b3c4d5e6f708192a3b",
"created_at": "2026-07-07T12:00:00Z",
"updated_at": "2026-07-07T12:00:00Z",
"idempotency_hit": true
}{
"withdrawal_id": "6c5d4e3f-2a1b-0c9d-8e7f-6a5b4c3d2e1f",
"account_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
"idempotency_key": "withdrawal-2026-07-07-a",
"chain": "tron",
"asset": "USDT",
"to_address": "TVJ6njG5Fyrq6XwYok3xPQx8kR7HQx6vXk",
"amount": "100.000000",
"fee": "1.000000",
"total_debit": "101.000000",
"status": "processing",
"status_code": "",
"status_message": "broadcasted",
"tx_id": "b1946ac92492d2347c6235b4d2611184e0f0f8c9d3a1e2b3c4d5e6f708192a3b",
"created_at": "2026-07-07T12:00:00Z",
"updated_at": "2026-07-07T12:00:00Z"
}{
"error": "invalid_json",
"message": "request body is not valid JSON: unknown field"
}{
"error": "unauthorized",
"message": "invalid or missing credentials"
}{
"error": "insufficient_funds",
"message": "account balance is not enough for this operation"
}{
"withdrawal_id": "6c5d4e3f-2a1b-0c9d-8e7f-6a5b4c3d2e1f",
"account_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
"idempotency_key": "withdrawal-2026-07-07-a",
"chain": "tron",
"asset": "USDT",
"to_address": "TVJ6njG5Fyrq6XwYok3xPQx8kR7HQx6vXk",
"amount": "100.000000",
"fee": "1.000000",
"total_debit": "101.000000",
"status": "failed",
"status_code": "core_rejected",
"status_message": "destination address is invalid",
"tx_id": "",
"created_at": "2026-07-07T12:00:00Z",
"updated_at": "2026-07-07T12:00:00Z"
}{
"error": "withdrawals_unavailable",
"message": "on-chain withdrawals are not enabled for this corridor yet"
}创建链上提现
从其自身余额链上发送 USDT、USDC 或 BTC。支持的组合:tron/USDT、eth/USDT、eth/USDC、btc/BTC(GOLD 无链上通道)。amount + 提现费 原子扣除并冻结;最终状态通过 crypto_withdrawal_status_changed webhook 送达。failed 会全额退款。
POST
/
v1
/
crypto
/
withdrawals
curl --request POST \
--url https://api.qbank.cl/platform/v1/crypto/withdrawals \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"chain": "tron",
"to_address": "TVJ6njG5Fyrq6XwYok3xPQx8kR7HQx6vXk",
"amount": "100.000000",
"idempotency_key": "withdrawal-2026-07-07-a"
}
'
{
"withdrawal_id": "6c5d4e3f-2a1b-0c9d-8e7f-6a5b4c3d2e1f",
"account_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
"idempotency_key": "withdrawal-2026-07-07-a",
"chain": "tron",
"asset": "USDT",
"to_address": "TVJ6njG5Fyrq6XwYok3xPQx8kR7HQx6vXk",
"amount": "100.000000",
"fee": "1.000000",
"total_debit": "101.000000",
"status": "processing",
"status_code": "",
"status_message": "broadcasted",
"tx_id": "b1946ac92492d2347c6235b4d2611184e0f0f8c9d3a1e2b3c4d5e6f708192a3b",
"created_at": "2026-07-07T12:00:00Z",
"updated_at": "2026-07-07T12:00:00Z",
"idempotency_hit": true
}{
"withdrawal_id": "6c5d4e3f-2a1b-0c9d-8e7f-6a5b4c3d2e1f",
"account_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
"idempotency_key": "withdrawal-2026-07-07-a",
"chain": "tron",
"asset": "USDT",
"to_address": "TVJ6njG5Fyrq6XwYok3xPQx8kR7HQx6vXk",
"amount": "100.000000",
"fee": "1.000000",
"total_debit": "101.000000",
"status": "processing",
"status_code": "",
"status_message": "broadcasted",
"tx_id": "b1946ac92492d2347c6235b4d2611184e0f0f8c9d3a1e2b3c4d5e6f708192a3b",
"created_at": "2026-07-07T12:00:00Z",
"updated_at": "2026-07-07T12:00:00Z"
}{
"error": "invalid_json",
"message": "request body is not valid JSON: unknown field"
}{
"error": "unauthorized",
"message": "invalid or missing credentials"
}{
"error": "insufficient_funds",
"message": "account balance is not enough for this operation"
}{
"withdrawal_id": "6c5d4e3f-2a1b-0c9d-8e7f-6a5b4c3d2e1f",
"account_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
"idempotency_key": "withdrawal-2026-07-07-a",
"chain": "tron",
"asset": "USDT",
"to_address": "TVJ6njG5Fyrq6XwYok3xPQx8kR7HQx6vXk",
"amount": "100.000000",
"fee": "1.000000",
"total_debit": "101.000000",
"status": "failed",
"status_code": "core_rejected",
"status_message": "destination address is invalid",
"tx_id": "",
"created_at": "2026-07-07T12:00:00Z",
"updated_at": "2026-07-07T12:00:00Z"
}{
"error": "withdrawals_unavailable",
"message": "on-chain withdrawals are not enabled for this corridor yet"
}授权
会话 JWT(来自注册/登录)或 API key(pk_...)。
也接受 X-API-Key: <token> 作为替代请求头。
请求头
idempotency_key 请求体字段的替代方式。
请求体
application/json
正数十进制字符串,最多 6 位小数(BTC 为 8 位)。
可用选项:
tron, eth, btc 要发送的资产(USDC 仅支持 eth;在 btc 上资产默认为 BTC)。
可用选项:
USDT, USDC, BTC 使用联系人为该链保存的地址代替 to_address(显式 to_address 始终优先)。
为保存此地址的自动联系人指定名称。
地址会自动保存为联系人;传 false 可跳过。
Travel Rule(FATF R.16)— 超过组织阈值且转往其他机构时,收款机构的 travel address(ta… 代码)。付款地址由收款机构提供,因此可省略 to_address。
Travel Rule — 目的地为账户持有人自己的钱包时声明 self_hosted(需要 beneficiary_name)。
可用选项:
self_hosted Travel Rule — 目的持有人的姓名。超过阈值时必填(配合 travel_address 或 wallet_type=self_hosted)。
响应
幂等重放。
可用选项:
tron, eth, btc 示例:
"USDT"
可用选项:
pending, processing, completed, failed 提现按 Travel Rule(FATF R.16)政策评估时返回。
可用选项:
not_required, self_hosted_attested, approved 声明的受益人姓名(Travel Rule 提现)。