curl --request POST \
--url https://api.qbank.cl/platform/v1/segregated-wallets \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"chain": "tron",
"asset": "usdt",
"label": "Acme Client",
"idempotency_key": "wallet-client-001"
}
'
{
"wallet_id": "b7e3a1c2-9f4d-4a8b-8c1e-2d3f4a5b6c7d",
"chain": "tron",
"asset": "USDT",
"address": "TRmSZRaMAqLEevAdGwo3R43bRBXamWR5bd",
"label": "Acme Client",
"type": "segregated",
"origin": "created",
"custody": "cbpay",
"exported": false,
"created_at": "2026-07-11T12:00:00Z"
}{
"error": "invalid_asset",
"message": "unsupported chain/asset pair (supported: tron/usdt, eth/usdt, eth/usdc, btc/btc)"
}{
"error": "unauthorized",
"message": "invalid or missing credentials"
}{
"error": "service_disabled",
"message": "this service is not enabled for the account"
}{
"error": "idempotency_conflict",
"message": "a wallet with this idempotency key is still being provisioned; retry with the same key"
}{
"error": "wallet_limit_reached",
"message": "person accounts hold one segregated wallet per network/asset pair; company accounts have no limit"
}创建隔离钱包
创建一个由调用方账户拥有的链上新钱包。其余额存在于链上(从不进入账本),并豁免于资金归集(treasury sweep)。支持的组合:tron/usdt、eth/usdt、eth/usdc、btc/btc。企业账户可创建不限数量的钱包;个人账户每个网络+资产组合限 1 个(创建第二个会返回 422 wallet_limit_reached)。可选的 Idempotency-Key(或请求体中的 idempotency_key)让重试安全:重复请求返回同一钱包,不会创建第二个。可能收取 wallet_creation 费用(创建失败退款)。
POST
/
v1
/
segregated-wallets
curl --request POST \
--url https://api.qbank.cl/platform/v1/segregated-wallets \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"chain": "tron",
"asset": "usdt",
"label": "Acme Client",
"idempotency_key": "wallet-client-001"
}
'
{
"wallet_id": "b7e3a1c2-9f4d-4a8b-8c1e-2d3f4a5b6c7d",
"chain": "tron",
"asset": "USDT",
"address": "TRmSZRaMAqLEevAdGwo3R43bRBXamWR5bd",
"label": "Acme Client",
"type": "segregated",
"origin": "created",
"custody": "cbpay",
"exported": false,
"created_at": "2026-07-11T12:00:00Z"
}{
"error": "invalid_asset",
"message": "unsupported chain/asset pair (supported: tron/usdt, eth/usdt, eth/usdc, btc/btc)"
}{
"error": "unauthorized",
"message": "invalid or missing credentials"
}{
"error": "service_disabled",
"message": "this service is not enabled for the account"
}{
"error": "idempotency_conflict",
"message": "a wallet with this idempotency key is still being provisioned; retry with the same key"
}{
"error": "wallet_limit_reached",
"message": "person accounts hold one segregated wallet per network/asset pair; company accounts have no limit"
}授权
会话 JWT(来自注册/登录)或 API key(pk_...)。
也接受 X-API-Key: <token> 作为替代请求头。
请求体
application/json
响应
钱包已创建。