Get Neutral Grid Bot Detail

Description

Query the detailed information of a specified neutral futures grid strategy, including parameter configuration, current status, and cumulative profit.

HTTP Request

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

Request

curl "https://api.bitget.com/api/v3/trade/grid/neutral-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 running: Running terminating: Terminating terminated: Terminated
totalProfit	String	Total profit, in USDT
roi	String	ROI, in decimal form
gridProfit	String	Grid profit, in USDT, equal to realized arbitrage profit minus fees
gridProfitRate	String	Grid profit rate, in decimal form
unpairedProfit	String	Unpaired profit, in USDT
unpairedProfitRate	String	Unpaired profit rate, in decimal form
margin	String	Margin (futures only)
arbitrageAPR	String	Arbitrage APR, in decimal form. If running for less than 1 day, calculated as 1 day
totalAPR	String	Total APR, in decimal form. If running for less than 1 day, calculated as 1 day
createdTime	String	Creation time
runningTime	String	Running time, in milliseconds
gridStartPrice	String	Grid start price
maxPrice	String	Upper limit price
minPrice	String	Lower limit price
gridNum	String	Number of grids
gridOrderMode	String	Grid order mode arithmetic: Arithmetic geometric: Geometric
triggerPrice	String	Trigger price
leverage	String	Leverage
stopLoss	String	Stop-loss price
takeProfit	String	Take-profit price
holdAveragePrice	String	Average holding price
holdPosition	String	Holding position
oneGridMinProfit	String	Minimum profit per grid
oneGridMaxProfit	String	Maximum profit per grid
autoTransferProfits	String	Auto transfer profit yes: Transfer out no: Do not transfer out