Trading Pair Configuration
Request URL
GET /ftapi/v1/symbolConfig
Request Parameters
| Name | Type | Required | Description |
|---|
Response Parameters
| Name | Type | Description |
|---|---|---|
| code | STRING | Response Code |
| msg | STRING | Response Message |
| success | BOOLEAN | Success Flag |
| data[].contractSide | STRING | |
| data[].contractType | STRING | |
| data[].defaultLeverage | INTEGER | |
| data[].defaultMarginMode | STRING | |
| data[].riskLimitConfigs | ARRAY | |
| data[].symbolId | STRING |
Request Example
https://openapi.bittap.com/ftapi/v1/symbolConfigResponse 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 Code | Description |
|---|---|
| 500 | Server Error |
Code Example
Last updated on: