Set Trade Mode

Sets the trade mode for the user account to either One-Way or Multi-Position mode.

Currently, Flipster API only support one-way mode in perptual trading. If you set multi-position mode, all order cannot be processed.

This endpoint allows users to configure their account’s trade mode between ONE_WAY and MULTIPLE_POSITIONS.

• In One-Way Mode, each symbol can only hold a single position (either long or short).

• In Multi-Position Mode, multiple long and short positions can coexist independently.

Changing the position mode affects how new orders and positions are managed, and it must be set before placing trades.

Authentication with a valid API key and trade permission scope is required.

Set Trade Mode

put

Required scopes

This endpoint requires the following scopes:

Authorizations

thirdPartyApiKeyAuth

api-keystringRequired

For third party retail API users

Body

application/json

tradeModestring · enumRequired

Trade mode

Possible values:

Responses

200

OK

application/json

tradeModestring · enumRequired

Trade mode

Possible values:

put

/api/v1/account/trade-mode

HTTPcURLJavaScriptPython

PUT /api/v1/account/trade-mode HTTP/1.1
Host: trading-api.flipster.io
api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 23

{
  "tradeMode": "ONE_WAY"
}

200

OK

{
  "tradeMode": "ONE_WAY"
}