Docs·Web App·Auto Trade

Hedge mode — not supported

Auto Trade requires Binance Futures to be in One-Way Mode. This page explains why, how to switch your Binance account from Hedge to One-Way, and what to do if you genuinely need Hedge on a separate sub-account.

Auto Trade requires your Binance USD-M Futures account to be set to One-Way Mode. If your account is in Hedge Mode, every order the engine sends is rejected by Binance with a position-mode-mismatch error and the trade fails. This page explains why we only support One-Way, the exact steps to switch on Binance, and what to do if you genuinely need Hedge for non-Auto-Trade use.

Why we only support One-Way mode

Hedge mode lets you hold a long AND a short on the same symbol at the same time. That sounds harmless until you try to attach a stop-loss and six take-profit orders to one of the legs — every order needs an extra positionSide field, and a single mis-set field can close the wrong leg of the trade. The engine would also need to track which leg every SL/TP applies to in real time, and reconcile its view against Binance's view on every reconnect.

The cleaner contract is: one symbol, one net position, one set of SL/TP orders. That is exactly what One-Way mode gives. Every signal source the engine consumes is also designed around the One-Way model — sizes, leverages, and TP/SL prices are all calculated assuming a net directional position, not a hedge.

The trade-off: you cannot run a literal long-and-short-at-once strategy on the same Binance account that runs Auto Trade. If that is a requirement for you, see "I genuinely need Hedge" below.

How to switch to One-Way (Binance)

On Binance web

  1. Open Binance Futures → top-right hamburger menu → Preference → Position Mode.
  2. Pick One-Way Mode.
  3. Confirm.

On Binance mobile app

  1. Open Binance app → Futures → top-right gear icon → Position Mode.
  2. Tap One-Way Mode.
  3. Confirm.

Binance only allows the switch when you have no open positions and no open orders on Futures. If you do, close / cancel them first.

What happens to existing positions after switching

Position-mode switching while you have open positions is blocked by Binance. Workflow:

  1. Close (or take a snapshot of) every open Futures position manually.
  2. Cancel every working Futures order.
  3. Switch position mode.
  4. Re-open the positions you wanted to keep — they'll come up as One-Way.

For long-running positions, time the switch around a flat-account moment (post-TP fill, weekend, planned position close).

I genuinely need Hedge for some pairs

If you need to hold an opposite-side hedge on a specific pair for risk reasons (e.g. you long-spot a token AND need a futures short for delta hedge), the cleanest path is to use a separate Binance sub-account for the Hedge-mode trades:

  1. Create a Sub-Account in Binance.
  2. Set the sub-account's Futures to Hedge.
  3. Use the sub-account for your hedge trades.
  4. Keep the master / a different sub on One-Way for Auto Trade.
  5. Connect only the One-Way account's API to our platform.

What the engine does if your account is in Hedge

The engine detects Hedge mode on the first API check and shows a red banner: "Hedge mode detected — switch Binance Futures to One-Way before enabling LIVE". The LIVE switch is hard-disabled until the engine sees One-Way on a subsequent check.

If you flip to Hedge while LIVE is already on (for example via the Binance app while the engine is running), the next order will fail with POSITION_SIDE_NOT_MATCH and the engine surfaces a toast plus auto-pauses LIVE. Existing positions stay open — they just stop receiving new SL/TP amends until you switch back.

Common pitfalls

  • Position-mode mismatch banner stays red after you switched — the API key may have been issued under the old mode setting. Rotate the key on Binance and reconnect from API Connect — Binance.
  • Switched on the Binance mobile app, the engine didn't refresh — toggle LIVE off then on; that triggers a fresh position-mode check on connect.
  • Already had open Hedge positions when you tried to switch — Binance only allows the switch when you are flat. Close or cancel everything first.

What's next