MINARA

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.

MethodPOST
Path/v1/perps/transfer
AuthAuthorization: Bearer <token> required when GATEWAY_AUTH_TOKEN is set
Categoryperps

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": "…" } }

On this page