Validate Neutral Grid Parameters

Description

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.

HTTP Request

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

Request

curl -X POST "https://api.bitget.com/api/v3/trade/grid/validate-neutral" \
  -H "ACCESS-KEY:your apiKey" \
  -H "ACCESS-SIGN:*" \
  -H "ACCESS-PASSPHRASE:*" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json" \
  -d '{
  "category": "USDT-FUTURES",
  "symbol": "BTCUSDT",
  "maxPrice": "50000",
  "minPrice": "30000",
  "gridNum": "100",
  "gridOrderMode": "arithmetic",
  "leverage": "10",
  "investmentAmount": [
    {
      "coin": "USDT",
      "amount": "1000"
    }
  ],
  "triggerPrice": "40000",
  "stopLoss": "20000",
  "takeProfit": "60000",
  "autoTransferProfits": "yes"
}'

Request Parameters

Parameters	Type	Required	Description
category	String	Yes	Business line USDT-FUTURES: USDT-margined futures USDC-FUTURES: USDC-margined futures
symbol	String	Yes	Trading pair
maxPrice	String	Yes	Upper limit price
minPrice	String	Yes	Lower limit price
gridNum	String	Yes	Number of grids
gridOrderMode	String	Yes	Grid order mode arithmetic: Arithmetic geometric: Geometric
leverage	String	No	Leverage
investmentAmount	Array	No	List of investment coins and amounts. For futures, only quote coin USDT/USDC is supported
> coin	String	Yes	Investment coin
> amount	String	Yes	Investment amount
triggerPrice	String	No	Trigger price
stopLoss	String	No	Stop-loss price
takeProfit	String	No	Take-profit price
autoTransferProfits	String	No	Auto transfer profit

Response Parameters

Parameters	Type	Description
valid	String	Whether validation passed
reason	String	Reason for validation failure
minInvestment	String	Minimum investment amount