Market Data

Get Instruments

GET

https://api.bitget.com

/api/v3/market/instruments

Rate limit: 20/sec/IP

Query the specifications for online trading pair instruments.

Get Instruments › Request Parameters

category

string · required

Product type

SPOT Spot trading

MARGIN Margin trading

USDT-FUTURES USDT futures

COIN-FUTURES Coin-M futures

USDC-FUTURES USDC futures

symbol

string

Symbol name, e.g. BTCUSDT

Get Instruments › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

category

string

Product type

SPOT Spot trading

MARGIN Margin trading

USDT-FUTURES USDT futures

COIN-FUTURES Coin-M futures

USDC-FUTURES USDC futures

symbol

string

Symbol name

isRwa

string

Is this an RWA symbol

YES / NO

Only for spot

isReality

string

Reality identifier

yes Reality stock token

no Non-Reality stock token

Only for spot

baseCoin

string

Base coin, e.g. BTC in BTCUSDT

quoteCoin

string

Quote coin, e.g. USDT in BTCUSDT

buyLimitPriceRatio

string

Buy price limit ratio

The ratio of the buy limit price to the market price, determining the maximum price at which a buy order will be placed

sellLimitPriceRatio

string

Sell price limit ratio

The ratio of the sell limit price to the market price, determining the minimum price at which a sell order will be placed

feeRateUpRatio

string

Fee markup ratio

The percentage by which the actual fee is increased relative to the base fee

Only for futures

makerFeeRate

string

Maker fee rate, in decimal form, e.g. 0.0002 represents 0.02%

Only for futures

takerFeeRate

string

Taker fee rate, in decimal form, e.g. 0.0002 represents 0.02%

Only for futures

openCostUpRatio

string

Opening cost markup ratio

The percentage by which the cost of opening a trading position is increased relative to the base or standard cost

Only for futures

minOrderQty

string

Minimum order quantity, in terms of the base coin

Only for futures; for spot/margin see Trading Rules

maxOrderQty

string

Maximum order quantity for a single limit order, in terms of the base coin

Only for futures; for spot/margin see Trading Rules. A value of 0 indicates no limit

pricePrecision

string

Price precision, the number of decimal places allowed for the price

quantityPrecision

string

Quantity precision, the number of decimal places allowed for the quantity

quotePrecision

string

Market order precision, the number of decimal places allowed for the price of the quote coin

priceMultiplier

string

Price multiplier, used for futures orders together with pricePrecision. e.g. pricePrecision 2 & priceMultiplier 0.02: the order price must be a multiple of priceMultiplier and have two decimal places

Only for futures

quantityMultiplier

string

Quantity multiplier, used for futures orders together with quantityPrecision

Only for futures

type

string

Futures type

perpetual Perpetual

delivery Delivery

Only for futures

minOrderAmount

string

Minimum order amount, in terms of the quote coin

maxSymbolOrderNum

string

Maximum order number in terms of the trading pair(deprecated, no such limit)

maxProductOrderNum

string

Maximum order number in terms of the product line

maxPositionNum

string

Maximum position number in terms of the trading pair

Only for futures/margin

status

string

Trading pair status

listed Listed (not yet open)

online Normal

limit_open Restrict opening positions

limit_close Restrict closing positions

offline Delisted/under maintenance

restrictedAPI API restricted

offTime

string

Trading halt time. If not configured, it returns ""

Only for futures

limitOpenTime

string

Restricted open time. If not configured, it returns ""; other values indicate symbol is under/expected maintenance and trading is prohibited after a specified time

Only for futures

deliveryTime

string

Delivery time

Only for deliveries

deliveryStartTime

string

Delivery start time

Only for deliveries

deliveryPeriod

string

Delivery period

this_quarter This quarter

next_quarter Next quarter

Only for deliveries

launchTime

string

Launch time, Unix millisecond timestamp indicating when the trading pair was launched

fundInterval

string

Funding interval

1 Every 1 hour

8 Every 8 hours

Only for futures

minLeverage

string

Minimum leverage

Only for futures

maxLeverage

string

Maximum leverage

Only for futures/margin

maintainTime

string

Maintenance time. If not configured, it returns ""

Only for futures

symbolType

string

Symbol type

crypto cryptocurrency

metal precious metals

stock stocks

commodity commodities

maxMarketOrderQty

string

Maximum order quantity for a single market order, in terms of the base coin

Only for futures

isIsolatedBaseBorrowable

string

Base coin borrowable status

Only for margin trading

isIsolatedQuotedBorrowable

string

Quote coin borrowable status

Only for margin trading

warningRiskRatio

string

Warning risk ratio

Only for margin trading

liquidationRiskRatio

string

Liquidation risk ratio

Only for margin trading

maxCrossedLeverage

string

Maximum leverage for cross margin

Only for margin trading

maxIsolatedLeverage

string

Maximum leverage for isolated margin

Only for margin trading

userMinBorrow

string

Minimum borrowable amount

Only for margin trading

areaSymbol

string

Area symbol YES/NO

Only for spot trading; only returned for pairs where the value is YES

maxMarketOrderAmount

string

Maximum order amount for a single market order This is only applicable for spot trading pairs. This parameter is not returned for futures trading pairs

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",
      "maxMarketOrderAmount": "1000000"
    }
  ]
}

json

application/json

Get RPI Symbols

GET

https://api.bitget.com

/api/v3/market/rpi-symbols

Rate limit: 10/sec/IP

Query the list of trading pairs that support RPI (Retail Price Improvement).

Get RPI Symbols › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

category

string

Business line

spot Spot

usdt-futures USDT futures

coin-futures Coin-M futures

usdc-futures USDC futures

symbol

string

Symbol that supports RPI

Get Tickers

GET

https://api.bitget.com

/api/v3/market/tickers

Rate limit: 20/sec/IP

Query real-time market data, including the latest price, 24-hour high/low, volume, bid, ask, and price change for available trading pairs.

Get Tickers › Request Parameters

category

string · required

Product type

SPOT Spot trading

USDT-FUTURES USDT futures

COIN-FUTURES Coin-M futures

USDC-FUTURES USDC futures

symbol

string

Symbol name, e.g. BTCUSDT

Get Tickers › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

symbol

string

Symbol name, e.g. BTCUSDT

category

string

Product type

SPOT Spot trading

USDT-FUTURES USDT futures

COIN-FUTURES Coin-M futures

USDC-FUTURES USDC futures

lastPrice

string

Latest price

openPrice24h

string

Market price 24 hours ago

lowPrice24h

string

Lowest price in the last 24 hours

highPrice24h

string

Highest price in the last 24 hours

ask1Price

string

Best ask price

bid1Price

string

Best bid price

bid1Size

string

Best bid quantity

ask1Size

string

Best ask quantity

price24hPcnt

string

24-hour price change percentage

turnover24h

string

24-hour turnover

volume24h

string

24-hour volume

indexPrice

string

Index price

Only for futures

markPrice

string

Mark price

Only for futures

fundingRate

string

Funding rate

Only for futures

openInterest

string

Open interest

Only for futures

deliveryStartTime

string

Delivery start time

Only for deliveries

deliveryTime

string

Delivery time

Only for deliveries

deliveryStatus

string

Delivery status

delivery_config_period New pair configuration

delivery_normal Trading

delivery_before 10 minutes before delivery, no new orders

delivery_period During delivery, no opening or closing of positions, and no order cancellation

Only for deliveries

platformTurnover24h

string

24-hour platform turnover

Only available for rtoken

ts

string

The timestamp that the system generated the data

A Unix timestamp in milliseconds

Get Order Book

GET

https://api.bitget.com

/api/v3/market/orderbook

Rate limit: 20/sec/IP

Query order book depth data.

Get Order Book › Request Parameters

category

string · required

Product type

SPOT Spot trading

USDT-FUTURES USDT futures

COIN-FUTURES Coin-M futures

USDC-FUTURES USDC futures

symbol

string · required

Symbol name, e.g. BTCUSDT

limit

string

Depth level. Default: 5. Maximum: 1000

Default: 5

Get Order Book › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

a

array

Sell (ask) depth. Sorted by price in ascending order.

Each entry: [price, quantity]

b

array

Buy (bid) depth. Sorted by price in descending order.

Each entry: [price, quantity]

ts

string

The timestamp that the system generated the data

A Unix timestamp in milliseconds

Get RPI Order Book

GET

https://api.bitget.com

/api/v3/market/rpi-orderbook

Rate limit: 10/sec/IP

Query RPI (Retail Price Improvement) order book depth data. This endpoint returns the full depth including both RPI and non-RPI quantities separately for each price level.

Get RPI Order Book › Request Parameters

category

string · required

Product type

SPOT Spot trading

USDT-FUTURES USDT futures

COIN-FUTURES Coin-M futures

USDC-FUTURES USDC futures

symbol

string · required

Symbol name, e.g. BTCUSDT

limit

string

Depth level

SPOT: Default 5, Maximum 1000

USDT-FUTURES, COIN-FUTURES, USDC-FUTURES: Default 5, Maximum 1000

Default: 5

Get RPI Order Book › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

a

array

Sell (ask) depth. Sorted by price in ascending order.

Each entry: [price, non-RPI quantity, RPI quantity]

b

array

Buy (bid) depth. Sorted by price in descending order.

Each entry: [price, non-RPI quantity, RPI quantity]

ts

string

The timestamp that the system generated the data

A Unix timestamp in milliseconds

Get Recent Public Fills

GET

https://api.bitget.com

/api/v3/market/fills

Rate limit: 20/sec/IP

Query recent public fill data on Bitget.

Get Recent Public Fills › Request Parameters

category

string · required

Product type

SPOT Spot trading

MARGIN Margin trading

USDT-FUTURES USDT futures

COIN-FUTURES Coin-M futures

USDC-FUTURES USDC futures

symbol

string · required

Symbol name, e.g. BTCUSDT

limit

string

Limit per page. Default: 100. Maximum: 100

Default: 100

Get Recent Public Fills › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

execId

string

Fill execution ID

execLinkId

string

Execution correlation ID

price

string

Fill price

size

string

Fill size

COIN-FUTURES: the unit is quote coin

Others: the unit is base coin

side

string

Trade side

sell / buy

ts

string

Fill timestamp

A Unix timestamp in milliseconds

isRPI

string

Whether it is an RPI fill

yes Yes

no No

Get Kline/Candlestick

GET

https://api.bitget.com

/api/v3/market/candles

Rate limit: 20/sec/IP

Query kline/candlestick data. This endpoint allows retrieving up to 1,000 candlesticks.

Notes for Reality stock (rtoken) symbols:

Only the market candlestick type is supported. Passing mark, index, or premium falls back to market without returning an error.
Only the 1m, 5m, 15m, 1H, 4H, 1D intervals are supported. Passing an unsupported interval returns a parameter error.

Get Kline/Candlestick › Request Parameters

category

string · required

Product type

SPOT Spot trading

USDT-FUTURES USDT futures

COIN-FUTURES Coin-M futures

USDC-FUTURES USDC futures

symbol

string · required

Symbol name, e.g. BTCUSDT

interval

string · required

Granularity

1m,3m,5m,15m,30m,1H,4H,6H,12H,1D

startTime

string

Start timestamp. A Unix millisecond timestamp, e.g. 1672410780000

endTime

string

End timestamp. A Unix millisecond timestamp, e.g. 1672410781000

type

string

Candlestick type

market, mark, index, premium. Default: market

Default: market

limit

string

Limit per page. Default: 1000. Maximum: 1000

Default: 1000

Get Kline/Candlestick › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

array

Each entry: [timestamp, open, high, low, close, base coin volume, quote coin turnover]

Get Kline/Candlestick History

GET

https://api.bitget.com

/api/v3/market/history-candles

Rate limit: 20/sec/IP

You can retrieve historical candlestick data from more than 90 days ago.

Note: If endTime goes past a candle interval boundary (even by 1 ms), the system may round up when calculating the number of candles, and the response may include one additional interval (i.e. the returned data may start one interval earlier).

Notes for Reality stock (rtoken) symbols:

Only the market candlestick type is supported. Passing mark, index, or premium falls back to market without returning an error.
Only the 1m, 5m, 15m, 1H, 4H, 1D intervals are supported. Passing an unsupported interval returns a parameter error.

Get Kline/Candlestick History › Request Parameters

category

string · required

Product type

SPOT Spot trading

USDT-FUTURES USDT futures

COIN-FUTURES Coin-M futures

USDC-FUTURES USDC futures

symbol

string · required

Symbol name, e.g. BTCUSDT

interval

string · required

Granularity

1m,3m,5m,15m,30m,1H,4H,6H,12H,1D

startTime

string

Start timestamp. A Unix millisecond timestamp, e.g. 1672410780000. Request data after this start time (the maximum time query range is 90 days)

endTime

string

End timestamp. A Unix millisecond timestamp, e.g. 1672410781000. Request data before this end time (the maximum time query range is 90 days)

type

string

Candlestick type

market, mark, index, premium. Default: market

Default: market

limit

string

Limit per page. Default: 100. Maximum: 100

Default: 100

Get Kline/Candlestick History › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

array

Each entry: [timestamp, open, high, low, close, base coin volume, quote coin turnover]

Derivatives & Funding Rate

Market

Market Data

Get Instruments

GET

https://api.bitget.com

/api/v3/market/instruments

Rate limit: 20/sec/IP

Query the specifications for online trading pair instruments.

Get Instruments › Request Parameters

category

string · required

Product type

SPOT Spot trading

MARGIN Margin trading

USDT-FUTURES USDT futures

COIN-FUTURES Coin-M futures

USDC-FUTURES USDC futures

symbol

string

Symbol name, e.g. BTCUSDT

Get Instruments › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

category

string

Product type

SPOT Spot trading

MARGIN Margin trading

USDT-FUTURES USDT futures

COIN-FUTURES Coin-M futures

USDC-FUTURES USDC futures

symbol

string

Symbol name

isRwa

string

Is this an RWA symbol

YES / NO

Only for spot

isReality

string

Reality identifier

yes Reality stock token

no Non-Reality stock token

Only for spot

baseCoin

string

Base coin, e.g. BTC in BTCUSDT

quoteCoin

string

Quote coin, e.g. USDT in BTCUSDT

buyLimitPriceRatio

string

Buy price limit ratio

The ratio of the buy limit price to the market price, determining the maximum price at which a buy order will be placed

sellLimitPriceRatio

string

Sell price limit ratio

The ratio of the sell limit price to the market price, determining the minimum price at which a sell order will be placed

feeRateUpRatio

string

Fee markup ratio

The percentage by which the actual fee is increased relative to the base fee

Only for futures

makerFeeRate

string

Maker fee rate, in decimal form, e.g. 0.0002 represents 0.02%

Only for futures

takerFeeRate

string

Taker fee rate, in decimal form, e.g. 0.0002 represents 0.02%

Only for futures

openCostUpRatio

string

Opening cost markup ratio

The percentage by which the cost of opening a trading position is increased relative to the base or standard cost

Only for futures

minOrderQty

string

Minimum order quantity, in terms of the base coin

Only for futures; for spot/margin see Trading Rules

maxOrderQty

string

Maximum order quantity for a single limit order, in terms of the base coin

Only for futures; for spot/margin see Trading Rules. A value of 0 indicates no limit

pricePrecision

string

Price precision, the number of decimal places allowed for the price

quantityPrecision

string

Quantity precision, the number of decimal places allowed for the quantity

quotePrecision

string

Market order precision, the number of decimal places allowed for the price of the quote coin

priceMultiplier

string

Price multiplier, used for futures orders together with pricePrecision. e.g. pricePrecision 2 & priceMultiplier 0.02: the order price must be a multiple of priceMultiplier and have two decimal places

Only for futures

quantityMultiplier

string

Quantity multiplier, used for futures orders together with quantityPrecision

Only for futures

type

string

Futures type

perpetual Perpetual

delivery Delivery

Only for futures

minOrderAmount

string

Minimum order amount, in terms of the quote coin

maxSymbolOrderNum

string

Maximum order number in terms of the trading pair(deprecated, no such limit)

maxProductOrderNum

string

Maximum order number in terms of the product line

maxPositionNum

string

Maximum position number in terms of the trading pair

Only for futures/margin

status

string

Trading pair status

listed Listed (not yet open)

online Normal

limit_open Restrict opening positions

limit_close Restrict closing positions

offline Delisted/under maintenance

restrictedAPI API restricted

offTime

string

Trading halt time. If not configured, it returns ""

Only for futures

limitOpenTime

string

Restricted open time. If not configured, it returns ""; other values indicate symbol is under/expected maintenance and trading is prohibited after a specified time

Only for futures

deliveryTime

string

Delivery time

Only for deliveries

deliveryStartTime

string

Delivery start time

Only for deliveries

deliveryPeriod

string

Delivery period

this_quarter This quarter

next_quarter Next quarter

Only for deliveries

launchTime

string

Launch time, Unix millisecond timestamp indicating when the trading pair was launched

fundInterval

string

Funding interval

1 Every 1 hour

8 Every 8 hours

Only for futures

minLeverage

string

Minimum leverage

Only for futures

maxLeverage

string

Maximum leverage

Only for futures/margin

maintainTime

string

Maintenance time. If not configured, it returns ""

Only for futures

symbolType

string

Symbol type

crypto cryptocurrency

metal precious metals

stock stocks

commodity commodities

maxMarketOrderQty

string

Maximum order quantity for a single market order, in terms of the base coin

Only for futures

isIsolatedBaseBorrowable

string

Base coin borrowable status

Only for margin trading

isIsolatedQuotedBorrowable

string

Quote coin borrowable status

Only for margin trading

warningRiskRatio

string

Warning risk ratio

Only for margin trading

liquidationRiskRatio

string

Liquidation risk ratio

Only for margin trading

maxCrossedLeverage

string

Maximum leverage for cross margin

Only for margin trading

maxIsolatedLeverage

string

Maximum leverage for isolated margin

Only for margin trading

userMinBorrow

string

Minimum borrowable amount

Only for margin trading

areaSymbol

string

Area symbol YES/NO

Only for spot trading; only returned for pairs where the value is YES

maxMarketOrderAmount

string

Maximum order amount for a single market order This is only applicable for spot trading pairs. This parameter is not returned for futures trading pairs

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",
      "maxMarketOrderAmount": "1000000"
    }
  ]
}

json

application/json

Get RPI Symbols

GET

https://api.bitget.com

/api/v3/market/rpi-symbols

Rate limit: 10/sec/IP

Query the list of trading pairs that support RPI (Retail Price Improvement).

Get RPI Symbols › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

category

string

Business line

spot Spot

usdt-futures USDT futures

coin-futures Coin-M futures

usdc-futures USDC futures

symbol

string

Symbol that supports RPI

Get Tickers

GET

https://api.bitget.com

/api/v3/market/tickers

Rate limit: 20/sec/IP

Query real-time market data, including the latest price, 24-hour high/low, volume, bid, ask, and price change for available trading pairs.

Get Tickers › Request Parameters

category

string · required

Product type

SPOT Spot trading

USDT-FUTURES USDT futures

COIN-FUTURES Coin-M futures

USDC-FUTURES USDC futures

symbol

string

Symbol name, e.g. BTCUSDT

Get Tickers › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

symbol

string

Symbol name, e.g. BTCUSDT

category

string

Product type

SPOT Spot trading

USDT-FUTURES USDT futures

COIN-FUTURES Coin-M futures

USDC-FUTURES USDC futures

lastPrice

string

Latest price

openPrice24h

string

Market price 24 hours ago

lowPrice24h

string

Lowest price in the last 24 hours

highPrice24h

string

Highest price in the last 24 hours

ask1Price

string

Best ask price

bid1Price

string

Best bid price

bid1Size

string

Best bid quantity

ask1Size

string

Best ask quantity

price24hPcnt

string

24-hour price change percentage

turnover24h

string

24-hour turnover

volume24h

string

24-hour volume

indexPrice

string

Index price

Only for futures

markPrice

string

Mark price

Only for futures

fundingRate

string

Funding rate

Only for futures

openInterest

string

Open interest

Only for futures

deliveryStartTime

string

Delivery start time

Only for deliveries

deliveryTime

string

Delivery time

Only for deliveries

deliveryStatus

string

Delivery status

delivery_config_period New pair configuration

delivery_normal Trading

delivery_before 10 minutes before delivery, no new orders

delivery_period During delivery, no opening or closing of positions, and no order cancellation

Only for deliveries

platformTurnover24h

string

24-hour platform turnover

Only available for rtoken

ts

string

The timestamp that the system generated the data

A Unix timestamp in milliseconds

Get Order Book

GET

https://api.bitget.com

/api/v3/market/orderbook

Rate limit: 20/sec/IP

Query order book depth data.

Get Order Book › Request Parameters

category

string · required

Product type

SPOT Spot trading

USDT-FUTURES USDT futures

COIN-FUTURES Coin-M futures

USDC-FUTURES USDC futures

symbol

string · required

Symbol name, e.g. BTCUSDT

limit

string

Depth level. Default: 5. Maximum: 1000

Default: 5

Get Order Book › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

a

array

Sell (ask) depth. Sorted by price in ascending order.

Each entry: [price, quantity]

b

array

Buy (bid) depth. Sorted by price in descending order.

Each entry: [price, quantity]

ts

string

The timestamp that the system generated the data

A Unix timestamp in milliseconds

Get RPI Order Book

GET

https://api.bitget.com

/api/v3/market/rpi-orderbook

Rate limit: 10/sec/IP

Query RPI (Retail Price Improvement) order book depth data. This endpoint returns the full depth including both RPI and non-RPI quantities separately for each price level.

Get RPI Order Book › Request Parameters

category

string · required

Product type

SPOT Spot trading

USDT-FUTURES USDT futures

COIN-FUTURES Coin-M futures

USDC-FUTURES USDC futures

symbol

string · required

Symbol name, e.g. BTCUSDT

limit

string

Depth level

SPOT: Default 5, Maximum 1000

USDT-FUTURES, COIN-FUTURES, USDC-FUTURES: Default 5, Maximum 1000

Default: 5

Get RPI Order Book › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

a

array

Sell (ask) depth. Sorted by price in ascending order.

Each entry: [price, non-RPI quantity, RPI quantity]

b

array

Buy (bid) depth. Sorted by price in descending order.

Each entry: [price, non-RPI quantity, RPI quantity]

ts

string

The timestamp that the system generated the data

A Unix timestamp in milliseconds

Get Recent Public Fills

GET

https://api.bitget.com

/api/v3/market/fills

Rate limit: 20/sec/IP

Query recent public fill data on Bitget.

Get Recent Public Fills › Request Parameters

category

string · required

Product type

SPOT Spot trading

MARGIN Margin trading

USDT-FUTURES USDT futures

COIN-FUTURES Coin-M futures

USDC-FUTURES USDC futures

symbol

string · required

Symbol name, e.g. BTCUSDT

limit

string

Limit per page. Default: 100. Maximum: 100

Default: 100

Get Recent Public Fills › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object[]

execId

string

Fill execution ID

execLinkId

string

Execution correlation ID

price

string

Fill price

size

string

Fill size

COIN-FUTURES: the unit is quote coin

Others: the unit is base coin

side

string

Trade side

sell / buy

ts

string

Fill timestamp

A Unix timestamp in milliseconds

isRPI

string

Whether it is an RPI fill

yes Yes

no No

Get Kline/Candlestick

GET

https://api.bitget.com

/api/v3/market/candles

Rate limit: 20/sec/IP

Query kline/candlestick data. This endpoint allows retrieving up to 1,000 candlesticks.

Notes for Reality stock (rtoken) symbols:

Only the market candlestick type is supported. Passing mark, index, or premium falls back to market without returning an error.
Only the 1m, 5m, 15m, 1H, 4H, 1D intervals are supported. Passing an unsupported interval returns a parameter error.

Get Kline/Candlestick › Request Parameters

category

string · required

Product type

SPOT Spot trading

USDT-FUTURES USDT futures

COIN-FUTURES Coin-M futures

USDC-FUTURES USDC futures

symbol

string · required

Symbol name, e.g. BTCUSDT

interval

string · required

Granularity

1m,3m,5m,15m,30m,1H,4H,6H,12H,1D

startTime

string

Start timestamp. A Unix millisecond timestamp, e.g. 1672410780000

endTime

string

End timestamp. A Unix millisecond timestamp, e.g. 1672410781000

type

string

Candlestick type

market, mark, index, premium. Default: market

Default: market

limit

string

Limit per page. Default: 1000. Maximum: 1000

Default: 1000

Get Kline/Candlestick › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

array

Each entry: [timestamp, open, high, low, close, base coin volume, quote coin turnover]

Get Kline/Candlestick History

GET

https://api.bitget.com

/api/v3/market/history-candles

Rate limit: 20/sec/IP

You can retrieve historical candlestick data from more than 90 days ago.

Notes for Reality stock (rtoken) symbols:

Only the market candlestick type is supported. Passing mark, index, or premium falls back to market without returning an error.
Only the 1m, 5m, 15m, 1H, 4H, 1D intervals are supported. Passing an unsupported interval returns a parameter error.

Get Kline/Candlestick History › Request Parameters

category

string · required

Product type

SPOT Spot trading

USDT-FUTURES USDT futures

COIN-FUTURES Coin-M futures

USDC-FUTURES USDC futures

symbol

string · required

Symbol name, e.g. BTCUSDT

interval

string · required

Granularity

1m,3m,5m,15m,30m,1H,4H,6H,12H,1D

startTime

string

Start timestamp. A Unix millisecond timestamp, e.g. 1672410780000. Request data after this start time (the maximum time query range is 90 days)

endTime

string

End timestamp. A Unix millisecond timestamp, e.g. 1672410781000. Request data before this end time (the maximum time query range is 90 days)

type

string

Candlestick type

market, mark, index, premium. Default: market

Default: market

limit

string

Limit per page. Default: 100. Maximum: 100

Default: 100

Get Kline/Candlestick History › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

array

Each entry: [timestamp, open, high, low, close, base coin volume, quote coin turnover]

Derivatives & Funding Rate