API Reference

Change Account PositionMode

Description

Update the position mode of your trading portfolio on a specific exchange (currently BINANCE, OKX, EDX).

You can switch between one-way (NET) mode and hedge (BOTH) mode for all contracts on that venue.

Important:

  • This setting only applies to derivatives positions and orders on the exchange.
  • Spot orders and spot holdings are not affected by this operation.
  • Before changing the position mode, you must close all derivatives positions and cancel all open derivatives orders on that exchange.
  • If there are any remaining derivatives positions or active derivatives orders, the request will fail according to the exchange’s rules.

Rate Limit

50 requests per 10 seconds.

Permission

Accessible by Main or Sub Trading Portfolio API keys with trade permission.

Request

FieldTypeMandatoryDescription
exchangeTypeStringYExchange where the position mode should be updated, e.g. BINANCE, OKX, EDX.
positionModeStringYTarget position mode on this exchange: NET for one-way mode (single net position per symbol), BOTH for hedge mode (independent long/short positions).

Response

FieldTypeDescription
codeStringBusiness status code, 200000 indicates success.
messageStringResult message, "Success" on successful operation.
dataObjectEmpty object for this endpoint (no extra payload).
Language
Credentials
OAuth2