市场行情数据

获取交易产品信息

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

最小下单额

单位：USDT

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 大宗

fullName

string

完整名称，包括交易对名称、企业名称、ETF名称等，可能带ADR/ST/QUANTO标识

例如symbol为SKHYUSDT，fullName为"SK Hylix ADR"

现货合约均有该字段

instrumentType

string

交易产品类型

metal 贵金属

energy 能源

stock 股票

etf ETF

crypto 加密货币

现货合约均有该字段

marketRegion

string

市场区域码

适用于传统金融相关的交易对

US 美国

CN 中国

HK 香港

KR 韩国

JP 日本

现货合约均有该字段

isin

string

国际证券识别码（ISIN），用来唯一标识股票、债券、基金、权证等金融证券的国际标准化代码

格式为：前两位为国家/地区代码，中间九位为本地证券识别码，最后一位为校验码

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",
      "fullName": "",
      "instrumentType": "crypto",
      "marketRegion": "",
      "isin": "",
      "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

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

获取深度数据

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时间戳，毫秒

获取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

https://api.bitget.com

/api/v3/market/fills

限频规则: 20次/秒/IP

查询平台近期公开成交数据，同时支持返回 rToken交易对的 Bitget 平台成交数据

成交历史数据可以通过我们官网下载。

获取平台近期成交数据 › 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 否

K线数据

GET

https://api.bitget.com

/api/v3/market/candles

限频规则: 20次/秒/IP

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

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

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)]

历史K线数据

GET

https://api.bitget.com

/api/v3/market/history-candles

限频规则: 20次/秒/IP

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

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

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

https://api.bitget.com

/api/v3/market/time

获取当前服务器时间。

限频规则: 20次/秒/IP

获取服务器时间 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

serverTime

string

服务器时间，Unix 毫秒时间戳，如 1690196141868

serverTimeMicros

string

服务器时间，Unix 微秒时间戳，如 1690196141868000

获取币种信息

GET

https://api.bitget.com

/api/v3/market/coins

获取币种信息，支持单个及全量查询。

限频规则: 20次/秒/IP

获取币种信息 › Request Parameters

coin

string

币种名称，如BTC

如不填写，默认返回全部币种信息

获取币种信息 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

coin

string

币种名称

transfer

string

是否可以划转

object[]

支持的链列表

GET/api/v3/market/coins

curl https://api.bitget.com/api/v3/market/coins

Example Responses

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1695799900330,
  "data": [
    {
      "coin": "BTC",
      "transfer": "true",
      "chains": [
        {
          "chain": "BTC",
          "needTag": "false",
          "withdrawable": "true",
          "rechargeable": "true",
          "withdrawFee": "0.005",
          "extraWithdrawFee": "0",
          "depositConfirm": "1",
          "withdrawConfirm": "1",
          "minDepositAmount": "0.001",
          "minWithdrawAmount": "0.001",
          "browserUrl": "https://blockchair.com/bitcoin/testnet/transaction/",
          "contractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
          "withdrawStep": "0",
          "withdrawPrecision": "8",
          "congestion": "normal"
        }
      ]
    }
  ]
}

json

application/json

获取公告

GET

https://api.bitget.com

/api/v3/public/annoucements

查询公告信息。

公告子类型说明（公告子类型与公告类型相对应）：

annType=latest_news
- announcements 最新公告
- news Bitget资讯
annType=coin_listings
- spot
- futures
- margin
- copy_trading
annType=product_updates
- spot
- futures
- margin
- copy_trading
annType=security
- security_information
annType=api_trading
- api_announcement
annType=symbol_delisting
- trading_pair_delisting
annType=maintenance_system_updates
- asset_maintenance
- system_updates
- spot_maintenance
- futures_maintenance
限频规则: 20次/秒/IP

获取公告 › Request Parameters

language

string · required

语言类型

zh_CN中文

en_US英文

如果传入的语言类型不支持，则返回英文

annType

string

公告类型

latest_news最新活动

coin_listings新币上线

product_updates产品更新

security安全

api_tradingAPI交易

maintenance_system_updates维护/系统升级

symbol_delisting下架资讯

startTime

string

查询的开始时间，Unix毫秒时间戳，例如1690196141868

按照公告展示时间查询

endTime

string

查询的结束时间，Unix毫秒时间戳，例如1690196141868

按照公告展示时间查询

cursor

string

游标ID

首次调用不需要，后续调用传上次响应中最后一个annId

limit

string

每页条目数

默认10条，最大10条

获取公告 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

annId

string

公告ID

annTitle

string

公告标题

language

string

语言类型

annUrl

string

链接

annType

string

公告类型

latest_news最新活动

coin_listings新币上线

product_updates产品更新

security安全

api_tradingAPI交易

maintenance_system_updates维护/系统升级

symbol_delisting下架资讯

annSubType

string

公告子类型

createdTime

string

公告发布时间

Unix毫秒时间戳

衍生品与资金费率