curl --request POST \
--url https://api.qbank.cl/platform/v1/swaps \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"from_asset": "USDT",
"to_asset": "BTC",
"amount": "1000",
"idempotency_key": "swap-2026-07-10-a"
}
'
{
"swap_id": "8a1b2c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d",
"account_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
"from_asset": "USDT",
"to_asset": "BTC",
"from_amount": "1000.000000",
"to_amount": "0.01568419",
"rate": "0.00001568",
"status": "completed",
"idempotency_key": "swap-2026-07-10-a",
"created_at": "2026-07-10T15:00:00Z",
"idempotency_hit": true
}
创建 swap
在你的两种货币之间同步、原子地兑换余额——余额即时变动,资金从不离开你的账户(无需 OTP)。波动性交易对(BTC/GOLD/SILVER/PLATINUM)与 payouts 和卡片消费共享单笔及 24 小时交易量限额。必须提供幂等键:重放会返回原始 swap,绝不重复执行。
POST
/
v1
/
swaps
curl --request POST \
--url https://api.qbank.cl/platform/v1/swaps \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"from_asset": "USDT",
"to_asset": "BTC",
"amount": "1000",
"idempotency_key": "swap-2026-07-10-a"
}
'
{
"swap_id": "8a1b2c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d",
"account_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
"from_asset": "USDT",
"to_asset": "BTC",
"from_amount": "1000.000000",
"to_amount": "0.01568419",
"rate": "0.00001568",
"status": "completed",
"idempotency_key": "swap-2026-07-10-a",
"created_at": "2026-07-10T15:00:00Z",
"idempotency_hit": true
}
授权
会话 JWT(来自注册/登录)或 API key(pk_...)。
也接受 X-API-Key: <token> 作为替代请求头。
请求头
idempotency_key 请求体字段的替代方式。
请求体
application/json
可用选项:
USD, USDT, USDC, BTC, GOLD, SILVER, PLATINUM 可用选项:
USD, USDT, USDC, BTC, GOLD, SILVER, PLATINUM 源货币金额(USDT/USDC/GOLD/SILVER/PLATINUM 为 6 位小数,BTC 为 8 位)。
客户端选择的键。前缀 payin-convert: 和 checkout-swap: 保留给系统自动转换使用，会被拒绝并返回 400 reserved_idempotency_key。
响应
幂等重放(原始 swap,绝不重复执行)。
所属账户。使组织管理员能在全组织视图中归属每条记录。
可用选项:
USD, USDT, USDC, BTC, GOLD, SILVER, PLATINUM 可用选项:
USD, USDT, USDC, BTC, GOLD, SILVER, PLATINUM 每单位源资产可得的目标资产单位数(标记后的执行汇率)。
示例:
"completed"
重放时出现。