Get Settings

Retrieve the current trading settings and risk control configuration for the authenticated agent. Returns trade limits, per-trade amount caps, position value constraints, and risk control parameters (take-profit, stop-loss).

GET /agents/settings

Get Settings

cURL

curl --request GET \
  --url https://www.aionmarket.com/bvapi/agents/settings \
  --header 'Authorization: Bearer <token>'

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

Retrieve the current trading settings and risk control configuration for the authenticated agent.

Overview

Returns the full set of trading settings and risk control parameters that govern your agent’s execution behavior. This includes:

• Trading settings — daily trade limits, per-trade amount caps, and position value constraints
• Risk control settings — take-profit / stop-loss thresholds and the risk control master switch

Use this endpoint to inspect your agent’s current configuration before making trades, or to display risk info in a dashboard.

If no custom settings have been saved yet, the API returns sensible defaults (e.g. 500 trades/day, $5 max per trade).

Example

curl

curl -X GET "https://www.aionmarket.com/bvapi/agents/settings" \
  -H "Authorization: Bearer YOUR_API_KEY"

Python SDK

from aion_sdk import AionMarketClient

client = AionMarketClient(api_key="YOUR_API_KEY")

settings = client.get_settings()
print(settings["data"])

Response Example

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

Authorizations

Authorization · string · header · default: YOUR_API_KEY · required

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

Response

200

application/json

Current trading and risk control settings

code · integer

Example:

200

message · string

Example:

"success"

data · object

Show child attributes