Skip to main content

​
Overview

Ekiden supports leverage settings per market, allowing users to control leverage independently for each trading pair. Adjusting leverage changes how much margin is allocated to an open position in a given market. Increasing leverage reduces the required margin but increases liquidation risk, while lowering leverage increases the required margin and reduces liquidation risk.

​
Endpoint

POST /api/v1/position/set-leverage Sets leverage for a specific symbol and sub-account. The request body includes:
  • leverage: Leverage value to set.
  • sub_account_address: Sub-account address.
  • symbol: Market symbol.

​
Headers

Authorization: Bearer <JWT>
Content-Type: application/json

​
Request Parameters

ParameterTypeDescriptionRequired
leveragestringLeverage value to set (e.g. "10" for 10x)Yes
sub_account_addressstringSub-account addressYes
symbolstringMarket symbol (e.g. "CC-USDCx")Yes

​
Example Request

{
  "leverage": "8",
  "sub_account_address": "0x6160e0768af12ec30112972801aaa8287b42f15a2485ef68cd184a3eeec9dc49",
  "symbol": "BTC-USDCx"
}

​
Response

{
  "success": true,
  "time": 1783479390120
}

​
Notes

  • Leverage is configured per symbol.
  • Minimum and maximum leverage limits may vary by market.
  • Changing leverage may affect margin requirements and liquidation price.