Get Position Tiers

Get leverage tier information for a futures symbol, including maximum leverage and margin requirements for different position sizes.

HTTP Request

GET /api/v1/future/market/query-position-tier

Request Parameters

Parameter	Type	Required	Description
symbol	string	Yes	Trading pair symbol (e.g., BTCUSDT)

Request Example

curl -X GET "https://open-api.bydoxe.com/api/v1/future/market/query-position-tier?symbol=BTCUSDT"

Response Parameters

Parameter	Type	Description
code	string	Response code
msg	string	Response message
requestTime	number	Request timestamp in milliseconds
data	array	Array of position tier data
> symbol	string	Trading pair symbol
> level	string	Tier level (starting from "1")
> startUnit	string	Minimum position size for this tier
> endUnit	string	Maximum position size for this tier
> leverage	string	Maximum leverage allowed for this tier
> keepMarginRate	string	Maintenance margin rate required for positions in this tier

Response Example

Success Response

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1732000000000,
  "data": [
    {
      "symbol": "BTCUSDT",
      "level": "1",
      "startUnit": "0",
      "endUnit": "50",
      "leverage": "125",
      "keepMarginRate": "0.004"
    }
  ]
}

Error Codes

Code	Message
40034	symbol does not exist
50010	Upstream response invalid