GET
/
api
/
v1
/
accounts
/
leverage
/
{symbol}
curl -X GET "https://api.roxom.com/api/v1/accounts/leverage/CL" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json"

{
  "data": {
    "leverage": "10.0"
  }
}

​
Get Leverage

Retrieve current leverage setting for a specific trading symbol.

​
Endpoint

GET /api/v1/accounts/leverage/{symbol}

​
Parameters

​
symbol
string
required
Trading symbol to get leverage for (e.g., “OIL-BTC”)
​
X-API-Key
string
required
API key for authentication. Format: your_api_key_here

​
Example Request

curl -X GET "https://api.roxom.com/api/v1/accounts/leverage/CL" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json"

​
Response

{
  "data": {
    "leverage": "10.0"
  }
}
​
data
object
Leverage information for the requested symbol

​
Set Leverage

Update leverage setting for a specific trading symbol.

​
Endpoint

POST /api/v1/accounts/leverage/{symbol}

​
Parameters

​
symbol
string
required
Trading symbol to set leverage for (e.g., “OIL-BTC”)
​
X-API-Key
string
required
API key for authentication. Format: your_api_key_here

​
Request Body

​
leverage
string
required
Desired leverage value as decimal string (must be within allowed range)

​
Example Request

curl -X POST "https://api.roxom.com/api/v1/accounts/leverage/CL" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "leverage": "25.0"
  }'

​
Response

{
  "data": {
    "success": true,
    "leverage": 25,
    "symbol": "OIL-BTC"
  }
}
​
data
object
Leverage update confirmation

​
Leverage Limits

​
Error Handling

​
Invalid Leverage Value

{
  "code": "VALIDATION_ERROR",
  "message": "Invalid leverage value",
  "details": "Leverage must be between 1 and 50 for this symbol"
}

​
Symbol Not Found

{
  "code": "NOT_FOUND",
  "message": "Symbol not found",
  "details": "Trading symbol 'INVALID' does not exist"
}

Account Balance

Check account balance

Positions

View current positions