Bitget APIBitget API
统一账户经典账户
旧文档
  • 概览
  • API 文档
  • WebSocket
  • Agent Hub
  • SDK
  • 更新日志
Copied to clipboard
行情
    市场行情数据
      获取交易产品信息get获取RPI交易对列表get获取行情数据get获取深度数据get获取RPI深度数据get获取平台近期成交数据getK线数据get历史K线数据get
    衍生品与资金费率
      获取未平仓合约持仓量(OI)get获取历史爆仓数据get实时资金费率get历史资金费率get获取指数价格成分get
    公共配置
      获取储备金证明get获取做市分数权重get获取机构费率分组get获取现金派息记录get获取拆合股记录get
    交易与风控规则
      获取风险准备金(天)get获取风险准备金(小时)get获取当前全部风险准备金get获取杠杆借币信息get获取仓位档位信息get获取合约OI限仓信息get获取币种折扣率get
    交易统计数据
      获取现货大户净流入信息get获取现货资金流向信息get获取现货24小时资金净流入信息get获取杠杆多空对比信息get获取杠杆借贷存量增速信息get获取杠杆逐仓借贷比信息get获取合约主动买卖量信息get获取合约多空比信息get获取合约大户持仓量多空比信息get获取合约大户账户多空比信息get
行情
行情

市场行情数据

市场行情数据


获取交易产品信息

GET
https://api.bitget.com
/api/v3/market/instruments

限频规则: 20次/秒/IP

查询在线交易币对信息

获取交易产品信息 › Request Parameters

category
​string · required

产品类型 SPOT 现货交易 MARGIN 杠杆 USDT-FUTURES U本位合约 COIN-FUTURES 币本位合约 USDC-FUTURES USDC合约

symbol
​string

交易对名称,例如:BTCUSDT

获取交易产品信息 › Response Parameters

200

成功响应

code
​string
msg
​string
requestTime
​integer
​object[]
category
​string

产品类型 SPOT 现货交易 MARGIN 杠杆交易 USDT-FUTURES U本位合约 COIN-FUTURES 币本位合约 USDC-FUTURES USDC合约

symbol
​string

交易对名称

isRwa
​string

是否为RWA交易对 YES 是 NO 否 仅现货返回

isReality
​string

Reality标识 yes Reality股票代币 no 非Reality股票代币 仅现货返回

baseCoin
​string

交易币种,例如:BTCUSDT中的BTC

quoteCoin
​string

计价币种,例如:BTCUSDT中的USDT

buyLimitPriceRatio
​string

买价限价比例 买入限价与市场价格的比率,决定买单下单时的最高价格

sellLimitPriceRatio
​string

卖价限价比例 卖出限价与市场价格的比率,决定卖单下单时的最低价格

feeRateUpRatio
​string

手续费上浮比例 实际费用相对于基础费用增加的百分比 仅合约返回

makerFeeRate
​string

挂单手续费率,小数形式,即0.0002代表万分之二 仅合约返回

takerFeeRate
​string

吃单手续费率,小数形式,即0.0002代表万分之二 仅合约返回

openCostUpRatio
​string

开仓成本上浮比例 开仓的成本相对于基础或标准成本增加的百分比 仅合约返回

minOrderQty
​string

最小开单数量,以基础币种计 仅适用于合约交易,现货/杠杆请参考交易规则

maxOrderQty
​string

单笔限价单最大下单数量,以基础币种计 仅适用于合约交易,现货/杠杆请参考交易规则;为0表示不限制

pricePrecision
​string

价格精度,价格允许的小数位数

quantityPrecision
​string

数量精度,数量允许的小数位数

quotePrecision
​string

市价下单精度,计价币价格允许的小数位数

priceMultiplier
​string

价格乘数,合约下单使用,配合pricePrecision 仅合约返回

quantityMultiplier
​string

数量乘数,合约下单使用,配合quantityPrecision 仅合约返回

type
​string

合约类型 perpetual 永续 delivery 交割 仅合约返回

minOrderAmount
​string

最小下单额,以计价币种计

maxSymbolOrderNum
​string

交易对维度最大委托数量(废弃,无此限制)

maxProductOrderNum
​string

业务线维度最大委托数量

maxPositionNum
​string

最大持有仓位数量(交易对维度) 仅合约/杠杆返回

status
​string

交易对状态 listed 上架(未开盘) online 正常交易/开盘 limit_open 限制交易(合约禁止开仓) limit_close 限制交易(合约禁止平仓) offline 下架/维护 restrictedAPI API限制下单

offTime
​string

停盘时间,未配置则返回"" 仅合约返回

limitOpenTime
​string

限制开仓时间,未配置则返回"";其它值表示symbol正在/计划维护,指定时间后禁止交易 仅合约返回

deliveryTime
​string

交割时间 仅交割合约返回

deliveryStartTime
​string

交割币对开始时间 仅交割合约返回

deliveryPeriod
​string

交割周期 this_quarter 当季 next_quarter 次季 仅交割合约返回

launchTime
​string

上线时间,Unix毫秒时间戳,表示交易对的上线时间

fundInterval
​string

资金费结算周期 1 每小时 8 每8小时 仅合约返回

minLeverage
​string

最小杠杆 仅合约返回

maxLeverage
​string

最大杠杆 仅合约/杠杆返回

maintainTime
​string

币对维护时间(状态处于维护/即将维护时会有值),未配置则返回"" 仅合约返回

symbolType
​string

交易对类别 crypto 加密货币 metal 贵金属 stock 股票 commodity 大宗

maxMarketOrderQty
​string

单笔市价单最大下单数量,以基础币种计 仅合约返回

isIsolatedBaseBorrowable
​string

逐仓左币是否可以借 仅适用于杠杆交易

isIsolatedQuotedBorrowable
​string

逐仓右币是否可以借 仅适用于杠杆交易

warningRiskRatio
​string

预警风险率 仅适用于杠杆交易

liquidationRiskRatio
​string

强平风险率 仅适用于杠杆交易

maxCrossedLeverage
​string

全仓最大杠杆倍数 仅适用于杠杆交易

maxIsolatedLeverage
​string

逐仓最大杠杆倍数 仅适用于杠杆交易

userMinBorrow
​string

最小可借 仅适用杠杆交易

areaSymbol
​string

是否区域币对 YES/NO 仅适用于现货交易,只有为YES的币对才返回该参数

GET/api/v3/market/instruments
curl 'https://api.bitget.com/api/v3/market/instruments?category=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1770531248742, "data": [ { "symbol": "BTCUSDT", "category": "SPOT", "baseCoin": "BTC", "quoteCoin": "USDT", "isRwa": "NO", "isReality": "no", "buyLimitPriceRatio": "0.02", "sellLimitPriceRatio": "0.02", "minOrderQty": "0.000001", "maxOrderQty": "0", "pricePrecision": "2", "quantityPrecision": "6", "quotePrecision": "8", "minOrderAmount": "1", "maxSymbolOrderNum": "", "maxProductOrderNum": "400", "status": "online", "maintainTime": "", "maxPositionNum": "200", "symbolType": "crypto", "launchTime": "1532454360000" } ] }
json
application/json

获取RPI交易对列表

GET
https://api.bitget.com
/api/v3/market/rpi-symbols

限频规则: 10次/秒/IP

查询支持RPI(零售价格优化)的交易对列表

获取RPI交易对列表 › Response Parameters

200

成功响应

code
​string
msg
​string
requestTime
​integer
​object[]
category
​string

业务线 spot 现货 usdt-futures U本位合约 coin-futures 币本位合约 usdc-futures USDC合约

symbol
​string

支持RPI的交易对

GET/api/v3/market/rpi-symbols
curl https://api.bitget.com/api/v3/market/rpi-symbols
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1740000000000, "data": [ { "category": "spot", "symbol": "BTCUSDT" }, { "category": "usdt-futures", "symbol": "BTCUSDT" } ] }
json
application/json

获取行情数据

GET
https://api.bitget.com
/api/v3/market/tickers

限频规则: 20次/秒/IP

查询实时市场数据,包括最新成交价格、24小时最高/最低价格、成交量、买一、卖一和交易对的价格变化。

获取行情数据 › Request Parameters

category
​string · required

产品类型 SPOT 现货交易 USDT-FUTURES U本位合约 COIN-FUTURES 币本位合约 USDC-FUTURES USDC合约

symbol
​string

交易对名称,例如:BTCUSDT

获取行情数据 › Response Parameters

200

成功响应

code
​string
msg
​string
requestTime
​integer
​object[]
symbol
​string

交易对名称,例如:BTCUSDT

category
​string

产品类型 SPOT 现货交易 USDT-FUTURES U本位合约 COIN-FUTURES 币本位合约 USDC-FUTURES USDC合约

lastPrice
​string

最新价

openPrice24h
​string

24小时前的市场价格

lowPrice24h
​string

最近24小时最低价

highPrice24h
​string

最近24小时最高价

ask1Price
​string

卖一价格

bid1Price
​string

买一价格

bid1Size
​string

买一数量

ask1Size
​string

卖一数量

price24hPcnt
​string

24小时价格涨跌幅

turnover24h
​string

24小时成交额

volume24h
​string

24小时成交量

indexPrice
​string

指数价格 仅适用于合约

markPrice
​string

标记价格 仅适用于合约

fundingRate
​string

当前资金费率 仅适用于合约

openInterest
​string

当前币对平台总持仓量 仅适用于合约

deliveryStartTime
​string

交割开始时间 仅适用于交割币对

deliveryTime
​string

交割时间 仅适用于交割币对

deliveryStatus
​string

交割状态(只有币对进入交割时才有值) delivery_config_period 新上币对配置中 delivery_normal 交易中 delivery_before 交割前10分钟,禁止开仓 delivery_period 交割中,禁止开平仓、撤单 仅适用于交割币对

platformTurnover24h
​string

24小时平台成交额 仅rtoken有值

ts
​string

系统生成数据时的时间戳,Unix时间戳,毫秒

GET/api/v3/market/tickers
curl 'https://api.bitget.com/api/v3/market/tickers?category=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1765444397411, "data": [ { "category": "SPOT", "symbol": "BTCUSDT", "lastPrice": "90253.5", "openPrice24h": "92590.86", "highPrice24h": "94475.75", "lowPrice24h": "89394.71", "ask1Price": "90253.5", "bid1Price": "90253.49", "bid1Size": "2.368684", "ask1Size": "0.402938", "price24hPcnt": "-0.02524", "volume24h": "7386.014738", "turnover24h": "677732572.225658", "platformTurnover24h": "677732572.225658", "ts": "1765444395778" } ] }
json
application/json

获取深度数据

GET
https://api.bitget.com
/api/v3/market/orderbook

限频规则: 20次/秒/IP

查询订单簿深度数据

获取深度数据 › Request Parameters

category
​string · required

产品类型 SPOT 现货交易 USDT-FUTURES U本位合约 COIN-FUTURES 币本位合约 USDC-FUTURES USDC合约

symbol
​string · required

交易对名称

limit
​string

深度档位,默认值:5,最大:1000

Default: 5

获取深度数据 › Response Parameters

200

成功响应

code
​string
msg
​string
requestTime
​integer
​object
a
​array

卖方深度,按价格升序排序。 每项:[价格, 数量]

b
​array

买方深度,按价格降序排序。 每项:[价格, 数量]

ts
​string

系统生成数据时的时间戳,Unix时间戳,毫秒

GET/api/v3/market/orderbook
curl 'https://api.bitget.com/api/v3/market/orderbook?category=<string>&symbol=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1730969017897, "data": { "a": [ [ 73000, 0.007 ], [ 74000, 0.007 ], [ 75000, 0.007 ], [ 75123, 5.615 ] ], "b": [ [ 71213.8, 1.836 ], [ 71213.3, 10 ], [ 71212.8, 10 ] ], "ts": "1730969017964" } }
json
application/json

获取RPI深度数据

GET
https://api.bitget.com
/api/v3/market/rpi-orderbook

限频规则: 10次/秒/IP

查询RPI(零售价格优化)订单簿深度数据。该接口返回包含RPI和非RPI数量分别展示的完整深度数据。

获取RPI深度数据 › Request Parameters

category
​string · required

产品类型 SPOT 现货交易 USDT-FUTURES U本位合约 COIN-FUTURES 币本位合约 USDC-FUTURES USDC合约

symbol
​string · required

交易对名称,例如:BTCUSDT

limit
​string

深度档位 SPOT:默认值5,最大1000 USDT-FUTURES、COIN-FUTURES、USDC-FUTURES:默认值5,最大1000

Default: 5

获取RPI深度数据 › Response Parameters

200

成功响应

code
​string
msg
​string
requestTime
​integer
​object
a
​array

卖方深度,按价格升序排序。 每项:[价格, 非RPI数量, RPI数量]

b
​array

买方深度,按价格降序排序。 每项:[价格, 非RPI数量, RPI数量]

ts
​string

系统生成数据时的时间戳,Unix时间戳,毫秒

GET/api/v3/market/rpi-orderbook
curl 'https://api.bitget.com/api/v3/market/rpi-orderbook?category=<string>&symbol=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1730969017897, "data": { "a": [ [ 3366.8, 9, 1 ], [ 3367, 0, 1 ], [ 3368, 8, 2 ] ], "b": [ [ 3366.1, 7, 1 ], [ 3366, 6, 1 ] ], "ts": "1730969017964" } }
json
application/json

获取平台近期成交数据

GET
https://api.bitget.com
/api/v3/market/fills

限频规则: 20次/秒/IP

查询平台近期公开成交数据

获取平台近期成交数据 › Request Parameters

category
​string · required

产品类型 SPOT 现货交易 MARGIN 杠杆 USDT-FUTURES U本位合约 COIN-FUTURES 币本位合约 USDC-FUTURES USDC合约

symbol
​string · required

交易对名称,例如:BTCUSDT

limit
​string

每页条目数,默认值为100,最大值为100

Default: 100

获取平台近期成交数据 › Response Parameters

200

成功响应

code
​string
msg
​string
requestTime
​integer
​object[]
execId
​string

成交ID

execLinkId
​string

成交关联ID

price
​string

成交价格

size
​string

成交数量 币本位合约:单位为quote coin 其他:单位为base coin

side
​string

交易方向 buy 买入 sell 卖出

ts
​string

成交时间,Unix毫秒时间戳

isRPI
​string

是否为RPI类型成交 yes 是 no 否

GET/api/v3/market/fills
curl 'https://api.bitget.com/api/v3/market/fills?category=<string>&symbol=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1690313813709, "data": [ { "execId": "1", "execLinkId": "12345877111", "price": "29990.5", "size": "0.0166", "side": "sell", "ts": "1627116776464", "isRPI": "no" }, { "execId": "2", "execLinkId": "12345877112", "price": "30007.0", "size": "0.0166", "side": "buy", "ts": "1627116600875", "isRPI": "yes" } ] }
json
application/json

K线数据

GET
https://api.bitget.com
/api/v3/market/candles

限频规则: 20次/秒/IP

获取K线数据,该接口可查询指定交易对和粒度的最近1000条数据

Reality 股票(rtoken)symbol 说明:

  • K线类型仅支持 market(市场成交价K线)。传入 mark、index、premium 时默认走 market,不报错。
  • 仅支持 1m、5m、15m、1H、4H、1D 时间粒度,传入不支持的粒度将返回参数错误。

K线数据 › Request Parameters

category
​string · required

产品类型 SPOT 现货交易 USDT-FUTURES U本位合约 COIN-FUTURES 币本位合约 USDC-FUTURES USDC合约

symbol
​string · required

交易对名称,例如:BTCUSDT

interval
​string · required

时间粒度 1m,3m,5m,15m,30m,1H,4H,6H,12H,1D

startTime
​string

开始时间,即查询该时间之后的K线,Unix时间戳的毫秒数格式,如1672410780000

endTime
​string

结束时间,即查询该时间之前的K线,Unix时间戳的毫秒数格式,如1672410781000

type
​string

K线类型 market 行情;mark 标记;index 指数;premium 溢价 默认 market

Default: market
limit
​string

每页条目数,默认值为1000,最大值为1000

Default: 1000

K线数据 › Response Parameters

200

成功响应

code
​string
msg
​string
requestTime
​integer
data
​array

每项:[时间戳, 开盘价, 最高价, 最低价, 收盘价, 交易币成交量(base coin), 计价币成交量(quote coin)]

GET/api/v3/market/candles
curl 'https://api.bitget.com/api/v3/market/candles?category=<string>&symbol=<string>&interval=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1695865864944, "data": [ [ "1687708800000", "27176.93", "27177.43", "27166.93", "27177.43", "2990.08", "81246917.3294" ], [ "1688313600000", "27177.43", "27177.43", "24000", "24001", "2989.1", "72450031.0448" ] ] }
json
application/json

历史K线数据

GET
https://api.bitget.com
/api/v3/market/history-candles

限频规则: 20次/秒/IP

可以获取90天以前的历史K线数据

注意:如果endTime超出某个K线周期边界(哪怕仅1ms),系统可能会按周期向上取整计算数量,返回结果会额外包含该周期的一根K线(即数据起点可能会提前一个周期)。

Reality 股票(rtoken)symbol 说明:

  • K线类型仅支持 market(市场成交价K线)。传入 mark、index、premium 时默认走 market,不报错。
  • 仅支持 1m、5m、15m、1H、4H、1D 时间粒度,传入不支持的粒度将返回参数错误。

历史K线数据 › Request Parameters

category
​string · required

产品类型 SPOT 现货交易 USDT-FUTURES U本位合约 COIN-FUTURES 币本位合约 USDC-FUTURES USDC合约

symbol
​string · required

交易币对,例如:BTCUSDT

interval
​string · required

时间粒度 1m,3m,5m,15m,30m,1H,4H,6H,12H,1D

startTime
​string

开始时间,即查询该时间之后的K线,Unix时间戳的毫秒数格式,如1672410780000。请求在此开始时间之后的数据(最大时间查询范围为90天)

endTime
​string

结束时间,即查询该时间之前的K线,Unix时间戳的毫秒数格式,如1672410781000。请求在此结束时间之前的数据(最大时间查询范围为90天)

type
​string

K线类型 market 行情;mark 标记;index 指数;premium 溢价 默认 market

Default: market
limit
​string

每页条目数,默认值为100,最大值为100

Default: 100

历史K线数据 › Response Parameters

200

成功响应

code
​string
msg
​string
requestTime
​integer
data
​array

每项:[时间戳, 开盘价, 最高价, 最低价, 收盘价, 交易币成交量(base coin), 计价币成交量(quote coin)]

GET/api/v3/market/history-candles
curl 'https://api.bitget.com/api/v3/market/history-candles?category=<string>&symbol=<string>&interval=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1695865864944, "data": [ [ "1687708800000", "27176.93", "27177.43", "27166.93", "27177.43", "2990.08", "81246917.3294" ], [ "1688313600000", "27177.43", "27177.43", "24000", "24001", "2989.1", "72450031.0448" ] ] }
json
application/json

衍生品与资金费率