获取交易规则和交易对
接口描述
获取当前的系统规则和交易限制。
ZTDX 实际填充的 filter 集合
每个 symbols[*].filters 数组按以下顺序固定包含 4 个 filter:
PRICE_FILTER——tickSize是真实生效值,minPrice等于tickSize。maxPrice是哨兵大值 (1000000000),实际上限由后端max_order_size_usd控制。LOT_SIZE——minQty与stepSize真实生效,等于该 symbol 的 lot size。maxQty同上为哨兵值。MARKET_LOT_SIZE—— 与LOT_SIZE同值。(Binance 区分两者;ZTDX 不区分,响应里保留是为 SDK 兼容。)MIN_NOTIONAL——notional取该 symbol 的min_order_size_usd(默认 10 USD,可按 symbol 查询)。同样的值也通过列表接口/api/v1/markets[*].min_order_size_usd暴露。
filter 类型 MAX_NUM_ORDERS、PERCENT_PRICE、MAX_NUM_ALGO_ORDERS 不填充。每账户 / 每 symbol 的订单数量限制走后端 admission 控制,不通过 filter。
MIN_NOTIONAL 检查对 reduceOnly=true 订单豁免,确保被资金费侵蚀到 < 10 USD 的仓位仍能平仓。详见 new-order。
HTTP请求
GET /exchangeInfo
请求权重
1
请求参数
NONE
响应示例
{
"exchangeFilters": [],
"rateLimits": [ // API访问的限制
{
"interval": "MINUTE", // 按照分钟计算
"intervalNum": 1, // 按照1分钟计算
"limit": 2400, // 上限次数
"rateLimitType": "REQUEST_WEIGHT" // 按照访问权重来计算
},
{
"interval": "MINUTE",
"intervalNum": 1,
"limit": 1200,
"rateLimitType": "ORDERS" // 按照订单数量来计算
}
],
"serverTime": 1565613908500, // 请忽略。如果需要获取当前系统时间，请查询接口 “GET /fapi/v1/time”
"assets": [ // 资产信息
{
"asset": "BTC",
"marginAvailable": true, // 是否可用作保证金
"autoAssetExchange": "-0.10" // 保证金资产自动兑换阈值
},
{
"asset": "USDT",
"marginAvailable": true, // 是否可用作保证金
"autoAssetExchange": "0" // 保证金资产自动兑换阈值
},
{
"asset": "BNB",
"marginAvailable": false, // 是否可用作保证金
"autoAssetExchange": null // 保证金资产自动兑换阈值
}
],
"symbols": [ // 交易对信息
{
"symbol": "BLZUSDT", // 交易对
"pair": "BLZUSDT", // 标的交易对
"contractType": "PERPETUAL", // 合约类型
"deliveryDate": 4133404800000, // 交割日期
"onboardDate": 1598252400000, // 上线日期
"status": "TRADING", // 交易对状态
"maintMarginPercent": "2.5000", // 请忽略
"requiredMarginPercent": "5.0000", // 请忽略
"baseAsset": "BLZ", // 标的资产
"quoteAsset": "USDT", // 报价资产
"marginAsset": "USDT", // 保证金资产
"pricePrecision": 5, // 价格小数点位数(仅作为系统精度使用，注意同tickSize 区分）
"quantityPrecision": 0, // 数量小数点位数(仅作为系统精度使用，注意同stepSize 区分）
"baseAssetPrecision": 8, // 标的资产精度
"quotePrecision": 8, // 报价资产精度
"underlyingType": "COIN",
"underlyingSubType": ["STORAGE"],
"settlePlan": 0,
"triggerProtect": "0.15", // 开启"priceProtect"的条件订单的触发阈值
"filters": [
{
"filterType": "PRICE_FILTER", // 价格限制
"maxPrice": "300", // 价格上限, 最大价格
"minPrice": "0.0001", // 价格下限, 最小价格
"tickSize": "0.0001" // 订单最小价格间隔
},
{
"filterType": "LOT_SIZE", // 数量限制
"maxQty": "10000000", // 数量上限, 最大数量
"minQty": "1", // 数量下限, 最小数量
"stepSize": "1" // 订单最小数量间隔
},
{
"filterType": "MARKET_LOT_SIZE", // 市价订单数量限制
"maxQty": "590119", // 数量上限, 最大数量
"minQty": "1", // 数量下限, 最小数量
"stepSize": "1" // 允许的步进值
},
{
"filterType": "MAX_NUM_ORDERS", // 最多订单数限制
"limit": 200
},
{
"filterType": "MIN_NOTIONAL", // 最小名义价值
"notional": "5.0",
},
{
"filterType": "PERCENT_PRICE", // 价格比限制
"multiplierUp": "1.1500", // 价格上限百分比
"multiplierDown": "0.8500", // 价格下限百分比
"multiplierDecimal": "4"
}
],
"orderTypes": [ // 订单类型
"LIMIT", // 限价单
"MARKET", // 市价单
"STOP", // 止损单
"STOP_MARKET", // 止损市价单
"TAKE_PROFIT", // 止盈单
"TAKE_PROFIT_MARKET", // 止盈暑市价单
"TRAILING_STOP_MARKET" // 跟踪止损市价单
],
"timeInForce": [ // 有效方式
"GTC", // 成交为止, 一直有效
"IOC", // 无法立即成交(吃单)的部分就撤销
"FOK", // 无法全部立即成交就撤销
"GTX" // 无法成为挂单方就撤销
],
"liquidationFee": "0.010000", // 强平费率
"marketTakeBound": "0.30", // 市价吃单(相对于标记价格)允许可造成的最大价格偏离比例
}
],
"timezone": "UTC" // 服务器所用的时间区域
}
代码示例
cURL
curl -s "https://api-sepolia.ztdx.io/fapi/v1/exchangeInfo"
Python
import requests
base_url = "https://api.ztdx.io"
response = requests.get(f"{base_url}/fapi/v1/exchangeInfo")
data = response.json()
print(f"Timezone: {data['timezone']}")
print(f"Symbols count: {len(data['symbols'])}")
for s in data['symbols'][:3]:
print(f" {s['symbol']} - {s['contractType']} - {s['status']}")