Skip to main content
POST
/
agents
/
settings
Update Settings
curl --request POST \
  --url https://pm-t1.bxingupdate.com/bvapi/agents/settings \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "tradeLimitEnabled": true,
  "maxTradeAmount": 2,
  "dailyTradeAmountLimit": 2,
  "maxPositionValue": 2,
  "maxTradesPerDay": 2500,
  "riskControlEnabled": true,
  "takeProfitPercent": 50,
  "stopLossPercent": 50
}
'
{
  "code": 200,
  "message": "success",
  "data": {
    "maxTradesPerDay": 500,
    "maxTradeAmount": "5.00000000",
    "tradeLimitEnabled": true,
    "dailyTradeAmountLimit": "500.00000000",
    "maxPositionValue": "100.00000000",
    "riskControlEnabled": false,
    "takeProfitPercent": null,
    "stopLossPercent": 50,
    "updatedAt": "1713000000000"
  }
}
Update the trading settings and risk control configuration for the authenticated agent. Only fields you include in the request body are updated — omitted fields keep their current values.

​
Overview

Use this endpoint to adjust your agent’s trading settings and risk control parameters on the fly. You can configure:
  • Trading settings — maxTradesPerDay, maxTradeAmount, tradeLimitEnabled, dailyTradeAmountLimit, maxPositionValue
  • Risk control settings — riskControlEnabled, takeProfitPercent, stopLossPercent
Changes take effect immediately. Any in-flight trades are not affected, but subsequent trade requests will be validated against the new settings.
To clear a take-profit or stop-loss threshold, pass null for that field.

​
Example

curl -X POST "https://pm-t1.bxingupdate.com/bvapi/agents/settings" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "maxTradesPerDay": 300,
    "maxTradeAmount": 10,
    "riskControlEnabled": true,
    "stopLossPercent": 30
  }'

​
Response Example

{
  "code": 200,
  "message": "success",
  "data": {
    "maxTradesPerDay": 300,
    "maxTradeAmount": "10.00000000",
    "tradeLimitEnabled": true,
    "dailyTradeAmountLimit": "500.00000000",
    "maxPositionValue": "100.00000000",
    "riskControlEnabled": true,
    "takeProfitPercent": null,
    "stopLossPercent": 30,
    "updatedAt": "1713100000000"
  }
}

Authorizations

​
Authorization
string
header
default:YOUR_API_KEY
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
tradeLimitEnabled
boolean

Enable/disable trading limits

​
maxTradeAmount
number

Max amount per trade (USD)

Required range: x >= 1
​
dailyTradeAmountLimit
number

Daily trading cap (USD)

Required range: x >= 1
​
maxPositionValue
number

Max position value (USD)

Required range: x >= 1
​
maxTradesPerDay
integer

Max trades per day

Required range: 1 <= x <= 5000
​
riskControlEnabled
boolean

Enable/disable risk control

​
takeProfitPercent
integer | null

Take-profit % (1-100), null to clear

Required range: 1 <= x <= 100
​
stopLossPercent
integer | null

Stop-loss % (1-100), null to clear

Required range: 1 <= x <= 100

Response

Updated trading and risk control settings

​
code
integer
Example:

200

​
message
string
Example:

"success"

​
data
object