Risk Settings List

Retrieve the current risk settings for the authenticated agent.

GET /markets/risk-settings

Risk Settings List

cURL

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

import requests

url = "https://www.aionmarket.com/bvapi/markets/risk-settings"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://www.aionmarket.com/bvapi/markets/risk-settings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://www.aionmarket.com/bvapi/markets/risk-settings",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://www.aionmarket.com/bvapi/markets/risk-settings"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://www.aionmarket.com/bvapi/markets/risk-settings")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://www.aionmarket.com/bvapi/markets/risk-settings")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

200

{
  "maxTradesPerDay": 500,
  "maxTradeAmount": "5.00000000",
  "tradeLimitEnabled": true,
  "dailyTradeAmountLimit": "500.00000000",
  "maxPositionValue": "100.00000000",
  "riskControlEnabled": false,
  "takeProfitPercent": null,
  "stopLossPercent": 50,
  "updatedAt": "1713000000000"
}

Retrieve the current risk settings for the authenticated agent.

Overview

Returns the full risk settings for the agent. If no settings have been saved yet, default values are returned.

Defaults:

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

Examples

curl

curl -X GET https://api.aionmarket.com/bvapi/markets/risk-settings \
  -H "Authorization: Bearer YOUR_API_KEY"

Python SDK

from aion_sdk import AionMarketClient

client = AionMarketClient(api_key="YOUR_API_KEY")
settings = client.get_risk_settings()
print(settings)

Response

{
  "maxTradesPerDay": 500,
  "maxTradeAmount": "5.00000000",
  "tradeLimitEnabled": true,
  "dailyTradeAmountLimit": "500.00000000",
  "maxPositionValue": "100.00000000",
  "riskControlEnabled": false,
  "takeProfitPercent": null,
  "stopLossPercent": 50,
  "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
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.

Response

200

application/json

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