Sign in

v2

OpenAPI 3.0.02026-07-311824171.4 MB
Trading
Matching Engine
Private

Moves positions from a source subaccount to a target subaccount. This operation transfers open positions between subaccounts, which is useful for rebalancing or reorganizing trading activities.

Positions can be filtered by currency. The operation creates trades to transfer positions, which may affect P&L and margin calculations.

Note - This method has distinct API rate limiting requirements:

  • Sustained rate: 6 requests/minute
  • Weekly limit: 100 move_position uses per week (168 hours)

For more information, see Rate Limits.

Important: In rare cases, the request may return an internal_server_error. This does not necessarily mean the operation failed entirely. Part or all of the position transfer might have still been processed successfully. Check the positions in both accounts to verify the transfer status.

📖 Related Article: Moving Positions

Scope: trade:read_write

Try in API console

get/private/move_positions

Query parameters

currency'BTC' | 'ETH' | 'USDC' | 'USDT' | 'EURR'

Currency, i.e "BTC", "ETH", "USDC"

The currency symbol

source_uidinteger required
Example:1

Id of source subaccount. Can be found in My Account >> Subaccounts tab

target_uidinteger required
Example:1

Id of target subaccount. Can be found in My Account >> Subaccounts tab

instrument_namestring

Unique instrument identifier

pricenumber

Price for trade - if not provided average price of the position is used

amountnumber

It represents the requested trade size. For perpetual and inverse futures the amount is in USD units. For options and linear futures it is the underlying base currency coin. Amount can't exceed position size.

List of trades for position move

[
  {
    "instrument_name": "BTC-PERPETUAL"
  }
]

Response

Success response

jsonrpc'2.0' required

The JSON-RPC version (2.0)

idinteger

The id that was sent in the request

Example response

{
  "result": {
    "trades": [
      {
        "instrument_name": "BTC-PERPETUAL"
      }
    ]
  }
}