Bitget APIBitget API
UTAClassic
Legacy Doc
  • Overview
  • API Documentation
  • WebSocket
  • Agent Hub
  • SDK
  • Changelog
Copied to clipboard
API Document
Market Data
    Instruments
      Get InstrumentsgetGet RPI Symbolsget
    Ticker
      Get Tickersget
    Order Book
      Get Order BookgetGet RPI Order Bookget
    Fills
      Get Recent Public Fillsget
    Candles
      Get Kline/CandlestickgetGet Kline/Candlestick Historyget
Market Data
Market Data

Instruments

Market data APIs — Instruments


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/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

Ticker