Get Instruments

Description

Query tradable CFD instrument information. Authentication is required to access this endpoint.

HTTP Request

• GET /api/v3/cfd/account/instruments
• Rate limit: 10/sec/UID
• Permission: UTA trade (read-only)

Request

curl "https://api.bitget.com/api/v3/cfd/account/instruments" \
  -H "ACCESS-KEY:your apiKey" \
  -H "ACCESS-SIGN:*" \
  -H "ACCESS-PASSPHRASE:*" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json"

Request Parameters

Parameters	Type	Required	Description
symbol	String	No	Trading pair name

Response

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1740000000000,
  "data": [
    {
      "symbol": "XAUUSD",
      "onlineTime": "1740000000000",
      "currency": "USD",
      "digits": "2",
      "spread": "3",
      "contractSize": "100",
      "marginCurrency": "USD",
      "profitCurrency": "USD",
      "stopLevel": "0",
      "enable": "2",
      "marginPercent": "1",
      "initialMargin": "200",
      "marginMode": "Forex",
      "maintMargin": "100",
      "maintMarginRateBuy": "0.002",
      "maintMarginRateSell": "0.002",
      "initialMarginRateBuy": "0.004",
      "initialMarginRateSell": "0.004",
      "maxVolume": "100",
      "minVolume": "0.01",
      "stepVolume": "0.01",
      "priceCurrency": "USD",
      "tickSize": "0.01",
      "tickValue": "1",
      "leverage": "500",
      "tradeTime": "24/5",
      "commissionType": "0",
      "commissionRate": "0",
      "symbolCategory": "XAUUSD",
      "exchangeRate": "1",
      "marginUsdRate": "1"
    }
  ]
}

Response Parameters

Parameters	Type	Description
symbol	String	Trading symbol
onlineTime	String	Time the instrument was added
currency	String	Base currency
digits	String	Number of price decimal places
spread	String	Spread
contractSize	String	Contract size
marginCurrency	String	Margin currency
profitCurrency	String	Profit currency
stopLevel	String	Stop level Same unit as the spread, denominated in the instrument's quote currency Minimum required distance between the stop-loss/take-profit price and the market price = stopLevel / 10^digits e.g., for XAUUSD, if stopLevel is 20 and digits is 2, the minimum required distance is 20 / 10^2 = 0.2 USD
enable	String	Whether trading is enabled 0: Trading disabled 1: Close-only 2: Trading enabled
marginPercent	String	Margin percentage
initialMargin	String	Initial margin
marginMode	String	Margin model Forex/CFD
maintMargin	String	Maintenance margin
maintMarginRateBuy	String	Maintenance margin rate for the buy side The reciprocal of leverage; e.g., if leverage is 500, this value is 0.002
maintMarginRateSell	String	Maintenance margin rate for the sell side The reciprocal of leverage; e.g., if leverage is 500, this value is 0.002
initialMarginRateBuy	String	Initial margin rate for the buy side
initialMarginRateSell	String	Initial margin rate for the sell side
maxVolume	String	Maximum tradable volume
minVolume	String	Minimum tradable volume
stepVolume	String	Volume step size
priceCurrency	String	Quote currency
tickSize	String	Minimum price increment
tickValue	String	Value of the minimum price increment
leverage	String	Leverage
tradeTime	String	Tradable hours
commissionType	String	Commission type 0: Charged per lot, e.g., 6 USD per lot 1: Charged as a percentage of trade value Only the ECN and Pro trading modes charge commission; the commission is always charged at order opening (not at closing), and is deducted directly from the account balance in USDT
commissionRate	String	Commission rate If charged per lot, this is the commission amount per lot (e.g., XAUUSD charges 6 USD per lot; opening 1 lot of XAUUSD deducts 6 USD from the account balance at opening) If charged as a percentage of trade value, this is a percentage value; the frontend should append a % sign Default 0 (zero-commission instruments do not call the commission endpoint and use this default value directly)
symbolCategory	String	Instrument category (the symbol name without its suffix) e.g., for XAUUSD.s, symbolCategory = "XAUUSD"; for XAUUSD, symbolCategory = "XAUUSD"
exchangeRate	String	Exchange rate of priceCurrency against USD
marginUsdRate	String	Exchange rate of marginCurrency against USD