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

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

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

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

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

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

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

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