Create Grid Bot

Description

Submit a request to create a spot or futures grid trading bot.

HTTP Request

• POST /api/v3/trade/grid/create-bot
• Rate limit: 1/sec/UID
• Permission: UTA trade (read & write)

Request

curl "https://api.bitget.com/api/v3/trade/grid/create-bot" \
  -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
category	String	Yes	Business line SPOT: Spot trading USDT-FUTURES: USDT-margined futures USDC-FUTURES: USDC-margined futures
symbol	String	Yes	Trading pair name
gridType	String	No	Grid direction long short netural Required for futures
maxPrice	String	Yes	Grid upper limit price
minPrice	String	Yes	Grid lower limit price
gridNum	String	Yes	Number of grids
gridOrderMode	String	Yes	Grid order mode arithmetic: Arithmetic geometric: Geometric
leverage	String	No	Leverage, default 1. Only effective for futures
investmentAmount	Array	Yes	Investment amount
> coin	String	Yes	Coin
> amount	String	Yes	Amount
fundsSource	Array	Yes	Source of funds funding: Funding account uta: Unified account otc: OTC account
autoReserveMargin	String	No	Auto reserve margin
reservedMargin	String	No	Reserved margin. Only effective for futures
triggerCondition	String	No	Trigger condition, default instant instant price rsi boll
triggerParams	Array	No	Trigger parameters
> indicatorLength	String	No	Indicator length
> threshold	String	No	Threshold
> multiplier	String	No	Multiplier
> interval	String	No	Interval
triggerPrice	String	No	Trigger price
terminationCondition	String	No	Termination condition rsi boll
terminationParams	Array	No	Termination parameters
> indicatorLength	String	No	Indicator length
> threshold	String	No	Threshold
> multiplier	String	No	Multiplier
> interval	String	No	Interval
terminationSell	String	No	Whether to sell on termination. Only for spot grid yes no
stopLoss	String	No	Stop-loss price
takeProfit	String	No	Take-profit price
slippage	String	No	Slippage
trailingGrid	String	No	Trailing grid, default no yes no
movingAverageGains	String	No	Moving average gains
stopUpwardPrice	String	No	Stop upward price
hodlMode	String	No	HODL mode, default no. Only effective for spot yes no
marketOpen	String	No	Market open, default enabled. Only effective for futures yes no
lossReserve	String	No	Loss reserve, default enabled. Only effective for futures yes no
autoTransferProfits	String	Yes	Auto transfer profits, default no yes no

Response Parameters

Parameters	Type	Description
botId	String	Grid bot ID