跳至主要内容

查詢機器人限制參數

驗證合約馬丁格爾機器人的輸入參數並返回允許的範圍。在創建馬丁格爾機器人之前調用，以確保參數在有效範圍內。

信息

  • 何時調用：
    在調用創建合約馬丁格爾機器人之前，務必先調用此端點。

  • check_code：
    F_MART_LIMIT_CHECK_CODE_F_MART_CHECK_CODE_SUCCESS_UNSPECIFIED = 所有參數均有效。其他值表示超出範圍的具體參數。

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

HTTP請求​

POST/v5/fmartingalebot/getlimit

請求參數​

參數是否必需類型說明
symboltruestring交易對名稱，僅大寫（例如 BTCUSDT）
martingale_modetrueinteger策略方向：1 做多，2 做空
leveragetruestring倉位槓桿倍數（例如 "5" 表示 5 倍），必須 >= 1
price_float_percentfalsestring觸發追加倉位的價格變動百分比（例如 "0.015" 表示 1.5%）
add_position_percentfalsestring追加倉位規模，以基礎倉位規模百分比計（例如 "1" = 1 倍）
add_position_numfalseinteger每輪最大追加倉位次數
init_marginfalsestring初始投資金額，以報價幣種計（小數字符串）
round_tp_percentfalsestring單輪止盈百分比（例如 "0.03" 表示 3%）
sl_percentfalsestring止損百分比（例如 "0.2" 表示 20%）
entry_pricefalsestring入場觸發價格（小數字符串）
need_to_slippagefalseboolean是否包含滑點計算

響應參數​

參數類型說明
status_codeinteger0 = 成功，非零 = 錯誤
debug_msgstring調試信息（僅測試網）
check_codestring驗證結果，詳見下方校驗碼表
price_float_percentobject可接受的價格浮動百分比範圍（min / max）
add_position_percentobject可接受的追加倉位百分比範圍（min / max）
add_position_numobject可接受的追加倉位次數範圍（min / max）
init_marginobject可接受的初始保證金範圍（min / max，報價幣種小數字符串）
round_tp_percentobject可接受的單輪止盈百分比範圍（min / max）
sl_percentobject可接受的止損百分比範圍（min / max）
entry_priceobject可接受的入場價格範圍（min / max）
leverageobject可接受的槓桿範圍（min / max）

校驗碼說明​

check_code說明
F_MART_LIMIT_CHECK_CODE_F_MART_CHECK_CODE_SUCCESS_UNSPECIFIED正常 — 無錯誤
F_MART_LIMIT_CHECK_CODE_F_MART_PRICE_FLOAT_PERCENT_TOO_HIGH價格浮動百分比過高
F_MART_LIMIT_CHECK_CODE_F_MART_PRICE_FLOAT_PERCENT_TOO_LOW價格浮動百分比過低
F_MART_LIMIT_CHECK_CODE_F_MART_ADD_POSITION_PERCENT_TOO_HIGH追加倉位百分比過高
F_MART_LIMIT_CHECK_CODE_F_MART_ADD_POSITION_PERCENT_TOO_LOW追加倉位百分比過低
F_MART_LIMIT_CHECK_CODE_F_MART_ADD_POSITION_NUM_TOO_HIGH追加倉位次數過多
F_MART_LIMIT_CHECK_CODE_F_MART_ADD_POSITION_NUM_TOO_LOW追加倉位次數過少
F_MART_LIMIT_CHECK_CODE_F_MART_INIT_MARGIN_TOO_HIGH初始保證金過高
F_MART_LIMIT_CHECK_CODE_F_MART_INIT_MARGIN_TOO_LOW初始保證金過低
F_MART_LIMIT_CHECK_CODE_F_MART_ROUND_TARGET_TP_PERCENT_TOO_HIGH單輪止盈百分比過高
F_MART_LIMIT_CHECK_CODE_F_MART_ROUND_TARGET_TP_PERCENT_TOO_LOW單輪止盈百分比過低
F_MART_LIMIT_CHECK_CODE_F_MART_SL_PER_TOO_HIGH止損百分比過高
F_MART_LIMIT_CHECK_CODE_F_MART_SL_PER_TOO_LOW止損百分比過低
F_MART_LIMIT_CHECK_CODE_F_MART_ENTRY_PRICE_TOO_HIGH入場價格過高
F_MART_LIMIT_CHECK_CODE_F_MART_ENTRY_PRICE_TOO_LOW入場價格過低
F_MART_LIMIT_CHECK_CODE_F_MART_LEVERAGE_TOO_HIGH槓桿過高
F_MART_LIMIT_CHECK_CODE_F_MART_LEVERAGE_TOO_LOW槓桿過低

請求示例​

POST /v5/fmartingalebot/getlimit HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1672211928338
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json

{
    "symbol": "MNTUSDT",
    "martingale_mode": 1,
    "leverage": "5",
    "price_float_percent": "0.16",
    "add_position_percent": "1.8",
    "add_position_num": 5,
    "round_tp_percent": "0.1",
    "init_margin": "1000",
    "sl_percent": "0.5",
    "auto_cycle_toggle": 2
}

響應示例​

{
    "retCode": 0,
    "retMsg": "success",
    "result": {
        "status_code": 0,
        "debug_msg": "",
        "check_code": "F_MART_LIMIT_CHECK_CODE_F_MART_CHECK_CODE_SUCCESS_UNSPECIFIED",
        "price_float_percent": {
            "max": "0.199",
            "min": "0.001"
        },
        "add_position_percent": {
            "max": "2",
            "min": "1"
        },
        "add_position_num": {
            "max": "10",
            "min": "1"
        },
        "init_margin": {
            "max": "34004.22",
            "min": "0.7682"
        },
        "round_tp_percent": {
            "max": "4.45",
            "min": "0.01"
        },
        "sl_percent": {
            "max": "1",
            "min": "0"
        },
        "entry_price": {
            "max": "0.7086",
            "min": "0.2105"
        },
        "leverage": {
            "max": "20",
            "min": "1"
        }
    },
    "retExtInfo": {},
    "time": 1774510798514
}