网格交易

追加投资额

POST

https://api.bitget.com

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

交易机器人投资追加金额，支持追加现货金额及合约调整保证金。

限频规则: 1次/秒/UID
需要统一账户交易权限

追加投资额 › Request Parameters

category

string · required

业务线

botId

string · required

网格机器人ID，需保证业务线与网格机器人ID匹配，否则报错

coin

string · required

追加币种

size

string · required

金额

fundsSource

string[] · required

资金来源 funding：资金账户 uta：统一账户 otc：OTC账户

adjustType

string

调整类型，仅适用于合约网格，合约必填 increase decrease

reinvestProfit

string

是否复投利润，默认yes，仅适用于现货网格 yes no

追加投资额 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

botId

string

网格机器人ID

查询网格交易机器人详情

GET

https://api.bitget.com

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

查询指定策略的详细信息，含参数配置、当前状态、累计收益等。

限频规则: 10次/秒/UID
需要统一账户交易只读权限

查询网格交易机器人详情 › Request Parameters

botId

string · required

网格机器人ID

查询网格交易机器人详情 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

botId

string

网格机器人ID

symbol

string

交易对

status

string

状态 init：初始化 waiting：待启动 running：运行中 terminating：终止中 terminated：已终止

totalProfit

string

总收益，单位USDT

roi

string

收益率，小数形式

gridProfit

string

网格利润，单位USDT

gridProfitRate

string

网格利润比例

unpairedProfit

string

未配对收益，单位USDT

unpairedProfitRate

string

未配对收益比例

margin

string

保证金，仅合约有

arbitrageAPR

string

套利APR

totalAPR

string

总APR

createdTime

string

创建时间

runningTime

string

运行时长，单位ms

currentBaseBalance

string

当前基础币余额

currentQuoteBalance

string

当前计价币余额

initialBaseHoldings

string

初始基础币持仓

initialQuoteHoldings

string

初始计价币持仓

reservedBaseTradingFee

string

预留基础币交易手续费

reservedQuoteTradingFee

string

预留计价币交易手续费

gridStartPrice

string

网格起始价

gridType

string

网格类型 long：做多 short：做空 netural：中性

maxPrice

string

网格上限价格

minPrice

string

网格下限价格

gridNum

string

网格格数

gridOrderMode

string

网格模式 arithmetic：等差 geometric：等比

baseInvestmentCoin

string

基础币投入币种

baseInvestmentAmount

string

基础币投入金额

quoteInvestmentCoin

string

计价币投入币种

quoteInvestmentAmount

string

计价币投入金额

slippage

string

滑点 1% 2% none

triggerCondition

string

触发条件 instant：立即 price：价格 rsi boll

object[]

触发参数

triggerPrice

string

触发价格

terminationCondition

string

终止条件 rsi boll

object[]

终止参数

terminationSell

string

终止时是否卖出 yes no

stopLoss

string

止损价格

takeProfit

string

止盈价格

hodlMode

string

屯币模式 yes no

autoTransferProfits

string

自动转出利润 yes no

arbitrageCount

string

套利次数

terminationReason

string

终止原因 MANUAL_END：手动终止 NEW_WAIT：待启动 ACCOUNT_BALANCE_LACKING_END：可用资金不足 STOP_PROFIT_END：止盈终止 STOP_LOSS_END：止损终止 CANCEL_END：撤单终止 SYSTEM_END：下单失败导致撤单 FOLLOW_END：跟随终止 SUBSCRIBE_STOP_PROFIT_END：订阅止盈终止 SUBSCRIBE_STOP_LOSS_END：订阅止损终止 PLACE_ORDER_FAIL_END：下单连续失败终止 SYMBOL_DOWN_END：币对下架终止 SUB_ACCOUNT_TRANSFER_FAIL：资金划转失败 HIGHEST_PRICE_END：最高价终止 BOTTOM_PRICE_END：最低价终止 BURST_END：爆仓终止 MOVE_GRID_FAIL：网格移动失败终止 EXPIRE_TIME_END：系统定时终止 HANDLE_SUB_POSITION_END：手动减仓终止 STOP_PRICE_ACHIEVE：达到终止价格 ADL_END：ADL终止 AUTO_CONVERT_END：自动兑换终止 CONDITION_TRIGGER_END：条件触发终止 ADL_CONVERT_END：ADL减仓终止 CANCEL_DELIVERY_ORDER：交割撤单 BASIS_RATE_TRIGGER：基差率触发终止 EARN_REDEEM_FAIL：理财资金赎回失败 SYSTEM_CANCEL：系统取消 SYMBOL_RSTOCK_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

终止网格交易机器人

POST

https://api.bitget.com

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

终止指定机器人，停止挂单并按策略配置处理未成交订单/持仓。

限频规则: 1次/秒/UID
需要统一账户交易权限

终止网格交易机器人 › Request Parameters

botId

string · required

网格机器人ID

终止网格交易机器人 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

data

Response data

创建网格交易机器人

POST

https://api.bitget.com

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

提交现货及合约网格交易机器人创建请求。

限频规则: 1次/秒/UID
需要统一账户交易权限

创建网格交易机器人 › Request Parameters

category

string · required

业务线 SPOT：现货交易 USDT-FUTURES：U本位合约 USDC-FUTURES：USDC合约

symbol

string · required

交易对名称

maxPrice

string · required

网格上限价格

minPrice

string · required

网格下限价格

gridNum

string · required

网格格数

gridOrderMode

string · required

网格挂单模式 arithmetic：等差 geometric：等比

object[] · required

投入金额

fundsSource

string[] · required

资金来源 funding：资金账户 uta：统一账户 otc：OTC账户

autoTransferProfits

string · required

自动转出利润，默认no yes no

gridType

string

网格方向 long short netural 合约必填

leverage

string

杠杆倍数，默认1，仅合约生效

autoReserveMargin

string

自动预留保证金

reservedMargin

string

预留保证金，仅合约生效

triggerCondition

string

触发条件，默认instant instant price rsi boll

object[]

触发参数

triggerPrice

string

触发价格

terminationCondition

string

终止条件 rsi boll

object[]

终止参数

terminationSell

string

终止时是否卖出，仅现货网格有 yes no

stopLoss

string

止损价格

takeProfit

string

止盈价格

slippage

string

滑点

trailingGrid

string

移动网格，默认no yes no

movingAverageGains

string

移动平均收益

stopUpwardPrice

string

上移止损价格

hodlMode

string

屯币模式，默认no，仅现货生效 yes no

marketOpen

string

市价开仓，默认开启，仅合约生效 yes no

lossReserve

string

亏损预留，默认开启，仅合约生效 yes no

创建网格交易机器人 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

botId

string

网格机器人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

创建中性网格交易机器人

POST

https://api.bitget.com

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

提交合约中性交易机器人创建请求。

限频规则: 1次/秒/UID
需要统一账户交易权限

创建中性网格交易机器人 › Request Parameters

category

string · required

业务线 USDT-FUTURES：USDT保证金合约 USDC-FUTURES：USDC保证金合约

symbol

string · required

交易对

maxPrice

string · required

上限价格

minPrice

string · required

下限价格

gridNum

string · required

网格格数

gridOrderMode

string · required

网格模式 arithmetic：等差 geometric：等比

fundsSource

string[] · required

资金来源 funding：资金账户 uta：统一账户 otc：OTC账户

leverage

string

杠杆

object[]

投入币种及金额列表，合约仅支持计价币USDT/USDC

triggerPrice

string

触发价格

stopLoss

string

止损价格

takeProfit

string

止盈价格

autoTransferProfits

string

是否自动转出利润

创建中性网格交易机器人 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

botId

string

网格机器人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

https://api.bitget.com

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

查询指定策略关联的挂单详情。

限频规则: 1次/秒/UID
需要统一账户交易只读权限

查询网格交易机器人挂单详情 › Request Parameters

botId

string · required

网格机器人ID

查询网格交易机器人挂单详情 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

botId

string

网格机器人ID

symbol

string

交易对名称

object[]

买单列表

object[]

卖单列表

修改网格交易机器人参数

POST

https://api.bitget.com

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

运行中修改网格交易机器人的基本参数（价格区间、投入金额等）。

限频规则: 1次/秒/UID
需要统一账户交易权限

修改网格交易机器人参数 › Request Parameters

botId

string · required

网格机器人ID

takeProfit

string

止盈价格。**如不传，会清空止盈价格。**如不修改止盈价格，需要传入当前值

stopLoss

string

止损价格。**如不传，会清空止损价格。**如不修改止损价格，需要传入当前值

terminationCondition

string

终止条件 rsi boll

object[]

终止参数

hodlMode

string

屯币模式 yes no

autoTransferProfits

string

自动转出利润 yes：转出 no：不转出

修改网格交易机器人参数 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

botId

string

网格机器人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

修改网格区间和网格数

POST

https://api.bitget.com

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

修改网格区间及网格数接口。

限频规则: 1次/秒/UID
需要统一账户交易权限

修改网格区间和网格数 › Request Parameters

category

string · required

业务线 SPOT：现货交易 USDT-FUTURES：U本位合约 USDC-FUTURES：USDC合约

botId

string · required

网格机器人ID

maxPrice

string · required

网格上限价格

minPrice

string · required

网格下限价格

gridNum

string · required

网格格数

修改网格区间和网格数 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

botId

string

网格机器人ID

修改中性网格交易机器人参数

POST

https://api.bitget.com

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

修改运行中的中性网格交易机器人基本参数。

限频规则: 1次/秒/UID
需要统一账户交易权限

修改中性网格交易机器人参数 › Request Parameters

botId

string · required

网格机器人ID

category

string · required

业务线 USDT-FUTURES：USDT保证金合约 USDC-FUTURES：USDC保证金合约

takeProfit

string

止盈价格。如不传，会清空止盈价格，如不修改需传入当前值

stopLoss

string

止损价格。如不传，会清空止损价格，如不修改需传入当前值

autoTransferProfits

string

是否自动转出利润 yes：转出 no：不转出

修改中性网格交易机器人参数 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

botId

string

网格机器人ID

修改中性网格区间和网格数

POST

https://api.bitget.com

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

修改网格区间及网格数接口。

限频规则: 1次/秒/UID
需要统一账户交易权限

修改中性网格区间和网格数 › Request Parameters

category

string · required

业务线 USDT-FUTURES：USDT保证金合约 USDC-FUTURES：USDC保证金合约

botId

string · required

网格机器人ID

maxPrice

string · required

网格上限价格

minPrice

string · required

网格下限价格

gridNum

string · required

网格格数

修改中性网格区间和网格数 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

botId

string

网格机器人ID

查询中性网格交易机器人详情

GET

https://api.bitget.com

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

查询指定合约中性策略的详细信息，含参数配置、当前状态、累计收益等。

限频规则: 10次/秒/UID
需要统一账户交易只读权限

查询中性网格交易机器人详情 › Request Parameters

botId

string · required

网格机器人ID

查询中性网格交易机器人详情 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

botId

string

网格机器人ID

symbol

string

交易对

status

string

状态 init：初始化中 waiting：等待中 running：运行中 terminating：终止中 terminated：已终止

totalProfit

string

总收益，单位USDT

roi

string

收益率，小数形式

gridProfit

string

网格收益，单位USDT，等于已套利利润减去手续费

gridProfitRate

string

网格利润比例，小数形式

unpairedProfit

string

未配对收益，单位USDT

unpairedProfitRate

string

未配对收益率，小数形式

margin

string

保证金（仅合约有）

arbitrageAPR

string

套利年化收益率，小数形式，运行不足1天按1天计算

totalAPR

string

总年化收益率，小数形式，运行不足1天按1天计算

createdTime

string

创建时间

runningTime

string

运行时长，单位毫秒

gridStartPrice

string

网格起始价格

maxPrice

string

网格上限价格

minPrice

string

网格下限价格

gridNum

string

网格格数

gridOrderMode

string

网格模式 arithmetic：等差 geometric：等比

triggerPrice

string

触发价格

leverage

string

杠杆

stopLoss

string

止损价格

takeProfit

string

止盈价格

holdAveragePrice

string

持仓均价

holdPosition

string

持仓量

oneGridMinProfit

string

单格最小利润

oneGridMaxProfit

string

单格最大利润

autoTransferProfits

string

是否自动转出利润 yes：转出 no：不转出

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

https://api.bitget.com

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

查询指定合约中性策略关联的挂单详情。

限频规则: 1次/秒/UID
需要统一账户交易只读权限

查询中性网格机器人挂单详情 › Request Parameters

botId

string · required

网格机器人ID

查询中性网格机器人挂单详情 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

botId

string

网格机器人ID

symbol

string

交易对

object[]

买单列表

object[]

卖单列表

验证中性网格参数

POST

https://api.bitget.com

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

创建网格中性策略前，校验网格参数（价格区间、格数、投入金额等）是否合法，不实际创建策略。

限频规则: 1次/秒/UID
需要统一账户交易权限

验证中性网格参数 › Request Parameters

category

string · required

业务线 USDT-FUTURES：USDT保证金合约 USDC-FUTURES：USDC保证金合约

symbol

string · required

交易对

maxPrice

string · required

上限价格

minPrice

string · required

下限价格

gridNum

string · required

网格格数

gridOrderMode

string · required

网格模式 arithmetic：等差 geometric：等比

leverage

string

杠杆

object[]

投入币种及金额列表，合约仅支持计价币USDT/USDC

triggerPrice

string

触发价格

stopLoss

string

止损价格

takeProfit

string

止盈价格

autoTransferProfits

string

是否自动转出利润

验证中性网格参数 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

valid

string

是否校验通过

reason

string

校验失败原因

minInvestment

string

最小投入金额

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

验证网格输入

POST

https://api.bitget.com

/api/v3/trade/grid/validate

创建网格策略前，校验网格参数（价格区间、格数、投入金额等）是否合法，不实际创建策略。

限频规则: 1次/秒/UID
需要统一账户交易权限

验证网格输入 › Request Parameters

category

string · required

业务线 SPOT：现货交易 USDT-FUTURES：U本位合约 USDC-FUTURES：USDC合约

symbol

string · required

交易对名称

maxPrice

string · required

网格上限价格

minPrice

string · required

网格下限价格

gridNum

string · required

网格格数

gridOrderMode

string · required

网格挂单模式 arithmetic：等差 geometric：等比

object[] · required

投入金额

autoTransferProfits

string · required

自动转出利润，默认no yes no

gridType

string

网格方向 long short netural 合约必填

leverage

string

杠杆倍数，默认1，仅合约生效

reservedMargin

string

预留保证金，仅合约生效

triggerCondition

string

触发条件，默认instant instant price rsi boll

object[]

触发参数

triggerPrice

string

触发价格

terminationCondition

string

终止条件 rsi boll

object[]

终止参数

stopLoss

string

止损价格

takeProfit

string

止盈价格

trailingGrid

string

移动网格，默认no yes no

movingAverageGains

string

移动平均收益

stopUpwardPrice

string

上移止损价格

hodlMode

string

屯币模式，默认no，仅现货生效 yes no

marketOpen

string

市价开仓，默认开启，仅合约生效 yes no

lossReserve

string

亏损预留，默认开启，仅合约生效 yes no

验证网格输入 › Response Parameters

200

Successful response

code

string

msg

string

requestTime

integer

object

valid

string

是否校验通过

reason

string

校验失败原因

minInvestment

string

最小投入金额

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

策略交易