Set Leverage

POST🔒 Trading

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

tip

Try It Out — test this endpoint in the API Explorer

Changes the leverage setting for the specified market.

Warning: Setting leverage to 0 applies cross-wallet maximum leverage. Reducing leverage on an existing position may trigger liquidation if the margin is insufficient.

Request Parameters

Name	Type	Required	Description
symbol	String	Yes	Market symbol
leverage	Double	Yes	Leverage value. 0 = cross max leverage
marginMode	String	No	CROSS · ISOLATED (default)
positionMode	String	No	Required when positionMode is HEDGE or ISOLATED
positionId	String	No	Required when positionMode is HEDGE or ISOLATED

Response Content

Name	Type	Description
symbol	String	Market symbol
status	Integer	8: Insufficient · 13: Invalid leverage · 20: Success · 64: Liquidation
type	Double	93 — indicates leverage update
timestamp	Long	Update timestamp
message	String	Response message

example

POSThttps://api.btse.com/futures/api/v2.3/leverage