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
arbitrageCount	String	Arbitrage count
terminationReason	String	Termination reason MANUAL_END: Manually terminated NEW_WAIT: Waiting to start ACCOUNT_BALANCE_LACKING_END: Terminated due to insufficient available funds STOP_PROFIT_END: Terminated by take-profit STOP_LOSS_END: Terminated by stop-loss CANCEL_END: Terminated by cancellation SYSTEM_END: Cancelled due to order placement failure FOLLOW_END: Terminated by follow SUBSCRIBE_STOP_PROFIT_END: Terminated by subscription take-profit SUBSCRIBE_STOP_LOSS_END: Terminated by subscription stop-loss PLACE_ORDER_FAIL_END: Terminated by consecutive order placement failures SYMBOL_DOWN_END: Terminated due to trading pair delisting SUB_ACCOUNT_TRANSFER_FAIL: Terminated due to fund transfer failure HIGHEST_PRICE_END: Terminated at highest price BOTTOM_PRICE_END: Terminated at lowest price BURST_END: Terminated by liquidation MOVE_GRID_FAIL: Terminated due to grid move failure EXPIRE_TIME_END: Terminated by scheduled expiration HANDLE_SUB_POSITION_END: Terminated by manual position reduction STOP_PRICE_ACHIEVE: Terminated upon reaching stop price ADL_END: Terminated by ADL AUTO_CONVERT_END: Terminated by auto-conversion CONDITION_TRIGGER_END: Terminated by condition trigger ADL_CONVERT_END: Terminated by ADL reduction CANCEL_DELIVERY_ORDER: Cancelled due to delivery BASIS_RATE_TRIGGER: Terminated by basis rate trigger EARN_REDEEM_FAIL: Terminated due to earn redemption failure SYSTEM_CANCEL: Cancelled by system SYMBOL_RSTOCK_SPLIT: Cancelled due to stock split/reverse split