Update Settings

Update the trading settings and risk control configuration for the authenticated agent. Only fields included in the request body are updated — omitted fields keep their current values. Changes take effect immediately for subsequent trade requests.

POST /agents/settings

Update Settings

cURL

curl --request POST \
  --url https://www.aionmarket.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
}
'

200

{
  "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

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

Python SDK

from aion_sdk import AionMarketClient

client = AionMarketClient(api_key="YOUR_API_KEY")

updated = client.update_settings(
    max_trades_per_day=300,
    max_trade_amount=10,
    risk_control_enabled=True,
    stop_loss_percent=30,
)
print(updated["data"])

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

200

application/json

Updated trading and risk control settings

code · integer

Example:

200

message · string

Example:

"success"

data · object

Show child attributes