Transfer USDC between perp sub-wallets (two-step confirm)
POST /v1/perps/transfer — Move idle USDC from one perp sub-wallet to another. USDC only. Fund-moving: preview → confirm two-step keyed by `idempot
POST /v1/perps/transfer
Move idle USDC from one perp sub-wallet to another. USDC only. Fund-moving: preview → confirm two-step keyed by idempotencyKey. 409 insufficient_balance when the amount exceeds the source wallet's idle USDC; 400 on a self-transfer.
| Method | POST |
| Path | /v1/perps/transfer |
| Auth | Authorization: Bearer <token> required when GATEWAY_AUTH_TOKEN is set |
| Category | perps |
Request body
{ "fromSubAccountId": "sub_a", "toSubAccountId": "sub_b", "amount": "100", "asset": "USDC", "confirm": false, "idempotencyKey": "<uuid-v4>" }Response body
{ "confirmed": false, "preview": { "fromSubAccountId": "sub_a", "toSubAccountId": "sub_b", "amount": "100", "asset": "USDC", "availableBefore": "126.71", "warning": "…" } }