Grid Trading

Add Investment Amount

POST

https://api.bitget.com

/api/v3/trade/grid/add-investment

Add investment amount to a grid trading bot. Supports adding spot investment amount and adjusting futures margin.

Rate limit: 1/sec/UID
Permission: UTA trade (read & write)

Add Investment Amount › Request Parameters

category

string · required

Business line

botId

string · required

Grid bot ID. The business line must match the grid bot ID, otherwise an error will be returned

coin

string · required

Coin to add

size

string · required

Amount

fundsSource

string[] · required

Source of funds funding: Funding account uta: Unified account otc: OTC account

adjustType

string

Adjustment type. Only applicable to futures grid, required for futures increase decrease

reinvestProfit

string

Whether to reinvest profit, default yes. Only applicable to spot grid yes no

Add Investment Amount › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

botId

string

Grid bot ID

Get Grid Bot Detail

GET

https://api.bitget.com

/api/v3/trade/grid/bot-detail

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

Rate limit: 10/sec/UID
Permission: UTA trade (read-only)

Get Grid Bot Detail › Request Parameters

botId

string · required

Grid bot ID

Get Grid Bot Detail › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

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

object[]

Trigger parameters

triggerPrice

string

Trigger price

terminationCondition

string

Termination condition rsi boll

object[]

Termination parameters

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

GET/api/v3/trade/grid/bot-detail

curl 'https://api.bitget.com/api/v3/trade/grid/bot-detail?botId=<string>'

Example Responses

{
  "code": "00000",
  "msg": "success",
  "requestTime": 0,
  "data": {
    "botId": "botId",
    "symbol": "symbol",
    "status": "status",
    "totalProfit": "totalProfit",
    "roi": "roi",
    "gridProfit": "gridProfit",
    "gridProfitRate": "gridProfitRate",
    "unpairedProfit": "unpairedProfit",
    "unpairedProfitRate": "unpairedProfitRate",
    "margin": "margin",
    "arbitrageAPR": "arbitrageAPR",
    "totalAPR": "totalAPR",
    "createdTime": "createdTime",
    "runningTime": "runningTime",
    "currentBaseBalance": "currentBaseBalance",
    "currentQuoteBalance": "currentQuoteBalance",
    "initialBaseHoldings": "initialBaseHoldings",
    "initialQuoteHoldings": "initialQuoteHoldings",
    "reservedBaseTradingFee": "reservedBaseTradingFee",
    "reservedQuoteTradingFee": "reservedQuoteTradingFee",
    "gridStartPrice": "gridStartPrice",
    "gridType": "gridType",
    "maxPrice": "maxPrice",
    "minPrice": "minPrice",
    "gridNum": "gridNum",
    "gridOrderMode": "gridOrderMode",
    "baseInvestmentCoin": "baseInvestmentCoin",
    "baseInvestmentAmount": "baseInvestmentAmount",
    "quoteInvestmentCoin": "quoteInvestmentCoin",
    "quoteInvestmentAmount": "quoteInvestmentAmount",
    "slippage": "slippage",
    "triggerCondition": "triggerCondition",
    "triggerParams": [
      {
        "indicatorLength": "indicatorLength",
        "threshold": "threshold",
        "multiplier": "multiplier",
        "interval": "interval"
      }
    ],
    "triggerPrice": "triggerPrice",
    "terminationCondition": "terminationCondition",
    "terminationParams": [
      {
        "indicatorLength": "indicatorLength",
        "threshold": "threshold",
        "multiplier": "multiplier",
        "interval": "interval"
      }
    ],
    "terminationSell": "terminationSell",
    "stopLoss": "stopLoss",
    "takeProfit": "takeProfit",
    "hodlMode": "hodlMode",
    "autoTransferProfits": "autoTransferProfits",
    "arbitrageCount": "arbitrageCount",
    "terminationReason": "terminationReason"
  }
}

json

application/json

Close Grid Bot

POST

https://api.bitget.com

/api/v3/trade/grid/close-bot

Terminate a specified bot, stopping order placement and handling unfilled orders/positions according to the strategy configuration.

Rate limit: 1/sec/UID
Permission: UTA trade (read & write)

Close Grid Bot › Request Parameters

botId

string · required

Grid bot ID

Close Grid Bot › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

Response data

Create Grid Bot

POST

https://api.bitget.com

/api/v3/trade/grid/create-bot

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

Rate limit: 1/sec/UID
Permission: UTA trade (read & write)

Create Grid Bot › Request Parameters

category

string · required

Business line SPOT: Spot trading USDT-FUTURES: USDT-margined futures USDC-FUTURES: USDC-margined futures

symbol

string · required

Trading pair name

maxPrice

string · required

Grid upper limit price

minPrice

string · required

Grid lower limit price

gridNum

string · required

Number of grids

gridOrderMode

string · required

Grid order mode arithmetic: Arithmetic geometric: Geometric

object[] · required

Investment amount

fundsSource

string[] · required

Source of funds funding: Funding account uta: Unified account otc: OTC account

autoTransferProfits

string · required

Auto transfer profits, default no yes no

gridType

string

Grid direction long short netural Required for futures

leverage

string

Leverage, default 1. Only effective for futures

autoReserveMargin

string

Auto reserve margin

reservedMargin

string

Reserved margin. Only effective for futures

triggerCondition

string

Trigger condition, default instant instant price rsi boll

object[]

Trigger parameters

triggerPrice

string

Trigger price

terminationCondition

string

Termination condition rsi boll

object[]

Termination parameters

terminationSell

string

Whether to sell on termination. Only for spot grid yes no

stopLoss

string

Stop-loss price

takeProfit

string

Take-profit price

slippage

string

Slippage

trailingGrid

string

Trailing grid, default no yes no

movingAverageGains

string

Moving average gains

stopUpwardPrice

string

Stop upward price

hodlMode

string

HODL mode, default no. Only effective for spot yes no

marketOpen

string

Market open, default enabled. Only effective for futures yes no

lossReserve

string

Loss reserve, default enabled. Only effective for futures yes no

Create Grid Bot › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

botId

string

Grid bot ID

POST/api/v3/trade/grid/create-bot

curl https://api.bitget.com/api/v3/trade/grid/create-bot \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "category": "category",
  "symbol": "symbol",
  "gridType": "gridType",
  "maxPrice": "maxPrice",
  "minPrice": "minPrice",
  "gridNum": "gridNum",
  "gridOrderMode": "gridOrderMode",
  "leverage": "leverage",
  "investmentAmount": [
    {
      "coin": "coin",
      "amount": "amount"
    }
  ],
  "fundsSource": [
    "string"
  ],
  "autoReserveMargin": "autoReserveMargin",
  "reservedMargin": "reservedMargin",
  "triggerCondition": "triggerCondition",
  "triggerParams": [
    {
      "indicatorLength": "indicatorLength",
      "threshold": "threshold",
      "multiplier": "multiplier",
      "interval": "interval"
    }
  ],
  "triggerPrice": "triggerPrice",
  "terminationCondition": "terminationCondition",
  "terminationParams": [
    {
      "indicatorLength": "indicatorLength",
      "threshold": "threshold",
      "multiplier": "multiplier",
      "interval": "interval"
    }
  ],
  "terminationSell": "terminationSell",
  "stopLoss": "stopLoss",
  "takeProfit": "takeProfit",
  "slippage": "slippage",
  "trailingGrid": "trailingGrid",
  "movingAverageGains": "movingAverageGains",
  "stopUpwardPrice": "stopUpwardPrice",
  "hodlMode": "hodlMode",
  "marketOpen": "marketOpen",
  "lossReserve": "lossReserve",
  "autoTransferProfits": "autoTransferProfits"
}'

Example Request Body

{
  "category": "category",
  "symbol": "symbol",
  "gridType": "gridType",
  "maxPrice": "maxPrice",
  "minPrice": "minPrice",
  "gridNum": "gridNum",
  "gridOrderMode": "gridOrderMode",
  "leverage": "leverage",
  "investmentAmount": [
    {
      "coin": "coin",
      "amount": "amount"
    }
  ],
  "fundsSource": [
    "string"
  ],
  "autoReserveMargin": "autoReserveMargin",
  "reservedMargin": "reservedMargin",
  "triggerCondition": "triggerCondition",
  "triggerParams": [
    {
      "indicatorLength": "indicatorLength",
      "threshold": "threshold",
      "multiplier": "multiplier",
      "interval": "interval"
    }
  ],
  "triggerPrice": "triggerPrice",
  "terminationCondition": "terminationCondition",
  "terminationParams": [
    {
      "indicatorLength": "indicatorLength",
      "threshold": "threshold",
      "multiplier": "multiplier",
      "interval": "interval"
    }
  ],
  "terminationSell": "terminationSell",
  "stopLoss": "stopLoss",
  "takeProfit": "takeProfit",
  "slippage": "slippage",
  "trailingGrid": "trailingGrid",
  "movingAverageGains": "movingAverageGains",
  "stopUpwardPrice": "stopUpwardPrice",
  "hodlMode": "hodlMode",
  "marketOpen": "marketOpen",
  "lossReserve": "lossReserve",
  "autoTransferProfits": "autoTransferProfits"
}

json

Example Responses

{
  "code": "00000",
  "msg": "success",
  "requestTime": 0,
  "data": {
    "botId": "botId"
  }
}

json

application/json

Create Neutral Grid Bot

POST

https://api.bitget.com

/api/v3/trade/grid/create-neutral-bot

Submit a request to create a neutral futures grid trading bot.

Rate limit: 1/sec/UID
Permission: UTA trade (read & write)

Create Neutral Grid Bot › Request Parameters

category

string · required

Business line USDT-FUTURES: USDT-margined futures USDC-FUTURES: USDC-margined futures

symbol

string · required

Trading pair

maxPrice

string · required

Upper limit price

minPrice

string · required

Lower limit price

gridNum

string · required

Number of grids

gridOrderMode

string · required

Grid order mode arithmetic: Arithmetic geometric: Geometric

fundsSource

string[] · required

Source of funds funding: Funding account uta: UTA account otc: OTC account

leverage

string

Leverage

object[]

List of investment coins and amounts. For futures, only quote coin USDT/USDC is supported

triggerPrice

string

Trigger price

stopLoss

string

Stop-loss price

takeProfit

string

Take-profit price

autoTransferProfits

string

Auto transfer profit

Create Neutral Grid Bot › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

botId

string

Grid bot ID

POST/api/v3/trade/grid/create-neutral-bot

curl https://api.bitget.com/api/v3/trade/grid/create-neutral-bot \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "category": "category",
  "symbol": "symbol",
  "maxPrice": "maxPrice",
  "minPrice": "minPrice",
  "gridNum": "gridNum",
  "gridOrderMode": "gridOrderMode",
  "leverage": "leverage",
  "investmentAmount": [
    {
      "coin": "coin",
      "amount": "amount"
    }
  ],
  "triggerPrice": "triggerPrice",
  "stopLoss": "stopLoss",
  "takeProfit": "takeProfit",
  "autoTransferProfits": "autoTransferProfits",
  "fundsSource": [
    "string"
  ]
}'

Example Request Body

{
  "category": "category",
  "symbol": "symbol",
  "maxPrice": "maxPrice",
  "minPrice": "minPrice",
  "gridNum": "gridNum",
  "gridOrderMode": "gridOrderMode",
  "leverage": "leverage",
  "investmentAmount": [
    {
      "coin": "coin",
      "amount": "amount"
    }
  ],
  "triggerPrice": "triggerPrice",
  "stopLoss": "stopLoss",
  "takeProfit": "takeProfit",
  "autoTransferProfits": "autoTransferProfits",
  "fundsSource": [
    "string"
  ]
}

json

Example Responses

{
  "code": "00000",
  "msg": "success",
  "requestTime": 0,
  "data": {
    "botId": "botId"
  }
}

json

application/json

Get Grid Bot Order Details

GET

https://api.bitget.com

/api/v3/trade/grid/list-details

Query the order details associated with a specified strategy.

Rate limit: 1/sec/UID
Permission: UTA trade (read-only)

Get Grid Bot Order Details › Request Parameters

botId

string · required

Grid bot ID

Get Grid Bot Order Details › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

botId

string

Grid bot ID

symbol

string

Trading pair

object[]

Buy order list

object[]

Sell order list

Modify Grid Bot Parameters

POST

https://api.bitget.com

/api/v3/trade/grid/modify-bot

Modify the basic parameters (price range, investment amount, etc.) of a running grid trading bot.

Rate limit: 1/sec/UID
Permission: UTA trade (read & write)

Modify Grid Bot Parameters › Request Parameters

botId

string · required

Grid bot ID

takeProfit

string

Take-profit price. If not passed, the take-profit price will be cleared. If you do not want to modify the current take-profit price, pass in the current value

stopLoss

string

Stop-loss price. If not passed, the stop-loss price will be cleared. If you do not want to modify the current stop-loss price, pass in the current value

terminationCondition

string

Termination condition rsi boll

object[]

Termination parameters

hodlMode

string

HODL mode yes no

autoTransferProfits

string

Auto transfer profits yes: transfer out no: do not transfer out

Modify Grid Bot Parameters › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

botId

string

Grid bot ID

POST/api/v3/trade/grid/modify-bot

curl https://api.bitget.com/api/v3/trade/grid/modify-bot \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "botId": "botId",
  "takeProfit": "takeProfit",
  "stopLoss": "stopLoss",
  "terminationCondition": "terminationCondition",
  "terminationParams": [
    {
      "indicatorLength": "indicatorLength",
      "threshold": "threshold",
      "multiplier": "multiplier",
      "interval": "interval"
    }
  ],
  "hodlMode": "hodlMode",
  "autoTransferProfits": "autoTransferProfits"
}'

Example Request Body

{
  "botId": "botId",
  "takeProfit": "takeProfit",
  "stopLoss": "stopLoss",
  "terminationCondition": "terminationCondition",
  "terminationParams": [
    {
      "indicatorLength": "indicatorLength",
      "threshold": "threshold",
      "multiplier": "multiplier",
      "interval": "interval"
    }
  ],
  "hodlMode": "hodlMode",
  "autoTransferProfits": "autoTransferProfits"
}

json

Example Responses

{
  "code": "00000",
  "msg": "success",
  "requestTime": 0,
  "data": {
    "botId": "botId"
  }
}

json

application/json

Modify Grid Interval and Grid Number

POST

https://api.bitget.com

/api/v3/trade/grid/modify-grid-interval

Modify the grid price range and grid number.

Rate limit: 1/sec/UID
Permission: UTA trade (read & write)

Modify Grid Interval and Grid Number › Request Parameters

category

string · required

Business line SPOT: Spot trading USDT-FUTURES: USDT-margined futures USDC-FUTURES: USDC-margined futures

botId

string · required

Grid bot ID

maxPrice

string · required

Grid upper limit price

minPrice

string · required

Grid lower limit price

gridNum

string · required

Number of grids

Modify Grid Interval and Grid Number › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

botId

string

Grid bot ID

Modify Neutral Grid Bot Parameters

POST

https://api.bitget.com

/api/v3/trade/grid/modify-neutral-bot

Modify the basic parameters of a running neutral grid trading bot.

Rate limit: 1/sec/UID
Permission: UTA trade (read & write)

Modify Neutral Grid Bot Parameters › Request Parameters

botId

string · required

Grid bot ID

category

string · required

Business line USDT-FUTURES: USDT-margined futures USDC-FUTURES: USDC-margined futures

takeProfit

string

Take-profit price. If not passed, the take-profit price will be cleared. Pass the current value if no change is intended

stopLoss

string

Stop-loss price. If not passed, the stop-loss price will be cleared. Pass the current value if no change is intended

autoTransferProfits

string

Auto transfer profit yes: Transfer out no: Do not transfer out

Modify Neutral Grid Bot Parameters › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

botId

string

Grid bot ID

Modify Neutral Grid Interval and Grid Number

POST

https://api.bitget.com

/api/v3/trade/grid/modify-neutral-grid-interval

Modify the grid price range and number of grids.

Rate limit: 1/sec/UID
Permission: UTA trade (read & write)

Modify Neutral Grid Interval and Grid Number › Request Parameters

category

string · required

Business line USDT-FUTURES: USDT-margined futures USDC-FUTURES: USDC-margined futures

botId

string · required

Grid bot ID

maxPrice

string · required

Upper limit price

minPrice

string · required

Lower limit price

gridNum

string · required

Number of grids

Modify Neutral Grid Interval and Grid Number › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

botId

string

Grid bot ID

Get Neutral Grid Bot Detail

GET

https://api.bitget.com

/api/v3/trade/grid/neutral-bot-detail

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

Rate limit: 10/sec/UID
Permission: UTA trade (read-only)

Get Neutral Grid Bot Detail › Request Parameters

botId

string · required

Grid bot ID

Get Neutral Grid Bot Detail › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

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

GET/api/v3/trade/grid/neutral-bot-detail

curl 'https://api.bitget.com/api/v3/trade/grid/neutral-bot-detail?botId=<string>'

Example Responses

{
  "code": "00000",
  "msg": "success",
  "requestTime": 0,
  "data": {
    "botId": "botId",
    "symbol": "symbol",
    "status": "status",
    "totalProfit": "totalProfit",
    "roi": "roi",
    "gridProfit": "gridProfit",
    "gridProfitRate": "gridProfitRate",
    "unpairedProfit": "unpairedProfit",
    "unpairedProfitRate": "unpairedProfitRate",
    "margin": "margin",
    "arbitrageAPR": "arbitrageAPR",
    "totalAPR": "totalAPR",
    "createdTime": "createdTime",
    "runningTime": "runningTime",
    "gridStartPrice": "gridStartPrice",
    "maxPrice": "maxPrice",
    "minPrice": "minPrice",
    "gridNum": "gridNum",
    "gridOrderMode": "gridOrderMode",
    "triggerPrice": "triggerPrice",
    "leverage": "leverage",
    "stopLoss": "stopLoss",
    "takeProfit": "takeProfit",
    "holdAveragePrice": "holdAveragePrice",
    "holdPosition": "holdPosition",
    "oneGridMinProfit": "oneGridMinProfit",
    "oneGridMaxProfit": "oneGridMaxProfit",
    "autoTransferProfits": "autoTransferProfits"
  }
}

json

application/json

Get Neutral Grid Bot Order Details

GET

https://api.bitget.com

/api/v3/trade/grid/neutral-list-details

Query the order details associated with a specified neutral futures grid strategy.

Rate limit: 1/sec/UID
Permission: UTA trade (read-only)

Get Neutral Grid Bot Order Details › Request Parameters

botId

string · required

Grid bot ID

Get Neutral Grid Bot Order Details › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

botId

string

Grid bot ID

symbol

string

Trading pair

object[]

Buy order list

object[]

Sell order list

Validate Neutral Grid Parameters

POST

https://api.bitget.com

/api/v3/trade/grid/validate-neutral

Before creating a neutral grid strategy, validate whether the grid parameters (price range, number of grids, investment amount, etc.) are legal, without actually creating the strategy.

Rate limit: 1/sec/UID
Permission: UTA trade (read & write)

Validate Neutral Grid Parameters › Request Parameters

category

string · required

Business line USDT-FUTURES: USDT-margined futures USDC-FUTURES: USDC-margined futures

symbol

string · required

Trading pair

maxPrice

string · required

Upper limit price

minPrice

string · required

Lower limit price

gridNum

string · required

Number of grids

gridOrderMode

string · required

Grid order mode arithmetic: Arithmetic geometric: Geometric

leverage

string

Leverage

object[]

List of investment coins and amounts. For futures, only quote coin USDT/USDC is supported

triggerPrice

string

Trigger price

stopLoss

string

Stop-loss price

takeProfit

string

Take-profit price

autoTransferProfits

string

Auto transfer profit

Validate Neutral Grid Parameters › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

valid

string

Whether validation passed

reason

string

Reason for validation failure

minInvestment

string

Minimum investment amount

POST/api/v3/trade/grid/validate-neutral

curl https://api.bitget.com/api/v3/trade/grid/validate-neutral \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "category": "category",
  "symbol": "symbol",
  "maxPrice": "maxPrice",
  "minPrice": "minPrice",
  "gridNum": "gridNum",
  "gridOrderMode": "gridOrderMode",
  "leverage": "leverage",
  "investmentAmount": [
    {
      "coin": "coin",
      "amount": "amount"
    }
  ],
  "triggerPrice": "triggerPrice",
  "stopLoss": "stopLoss",
  "takeProfit": "takeProfit",
  "autoTransferProfits": "autoTransferProfits"
}'

Example Request Body

{
  "category": "category",
  "symbol": "symbol",
  "maxPrice": "maxPrice",
  "minPrice": "minPrice",
  "gridNum": "gridNum",
  "gridOrderMode": "gridOrderMode",
  "leverage": "leverage",
  "investmentAmount": [
    {
      "coin": "coin",
      "amount": "amount"
    }
  ],
  "triggerPrice": "triggerPrice",
  "stopLoss": "stopLoss",
  "takeProfit": "takeProfit",
  "autoTransferProfits": "autoTransferProfits"
}

json

Example Responses

{
  "code": "00000",
  "msg": "success",
  "requestTime": 0,
  "data": {
    "valid": "valid",
    "reason": "reason",
    "minInvestment": "minInvestment"
  }
}

json

application/json

Validate Grid Parameters

POST

https://api.bitget.com

/api/v3/trade/grid/validate

Before creating a grid strategy, validate whether the grid parameters (price range, grid number, investment amount, etc.) are legal. This does not actually create a strategy.

Rate limit: 1/sec/UID
Permission: UTA trade (read & write)

Validate Grid Parameters › Request Parameters

category

string · required

Business line SPOT: Spot trading USDT-FUTURES: USDT-margined futures USDC-FUTURES: USDC-margined futures

symbol

string · required

Trading pair name

maxPrice

string · required

Grid upper limit price

minPrice

string · required

Grid lower limit price

gridNum

string · required

Number of grids

gridOrderMode

string · required

Grid order mode arithmetic: Arithmetic geometric: Geometric

object[] · required

Investment amount

autoTransferProfits

string · required

Auto transfer profits, default no yes no

gridType

string

Grid direction long short netural Required for futures

leverage

string

Leverage, default 1. Only effective for futures

reservedMargin

string

Reserved margin. Only effective for futures

triggerCondition

string

Trigger condition, default instant instant price rsi boll

object[]

Trigger parameters

triggerPrice

string

Trigger price

terminationCondition

string

Termination condition rsi boll

object[]

Termination parameters

stopLoss

string

Stop-loss price

takeProfit

string

Take-profit price

trailingGrid

string

Trailing grid, default no yes no

movingAverageGains

string

Moving average gains

stopUpwardPrice

string

Stop upward price

hodlMode

string

HODL mode, default no. Only effective for spot yes no

marketOpen

string

Market open, default enabled. Only effective for futures yes no

lossReserve

string

Loss reserve, default enabled. Only effective for futures yes no

Validate Grid Parameters › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

valid

string

Whether the validation passed

reason

string

Reason for validation failure

minInvestment

string

Minimum investment amount

POST/api/v3/trade/grid/validate

curl https://api.bitget.com/api/v3/trade/grid/validate \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "category": "category",
  "symbol": "symbol",
  "gridType": "gridType",
  "maxPrice": "maxPrice",
  "minPrice": "minPrice",
  "gridNum": "gridNum",
  "gridOrderMode": "gridOrderMode",
  "leverage": "leverage",
  "investmentAmount": [
    {
      "coin": "coin",
      "amount": "amount"
    }
  ],
  "reservedMargin": "reservedMargin",
  "triggerCondition": "triggerCondition",
  "triggerParams": [
    {
      "indicatorLength": "indicatorLength",
      "threshold": "threshold",
      "multiplier": "multiplier",
      "interval": "interval"
    }
  ],
  "triggerPrice": "triggerPrice",
  "terminationCondition": "terminationCondition",
  "terminationParams": [
    {
      "indicatorLength": "indicatorLength",
      "threshold": "threshold",
      "multiplier": "multiplier",
      "interval": "interval"
    }
  ],
  "stopLoss": "stopLoss",
  "takeProfit": "takeProfit",
  "trailingGrid": "trailingGrid",
  "movingAverageGains": "movingAverageGains",
  "stopUpwardPrice": "stopUpwardPrice",
  "hodlMode": "hodlMode",
  "marketOpen": "marketOpen",
  "lossReserve": "lossReserve",
  "autoTransferProfits": "autoTransferProfits"
}'

Example Request Body

{
  "category": "category",
  "symbol": "symbol",
  "gridType": "gridType",
  "maxPrice": "maxPrice",
  "minPrice": "minPrice",
  "gridNum": "gridNum",
  "gridOrderMode": "gridOrderMode",
  "leverage": "leverage",
  "investmentAmount": [
    {
      "coin": "coin",
      "amount": "amount"
    }
  ],
  "reservedMargin": "reservedMargin",
  "triggerCondition": "triggerCondition",
  "triggerParams": [
    {
      "indicatorLength": "indicatorLength",
      "threshold": "threshold",
      "multiplier": "multiplier",
      "interval": "interval"
    }
  ],
  "triggerPrice": "triggerPrice",
  "terminationCondition": "terminationCondition",
  "terminationParams": [
    {
      "indicatorLength": "indicatorLength",
      "threshold": "threshold",
      "multiplier": "multiplier",
      "interval": "interval"
    }
  ],
  "stopLoss": "stopLoss",
  "takeProfit": "takeProfit",
  "trailingGrid": "trailingGrid",
  "movingAverageGains": "movingAverageGains",
  "stopUpwardPrice": "stopUpwardPrice",
  "hodlMode": "hodlMode",
  "marketOpen": "marketOpen",
  "lossReserve": "lossReserve",
  "autoTransferProfits": "autoTransferProfits"
}

json

Example Responses

{
  "code": "00000",
  "msg": "success",
  "requestTime": 0,
  "data": {
    "valid": "valid",
    "reason": "reason",
    "minInvestment": "minInvestment"
  }
}

json

application/json

Strategy Trading