Transfer Funds Between Futures Wallets

POST🔒 Transfer

⚡ Orders: 75 req/s per endpoint · 75 req/s per user

tip

Try It Out — test this endpoint in the API Explorer

Transfers funds between user wallets (e.g. Spot → Cross, Cross → Isolated).

Important: When transferring to/from an ISOLATED wallet, you must specify the full wallet identifier (e.g. ISOLATED@BTC-PERP-USDT).

Note: the source wallet must hold balance in every currency listed in apiWallets before calling this endpoint.

Request Parameters

Name	Type	Required	Description
walletSrc	String	No	Source wallet identifier. Required when walletSrcType is ISOLATED
walletSrcType	String	Yes	Source wallet type — SPOT · CROSS · ISOLATED
walletDest	String	No	Destination wallet identifier. Required when walletDestType is ISOLATED
walletDestType	String	Yes	Destination wallet type — SPOT · CROSS · ISOLATED
apiWallets	Object[]	Yes	Transfer details

Response Content

Name	Type	Description
wallet	String	Wallet identifier
activeWalletName	String	Active wallet name
queryType	Integer	Query type
trackingID	Long	Internal tracking ID
walletTotalValue	Double	Wallet total value
totalValue	Double	Total value
marginBalance	Double	Margin balance
availableBalance	Double	Available balance
unrealisedProfitLoss	Double	Unrealized P&L
maintenanceMargin	Double	Maintenance margin
leverage	Double	Current leverage (CROSS: current, not setting)
openMargin	Double	Open margin
assets	Object[]	Available assets
assetsInUse	Object[]	Assets in use

example

POSThttps://api.btse.com/futures/api/v2.3/user/wallet/transfer

Request

{
  "walletSrc": "",
  "walletSrcType": "SPOT",
  "walletDest": "",
  "walletDestType": "CROSS",
  "apiWallets": [
    {
      "currency": "USD",
      "allBalance": true
    },
    {
      "currency": "BTC",
      "allBalance": true
    }
  ]
}