Skip to main content
POST
Update Settings
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 settingsmaxTradesPerDay, maxTradeAmount, tradeLimitEnabled, dailyTradeAmountLimit, maxPositionValue
  • Risk control settingsriskControlEnabled, 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

Response Example

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