Change risk limit

POST🔒 Trading

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

tip

Try It Out — test this endpoint in the API Explorer

Updates the risk-limit tier for a market by either notional value (riskLimit) or tier index (riskLimitLevel).

Request Parameters

Name	Type	Required	Description
symbol	String	Yes	Market symbol to configure (e.g. BTC-PERP).
riskLimit	Long	No	Target risk-limit notional value. Required if riskLimitLevel is not provided.
riskLimitLevel	Integer	No	Target risk-limit tier index. Required if riskLimit is not provided.
positionMode	String	No	Position mode of the position the risk limit applies to (ONE_WAY or HEDGE). Required in hedge mode.

Response Content

Name	Type	Description
symbol	String	Market symbol that was updated (e.g. BTC-PERP).
timestamp	Long	Server timestamp of the response, in milliseconds since epoch.
status	Integer	Status code of the risk-limit change.
type	Integer	Event type code of the response.
message	String	Human-readable message describing the result.

example

POSThttps://api.btse.com/futures/api/v3/trade/risk_limit

Request (default)

{
  "symbol": "BTC-PERP",
  "riskLimitLevel": 1
}

Response (default)

{
  "symbol": "BTC-PERP",
  "timestamp": 1784882344227,
  "status": 20,
  "type": 94,
  "message": "New risk limit set to 1. Initial Margin: 0.01, Maintenance Margin: 0.005"
}