Skip to Content
📈 Futures APITrading APITrading Pair Configuration

Trading Pair Configuration

Request URL

GET /ftapi/v1/symbolConfig

Request Parameters

NameTypeRequiredDescription

Response Parameters

NameTypeDescription
codeSTRINGResponse Code
msgSTRINGResponse Message
successBOOLEANSuccess Flag
data[].contractSideSTRING
data[].contractTypeSTRING
data[].defaultLeverageINTEGER
data[].defaultMarginModeSTRING
data[].riskLimitConfigsARRAY
data[].symbolIdSTRING

Request Example

https://openapi.bittap.com/ftapi/v1/symbolConfig

Response Example

{ "code": "0", "data": [ { "contractSide": "FORWARD", // Contract side: FORWARD=linear contract (USDT-margined), REVERSE=inverse contract (coin-margined) "contractType": "PERPETUAL", // Contract type: PERPETUAL=perpetual contract, DELIVERY=delivery contract "defaultLeverage": 20, // Default leverage (initial available leverage) "defaultMarginMode": "ISOLATION", // Default margin mode: ISOLATION=isolated margin, CROSSED=cross margin "riskLimitConfigs": [ // Risk limit configuration list (tiered leverage and margin requirements) { "level": 1, // Risk level: Level 1 (initial tier) "maintainMarginRate": 0.01, // Maintenance margin rate (minimum margin ratio) "maxLeverage": 25, // Maximum leverage (highest leverage available for this tier) "maxPositionValue": 20000, // Maximum position value (upper limit for this tier) "minPositionValue": 0 // Minimum position value (starting value for this tier) }, { "level": 2, // Risk level: Tier 2 "maintainMarginRate": 0.025, // Maintenance margin rate "maxLeverage": 10, // Maximum leverage "maxPositionValue": 50000, // Maximum position value "minPositionValue": 20000 // Minimum position value }, { "level": 3, // Risk level: Tier 3 "maintainMarginRate": 0.05, // Maintenance margin rate "maxLeverage": 5, // Maximum leverage "maxPositionValue": 500000, // Maximum position value "minPositionValue": 50000 // Minimum position value }, { "level": 4, // Risk level: Tier 4 "maintainMarginRate": 0.1, // Maintenance margin rate "maxLeverage": 2, // Maximum leverage "maxPositionValue": 1000000, // Maximum position value "minPositionValue": 500000 // Minimum position value }, { "level": 5, // Risk level: Tier 5 (highest) "maintainMarginRate": 0.5, // Maintenance margin rate (highest margin requirement) "maxLeverage": 1, // Maximum leverage (lowest) "maxPositionValue": 3000000, // Maximum position value "minPositionValue": 1000000 // Minimum position value } ], "symbolId": "PENGU-USDT-M" // Trading pair ID (e.g., PENGU perpetual contract) } ], "msg": "Request successful", "success": true }

Error Codes

Error CodeDescription
500Server Error

Code Example

Last updated on: