Get Grid Bot Detail

Description

Query the detailed information of a specified strategy, including parameter configuration, current status, accumulated profit, etc.

HTTP Request

• GET /api/v3/trade/grid/bot-detail
• Rate limit: 10/sec/UID
• Permission: UTA trade (read-only)

Request

curl "https://api.bitget.com/api/v3/trade/grid/bot-detail?botId=11" \
  -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
botId	String	Yes	Grid bot ID

Response Parameters

Parameters	Type	Description
botId	String	Grid bot ID
symbol	String	Trading pair
status	String	Status init: Initializing waiting: Waiting to start running: Running terminating: Terminating terminated: Terminated
totalProfit	String	Total profit, in USDT
roi	String	ROI, in decimal form
gridProfit	String	Grid profit, in USDT
gridProfitRate	String	Grid profit rate
unpairedProfit	String	Unpaired profit, in USDT
unpairedProfitRate	String	Unpaired profit rate
margin	String	Margin, only for futures
arbitrageAPR	String	Arbitrage APR
totalAPR	String	Total APR
createdTime	String	Creation time
runningTime	String	Running duration, in ms
currentBaseBalance	String	Current base coin balance
currentQuoteBalance	String	Current quote coin balance
initialBaseHoldings	String	Initial base coin holdings
initialQuoteHoldings	String	Initial quote coin holdings
reservedBaseTradingFee	String	Reserved base coin trading fee
reservedQuoteTradingFee	String	Reserved quote coin trading fee
gridStartPrice	String	Grid start price
gridType	String	Grid type long short netural
maxPrice	String	Grid upper limit price
minPrice	String	Grid lower limit price
gridNum	String	Number of grids
gridOrderMode	String	Grid order mode arithmetic geometric
baseInvestmentCoin	String	Base coin of investment
baseInvestmentAmount	String	Base coin investment amount
quoteInvestmentCoin	String	Quote coin of investment
quoteInvestmentAmount	String	Quote coin investment amount
slippage	String	Slippage 1% 2% none
triggerCondition	String	Trigger condition instant price rsi boll
triggerParams	Array	Trigger parameters
> indicatorLength	String	Indicator period
> threshold	String	Threshold
> multiplier	String	Multiplier
> interval	String	Interval
triggerPrice	String	Trigger price
terminationCondition	String	Termination condition rsi boll
terminationParams	Array	Termination parameters
> indicatorLength	String	Indicator period
> threshold	String	Threshold
> multiplier	String	Multiplier
> interval	String	Interval
terminationSell	String	Whether to sell on termination yes no
stopLoss	String	Stop-loss price
takeProfit	String	Take-profit price
hodlMode	String	HODL mode yes no
autoTransferProfits	String	Auto transfer profit yes no