获取交易产品信息
描述
查询在线交易币对信息
HTTP请求
- GET /api/v3/market/instruments
- 限频规则: 20次/秒/IP
请求示例
curl "https://api.bitget.com/api/v3/market/instruments?category=USDT-FUTURES" \
请求参数
| 参数名 | 参数类型 | 是否必须 | 描述 |
|---|---|---|---|
| category | String | 是 | 产品类型SPOT 现货交易MARGIN 杠杆USDT-FUTURES U本位合约COIN-FUTURES 币本位合约USDC-FUTURES USDC合约 |
| symbol | String | 否 | 交易对名称 例如: BTCUSDT |
- Spot
- Futures
- Margin
返回示例
{
"code": "00000",
"msg": "success",
"requestTime": 1734766810918,
"data": [
{
"symbol": "BTCUSDT",
"category": "SPOT",
"baseCoin": "BTC",
"quoteCoin": "USDT",
"buyLimitPriceRatio": "0.05",
"sellLimitPriceRatio": "0.05",
"feeRateUpRatio": "",
"minOrderQty": "0.00001",
"maxOrderQty": "",
"pricePrecision": "2",
"quantityPrecision": "6",
"quotePrecision": "6",
"minOrderAmount": "1",
"maxSymbolOrderNum": "",
"maxProductOrderNum": "",
"status": "online",
"offTime": "",
"limitOpenTime": "",
"maintainTime": "",
"areaSymbol": "no"
}
]
}
返回示例
{
"code": "00000",
"msg": "success",
"requestTime": 1731056538962,
"data": [
{
"symbol": "BTCUSDT",
"category": "USDT-FUTURES",
"isRwa": "NO",
"baseCoin": "BTC",
"quoteCoin": "USDT",
"buyLimitPriceRatio": "1000",
"sellLimitPriceRatio": "1",
"feeRateUpRatio": "0.1",
"makerFeeRate": "0.0004",
"takerFeeRate": "0.0006",
"openCostUpRatio": "0.1",
"minOrderQty": "0.0001",
"maxOrderQty": "",
"pricePrecision": "1",
"quantityPrecision": "4",
"quotePrecision": "",
"priceMultiplier": "0.1",
"quantityMultiplier": "0.0001",
"symbolType": "perpetual",
"minOrderAmount": "2",
"maxSymbolOrderNum": "10000000",
"maxProductOrderNum": "10000000",
"maxPositionNum": "50",
"status": "online",
"offTime": "-1",
"limitOpenTime": "-1",
"deliveryTime": "",
"deliveryStartTime": "",
"deliveryPeriod": "",
"launchTime": "",
"fundInterval": "8",
"minLeverage": "1",
"maxLeverage": "125",
"maintainTime": "",
"maxMarketOrderQty": "220"
}
]
}
返回示例
{
"code": "00000",
"msg": "success",
"requestTime": 1731056538962,
"data": [
{
"symbol": "ADAUSDT",
"category": "MARGIN",
"baseCoin": "ADA",
"quoteCoin": "USDT",
"buyLimitPriceRatio": "0.5",
"sellLimitPriceRatio": "0.5",
"feeRateUpRatio": "",
"minOrderQty": "0.001",
"maxOrderQty": "10000000000",
"pricePrecision": "3",
"quantityPrecision": "3",
"quotePrecision": "6",
"minOrderAmount": "5",
"maxSymbolOrderNum": "",
"maxProductOrderNum": "",
"maxPositionNum": "",
"status": "online",
"offTime": "",
"limitOpenTime": "",
"maintainTime": "",
"isIsolatedBaseBorrowable": "NO",
"isIsolatedQuotedBorrowable": "NO",
"warningRiskRatio": "0.8",
"liquidationRiskRatio": "1",
"maxCrossedLeverage": "3",
"maxIsolatedLeverage": "10",
"userMinBorrow": "0.00000001",
"areaSymbol": ""
}
]
}
返回参数
| 返回字段 | 参数类型 | 字段说明 |
|---|---|---|
| category | String | 产品类型SPOT 现货交易MARGIN 杠杆交易USDT-FUTURES:U本位合约COIN-FUTURES:币本位合约USDC-FUTURES:USDC合约 |
| symbol | String | 交易对名称 |
| isRwa | String | 是否为RWA交易对YES 是NO 否 |
| baseCoin | String | 交易币种 例如: BTCUSDT中的BTC |
| quoteCoin | String | 计价币种 例如: BTCUSDT中的USDT |
| buyLimitPriceRatio | String | 买价限价比例 买入限价与市场价格的比率,决定买单下单时的最高价格 |
| sellLimitPriceRatio | String | 卖价限价比例 卖出限价与市场价格的比率,决定卖单下单时的最低价格 |
| feeRateUpRatio | String | 手续费上浮比例 实际费用相对于基础费用增加的百分比 |
| openCostUpRatio | String | 开仓成本上浮比例 开仓的成本相对于基础或标准成本增加的百分比 |
| minOrderQty | String | 最小开单数量 这指的是以基础币种下单时允许的最小数量 仅适用于合约交易,现货/杠杆请参考交易规则 |
| maxOrderQty | String | 单笔限价单最大下单数量 这指的是以基础币种下单时允许的最大数量 仅适用于合约交易,现货/杠杆请参考交易规则 |
| minOrderAmount | String | 最小下单额 这指的是以计价币种下单时允许的最小数量 |
| pricePrecision | String | 价格精度 价格允许的小数位数 下单时,填写的价格必须是价格精度的整数倍 |
| quantityPrecision | String | 数量精度 数量允许的小数位数 下单时,填写的数量必须是数量精度的整数倍 |
| quotePrecision | String | 市价下单精度 计价币价格允许的小数位数 |
| priceMultiplier | String | 价格乘数 合约下单使用, 配合 pricePrecision例如: BTCUSDT pricePrecision: 2 精度就是0.01priceMultiplier: 0.02那么委托价格要满足 priceMultiplier的倍数, 并且小数位是 2 |
| quantityMultiplier | String | 数量乘数 合约下单使用. 配合 quantityPrecision例如: BTCUSDT quantityPrecision: 2 精度就是0.01quantityMultiplier: 0.02那么委托数量要满足 quantityMultiplier的倍数, 并且小数位是 2 |
| type | String | 合约类型perpetual 永续delivery 交割 |
| maxSymbolOrderNum | String | 交易对维度最大委托数量 |
| maxProductOrderNum | String | 业务线维度最大委托数量 |
| maxPositionNum | String | 最大持有仓位数量(交易对维度) |
| status | String | 交易对状态 listed 上架(未开盘) online 正常交易/开盘 limit_open 限制交易(合约禁止开平仓) offline 下架/维护 restrictedAPI API限制下单 |
| offTime | String | 下架时间 未配置则返回: "" |
| limitOpenTime | String | 限制开仓时间 未配置则返回: ""; 其它值表示symbol正在/计划维护,指定时间后禁止交易 |
| deliveryTime | String | 交割时间 仅交割合约返回 |
| deliveryStartTime | String | 交割币对开始时间 仅交割合约返回 |
| deliveryPeriod | String | 交割周期this_quarter当季 next_quarter次季仅交割合约返回 |
| fundInterval | String | 资金费结算周期1 每小时/8 每8小时 |
| minLeverage | String | 最小杠杆 |
| maxLeverage | String | 最大杠杆 |
| maintainTime | String | 币对维护时间(状态处于维护/即将维护时会有值) 未配置则返回: "" |
| isIsolatedBaseBorrowable | String | 逐仓左币是否可以借 仅适用于杠杆交易 |
| isIsolatedQuotedBorrowable | String | 逐仓右币是否可以借 仅适用于杠杆交易 |
| warningRiskRatio | String | 预警风险率 |
| liquidationRiskRatio | String | 强平风险率 |
| maxCrossedLeverage | String | 全仓最大杠杆倍数 仅适用于杠杆交易 |
| maxIsolatedLeverage | String | 逐仓最大杠杆倍数 仅适用于杠杆交易 |
| userMinBorrow | String | 最小可借 仅适用杠杆交易 |
| areaSymbol | String | 是否区域币对 YES NO 仅适用于现货交易 |
| maxMarketOrderQty | String | 单笔市价单最大下单数量 这指的是以基础币种下单时允许的最大数量 |