Skip to main content

Set Limit Price Behaviour

You can configure how the system behaves when your limit order price exceeds the highest bid or lowest ask price. You can query configuration by Get Limit Price Behaviour

Spot

  • Maximum Buy Price: Min[Max(Index, Index × (1 + y%) + 2-Minute Average Premium), Index × (1 + z%)]
  • Lowest price for Sell: Max[Min(Index, Index × (1 – y%) + 2-Minute Average Premium), Index × (1 – z%)]

Futures

  • Maximum Buy Price: min( max( index , markprice ( 1 + x% ）), markprice ( 1 + y%) )
  • Lowest price for Sell: max ( min( index , markprice ( 1 - x% )) , markprice ( 1 - y%) )
Default Setting

  • Spot: modifyEnable = false. If the order price exceeds the boundary, the system rejects the request.
    Corresponding to Get Limit Price Behaviour that lpaSpot = false , lpaPerp = true

  • Futures: modifyEnable = true. If the order price exceeds the boundary, the system will automatically adjust the price to the nearest allowed boundary (i.e., highest bid or lowest ask).
    Corresponding to Get Limit Price Behaviour that lpaSpot = true , lpaPerp = false

  • Setting either linear or inverse will set behaviour for all futures.

HTTP Request​

POST /v5/account/set-limit-px-action

Request Parameters​

ParameterRequiredTypeComments
categorytruestringlinear, inverse, spot
modifyEnabletruebooleantrue: allow the syetem to modify the order price
false: reject your order request

Response Parameters​

None

Request Example​

POST /v5/account/set-limit-px-action HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXXX
X-BAPI-API-KEY: XXXXXX
X-BAPI-TIMESTAMP: 1753255927950
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json
Content-Length: 52

{
    "category": "spot",
    "modifyEnable": true
}

Response Example​

{
    "retCode": 0,
    "retMsg": "success",
    "result": {},
    "retExtInfo": {},
    "time": 1753255927952
}