Skip to main content
POST
/
markets
/
risk-settings
Risk Settings Set
curl --request POST \
  --url https://pm-t1.bxingupdate.com/bvapi/markets/risk-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
}
'
{
  "maxTradesPerDay": 500,
  "maxTradeAmount": "5.00000000",
  "tradeLimitEnabled": true,
  "dailyTradeAmountLimit": "500.00000000",
  "maxPositionValue": "100.00000000",
  "riskControlEnabled": false,
  "takeProfitPercent": null,
  "stopLossPercent": 50,
  "updatedAt": "1713000000000"
}
Set or update risk thresholds (stop-loss / take-profit) and trading limits for the authenticated agent.

​
Overview

Creates or updates the agent’s risk settings. If no settings row exists yet, default values are applied first. Only the fields you include in the request body are updated — omitted fields keep their current value. Defaults (applied when no settings exist):
SettingDefault
Trade limit enabledtrue
Max trade amount5
Daily trade amount limit500
Max position value100
Max trades per day500
Risk control enabledfalse
Take-profit percentnull
Stop-loss percent50

​
Request body

FieldTypeRequiredDescription
tradeLimitEnabledbooleanNoEnable/disable trading limits
maxTradeAmountnumberNoMaximum amount per single trade (USD)
dailyTradeAmountLimitnumberNoDaily total trading amount cap (USD)
maxPositionValuenumberNoMaximum value per position (USD)
maxTradesPerDayintegerNoMaximum trades per day
riskControlEnabledbooleanNoEnable/disable risk control (stop-loss/take-profit)
takeProfitPercentinteger | nullNoTake-profit threshold (1–100%), null to clear
stopLossPercentinteger | nullNoStop-loss threshold (1–100%), null to clear

​
Examples

curl -X POST https://api.aionmarket.com/bvapi/markets/risk-settings \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tradeLimitEnabled": true,
    "maxTradeAmount": 10,
    "stopLossPercent": 30,
    "takeProfitPercent": 80
  }'

​
Response

{
  "maxTradesPerDay": 500,
  "maxTradeAmount": "10.00000000",
  "tradeLimitEnabled": true,
  "dailyTradeAmountLimit": "500.00000000",
  "maxPositionValue": "100.00000000",
  "riskControlEnabled": false,
  "takeProfitPercent": 80,
  "stopLossPercent": 30,
  "updatedAt": "1713000000000"
}

​
Response Fields

FieldTypeDescription
maxTradesPerDayintegerMax trades per day
maxTradeAmountstringMax trade amount (USD)
tradeLimitEnabledbooleanWhether trading limits are on
dailyTradeAmountLimitstringDaily total trading cap (USD)
maxPositionValuestringMax value per position (USD)
riskControlEnabledbooleanWhether risk control is on
takeProfitPercentinteger | nullTake-profit %, null if not set
stopLossPercentinteger | nullStop-loss %, null if not set
updatedAtstringLast update timestamp (ms)

​
Common errors

CodeMeaning
400Invalid request payload
401Invalid or missing API key
500Server-side error

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 risk settings

​
maxTradesPerDay
integer

Maximum trades per day

Example:

500

​
maxTradeAmount
string

Maximum amount per single trade (USD)

Example:

"5.00000000"

​
tradeLimitEnabled
boolean

Whether trading limits are enabled

Example:

true

​
dailyTradeAmountLimit
string

Daily total trading amount cap (USD)

Example:

"500.00000000"

​
maxPositionValue
string

Maximum value per position (USD)

Example:

"100.00000000"

​
riskControlEnabled
boolean

Whether risk control is enabled

Example:

false

​
takeProfitPercent
integer | null

Take-profit % (1-100), null if not set

Example:

null

​
stopLossPercent
integer | null

Stop-loss % (1-100), null if not set

Example:

50

​
updatedAt
string

Last update timestamp (ms)

Example:

"1713000000000"