Deposit Spot USDC into a perp sub-wallet (two-step confirm)
POST /v1/perps/deposit — Deposit at least 10 USDC from a selected Spot holding into a perp sub-wallet. The gateway validates the holding's chain
POST /v1/perps/deposit
Deposit at least 10 USDC from a selected Spot holding into a perp sub-wallet. The gateway validates the holding's chain and token address, then bridges non-Arbitrum USDC automatically. Fund-moving: preview then confirm, keyed by idempotencyKey.
| Method | POST |
| Path | /v1/perps/deposit |
| Auth | Authorization: Bearer <token> required when GATEWAY_AUTH_TOKEN is set |
| Category | perps |
Request body
{ "toSubAccountId": "sub_a", "amount": "100", "asset": "USDC", "quoteChain": "base", "quoteTokenAddress": "0x…", "confirm": false, "idempotencyKey": "<uuid-v4>" }Response body
{ "confirmed": false, "preview": { "toSubAccountId": "sub_a", "amount": "100", "asset": "USDC", "quoteChain": "base", "quoteTokenAddress": "0x…", "availableBefore": "126.71", "warning": "…" } }