跳至主要内容

驗證網格輸入

在創建現貨網格機器人前驗證參數。返回各參數的可接受範圍及表示驗證錯誤的校驗碼。

信息

  • 何時調用：
    在調用創建現貨網格機器人之前，務必先調用此端點，確保參數在有效範圍內。

  • check_code：
    SPOT_CHECK_CODE_SUCCESS_UNSPECIFIED（值 0）表示所有參數均有效。其他值表示超出範圍的具體參數。

  • 身份驗證：
    此端點無需身份驗證（訪客模式）。

  • 頻率限制：
    每個 IP 每秒最多 100 次請求。

HTTP請求​

POST/v5/grid/validate-input

請求參數​

參數是否必需類型說明
symboltruestring交易對名稱，僅大寫（例如 BTCUSDT）
cell_numbertrueinteger網格間隔數量，最小為 2
min_pricetruestring網格價格範圍下限（小數字符串）
max_pricetruestring網格價格範圍上限，必須大於 min_price（小數字符串）
invest_modefalseinteger投資模式：0 僅報價幣（默認），1 僅基礎幣，2 基礎幣+報價幣
base_investmentfalsestring基礎幣種投資金額（小數字符串）。invest_mode 為 1 或 2 時必填
quote_investmentfalsestring報價幣種投資金額（小數字符串）。invest_mode 為 0 或 2 時必填
stop_lossfalsestring止損絕對價格（小數字符串）
take_profitfalsestring止盈絕對價格（小數字符串）
entry_pricefalsestring入場觸發絕對價格（小數字符串）
ts_percentfalsestring移動止損回撥比例，範圍 [0, 0.99]（例如 "0.05" 表示 5%）
enable_trailingfalseboolean是否啓用網格追蹤。要求 cell_number >= 5
limit_up_pricefalsestring網格追蹤上限價格（小數字符串）

響應參數​

參數類型說明
status_codeinteger0 或 200 = 成功
debug_msgstring調試信息（僅測試網）
check_codestring驗證結果碼。SPOT_CHECK_CODE_SUCCESS_UNSPECIFIED = 正常。詳見下方校驗碼表
investmentobject可接受的總投資金額範圍（from / to，小數字符串）
profitobject可接受的每格利潤率範圍，小數比例（from / to）
cell_numberobject可接受的網格數量範圍（from / to）
min_priceobject可接受的價格下限範圍（from / to）
max_priceobject可接受的價格上限範圍（from / to）
stop_lossobject可接受的止損價格範圍（from / to）
take_profitobject可接受的止盈價格範圍（from / to）
entry_priceobject可接受的入場價格範圍（from / to）
base_investmentobject可接受的基礎幣種投資金額範圍（from / to）
cell_distancestring網格間隔距離，以報價幣種價格單位計（小數字符串）
ts_percentobject可接受的移動止損比例範圍（from / to）
limit_up_priceobject可接受的追蹤上限價格範圍（from / to）

校驗碼說明​

check_code說明
SPOT_CHECK_CODE_SUCCESS_UNSPECIFIED正常 — 無錯誤
SPOT_CHECK_CODE_LOW_PRICE_TOO_LOWmin_price 過低
SPOT_CHECK_CODE_LOW_PRICE_TOO_HIGHmin_price 過高
SPOT_CHECK_CODE_HIGH_PRICE_TOO_LOWmax_price 過低
SPOT_CHECK_CODE_HIGH_PRICE_TOO_HIGHmax_price 過高
SPOT_CHECK_CODE_GRID_NO_TOO_LOWcell_number 過少
SPOT_CHECK_CODE_GRID_NO_TOO_HIGHcell_number 過多
SPOT_CHECK_CODE_INVESTMENT_TOO_LOW投資金額過低
SPOT_CHECK_CODE_INVESTMENT_TOO_HIGH投資金額過高
SPOT_CHECK_CODE_TP_TOO_LOW止盈價格過低
SPOT_CHECK_CODE_TP_TOO_HIGH止盈價格過高
SPOT_CHECK_CODE_SL_TOO_LOW止損價格過低
SPOT_CHECK_CODE_SL_TOO_HIGH止損價格過高
SPOT_CHECK_CODE_EP_TOO_LOW入場價格過低
SPOT_CHECK_CODE_EP_TOO_HIGH入場價格過高
SPOT_CHECK_CODE_TS_PERCENT_TOO_LOW移動止損百分比過低
SPOT_CHECK_CODE_TS_PERCENT_TOO_HIGH移動止損百分比過高
SPOT_CHECK_CODE_TP_TOO_LOW_THAN_MARKET止盈價格低於市場價格
SPOT_CHECK_CODE_SL_TOO_HIGH_THAN_MARKET止損價格高於市場價格
SPOT_CHECK_CODE_LIMIT_UP_PRICE_TOO_LOWlimit_up_price 過低
SPOT_CHECK_CODE_LIMIT_UP_PRICE_TOO_HIGHlimit_up_price 過高
SPOT_CHECK_CODE_CAN_NOT_ENABLE_TRAILING_UPcell_number < 5，不允許追蹤
SPOT_CHECK_CODE_ENTRY_PRICE_FORBIDDEN_TRAILING_UP入場價格超出網格範圍，不允許追蹤
SPOT_CHECK_CODE_LAST_PRICE_FORBIDDEN_TRAILING_UP市場價格超出網格範圍，不允許追蹤
SPOT_CHECK_CODE_INVESTMENT_FORBIDDEN_TRAILING_UP投資金額不足以支持追蹤

請求示例​

POST /v5/grid/validate-input HTTP/1.1
Host: api-testnet.bybit.com
Content-Type: application/json

{
    "symbol": "MNTUSDT",
    "max_price": "1.2",
    "min_price": "0.3",
    "quote_investment": "",
    "base_investment": "300",
    "invest_mode": 1,
    "cell_number": 66,
    "entry_price": "0.4"
}

響應示例​

{
    "retCode": 0,
    "retMsg": "",
    "result": {
        "status_code": 200,
        "debug_msg": "",
        "investment": {
            "from": "0",
            "to": "0"
        },
        "profit": {
            "from": "0.0114",
            "to": "0.0453"
        },
        "cell_number": {
            "from": "2",
            "to": "562"
        },
        "min_price": {
            "from": "0.1568",
            "to": "3.92"
        },
        "max_price": {
            "from": "0.3012",
            "to": "40"
        },
        "stop_loss": {
            "from": "0",
            "to": "0.3"
        },
        "take_profit": {
            "from": "1.2",
            "to": ""
        },
        "entry_price": {
            "from": "0.2352",
            "to": "0.784"
        },
        "cell_distance": "0.0136",
        "check_code": "SPOT_CHECK_CODE_SUCCESS_UNSPECIFIED",
        "base_investment": {
            "from": "228.36",
            "to": "1366590.08"
        },
        "ts_percent": {
            "from": "0.03",
            "to": "0.99"
        },
        "limit_up_price": {
            "from": "1.2112",
            "to": "3.9065"
        }
    },
    "retExtInfo": {},
    "time": 1774513367099
}