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

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):

Setting	Default
Trade limit enabled	`true`
Max trade amount	`5`
Daily trade amount limit	`500`
Max position value	`100`
Max trades per day	`500`
Risk control enabled	`false`
Take-profit percent	`null`
Stop-loss percent	`50`

Request body

Field	Type	Required	Description
`tradeLimitEnabled`	boolean	No	Enable/disable trading limits
`maxTradeAmount`	number	No	Maximum amount per single trade (USD)
`dailyTradeAmountLimit`	number	No	Daily total trading amount cap (USD)
`maxPositionValue`	number	No	Maximum value per position (USD)
`maxTradesPerDay`	integer	No	Maximum trades per day
`riskControlEnabled`	boolean	No	Enable/disable risk control (stop-loss/take-profit)
`takeProfitPercent`	integer \| null	No	Take-profit threshold (1–100%), `null` to clear
`stopLossPercent`	integer \| null	No	Stop-loss threshold (1–100%), `null` to clear

Examples

curl
Python SDK

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
  }'

from aion_sdk import AionMarketClient

client = AionMarketClient(api_key="YOUR_API_KEY")
result = client.set_risk_settings(
    trade_limit_enabled=True,
    max_trade_amount=10,
    stop_loss_percent=30,
    take_profit_percent=80,
)
print(result)

Response

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

Response Fields

Field	Type	Description
`maxTradesPerDay`	integer	Max trades per day
`maxTradeAmount`	string	Max trade amount (USD)
`tradeLimitEnabled`	boolean	Whether trading limits are on
`dailyTradeAmountLimit`	string	Daily total trading cap (USD)
`maxPositionValue`	string	Max value per position (USD)
`riskControlEnabled`	boolean	Whether risk control is on
`takeProfitPercent`	integer \| null	Take-profit %, `null` if not set
`stopLossPercent`	integer \| null	Stop-loss %, `null` if not set
`updatedAt`	string	Last update timestamp (ms)

Common errors

Code	Meaning
`400`	Invalid request payload
`401`	Invalid or missing API key
`500`	Server-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"

Wallet Positions Risk Settings List

​Overview

​Request body

​Examples

​Response

​Response Fields

​Common errors

Authorizations

Body

Response

Overview

Request body

Examples

Response

Response Fields

Common errors