You can request the leverage levels available for each symbol for your account.
You cannot change the leverage level if you have any open orders or a non zero position.
Leverage management is performed over WebSocket.
  • Endpoint: wss://trade.qfex.com?api_key=YOUR_API_KEY
  • Authenticate within 1 minute of connecting.

Example Request

{
  "type": "get_available_leverage_levels",
  "params": {
    "limit": 10, // Optional
    "offset": 0  // Optional
  }
}
  • limit (optional) — maximum number of trades to return (default 1000)
  • offset (optional) — pagination offset (default 0)

Sample Code

# Python (websocket-client)
import json, websocket

API_KEY = "YOUR_API_KEY"

def send(ws, obj): ws.send(json.dumps(obj))

def on_open(ws):
    # Authenticate
    send(ws, {"type": "auth", "params": {"api_key": API_KEY}})
    # Request user trades
    send(ws, {"type": "get_available_leverage_levels", "params": {"limit": 10, "offset": 0}})

ws = websocket.WebSocketApp(
    "wss://trade.qfex.com?api_key=YOUR_API_KEY",
    on_open=on_open,
    on_message=lambda _, m: print("Message:", m)
)
ws.run_forever()

Example Response

{
  "available_leverage_levels_response": [
    {
      "id": "04349aaf-b29c-456d-b255-7b9de6e180c4",
      "symbol": "META-USD",
      "initial_margin": 1.0,
      "maintenance_margin": 0.6666666666666666,
      "max_position": 195000.0,
      "leverage": "1"
    },
    {
      "id": "9dc9cc77-5222-47f3-80fe-16d48fa1082e",
      "symbol": "META-USD",
      "initial_margin": 0.5,
      "maintenance_margin": 0.3333333333333333,
      "max_position": 190000.0,
      "leverage": "2"
    }
  ]
}