{
"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"
}Crear una wallet segregada
Crea una wallet on-chain nueva de la cuenta que llama. Su saldo vive on-chain (nunca en el ledger) y queda exenta del barrido de tesorería. Pares soportados: tron/usdt, eth/usdt, eth/usdc, btc/btc. Las cuentas empresa pueden crear wallets ilimitadas; las cuentas persona tienen 1 por combinación red+activo (la segunda responde 422 wallet_limit_reached). Un Idempotency-Key opcional (o idempotency_key en el body) hace el reintento seguro: una repetición devuelve la misma wallet sin crear otra. Puede cobrar el fee wallet_creation (reembolsado si la creación falla).
{
"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"
}Autorizaciones
JWT de sesión (de register/login) o llave de API (pk_...).
X-API-Key: <token> se acepta como header alternativo.
Cuerpo
Respuesta
Wallet creada.
Discriminador de producto de las wallets segregadas.
segregated tron, eth, btc "USDT"
Cómo entró la wallet a la plataforma.
created, imported Si la llave privada se exportó alguna vez (custodia compartida).