跳至主要内容

執行 LP 質押

向流動性礦池質押代幣以提供流動性並賺取收益。

信息
  • 質押前必須先調用 查詢支付代幣列表 確認可用餘額
  • 必須向用戶展示質押詳情（金額、費用、預期 APY）並獲得明確確認後，才能調用此接口
  • 200 響應僅為確認回執 — 請使用 查詢訂單列表 確認最終倉位狀態
  • 支持新建倉位（positionId=0）或向已有倉位追加流動性
  • rangeLower/rangeUpper 和 priceLower/priceUpper 二選一，不可同時使用
  • 倉位激活通常需要 10–60 秒的鏈上確認時間
  • 頻率限制： 1 次/秒（用戶），2000 次/秒（全局）

HTTP 請求​

POST/v5/alpha/lp/stake

請求參數​

參數是否必需類型說明
positionIdtrueinteger倉位ID。傳 0 新建倉位，傳已有倉位ID則追加流動性
poolAddresstruestring礦池合約地址
payTokenAmounttruestring支付代幣數量（正數小數字符串）
payTokenCodetruestring支付代幣代碼，如 CEX_1 代表 USDT
rangeUpperfalsestring範圍訂單上限。與 priceUpper 二選一，不可同時使用
rangeLowerfalsestring範圍訂單下限。與 priceLower 二選一，不可同時使用
priceUpperfalsestring價格訂單上限（價格優先）。與 rangeUpper 二選一，不可同時使用
priceLowerfalsestring價格訂單下限（價格優先）。與 rangeLower 二選一，不可同時使用

響應參數​

參數類型說明
positionIdinteger倉位ID（新建或已有）
orderNostring本次質押操作的訂單號

請求示例​

POST /v5/alpha/lp/stake HTTP/1.1
Host: api.bybit.com
X-BAPI-SIGN: XXXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1704067200000
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json

{
    "positionId": 0,
    "poolAddress": "0x1234567890abcdef",
    "payTokenAmount": "1000",
    "payTokenCode": "CEX_1",
    "rangeUpper": "2000",
    "rangeLower": "1800"
}

響應示例​

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "positionId": 12345,
        "orderNo": "LP_ORD_20240101_001"
    },
    "retExtInfo": {},
    "time": 1704067200000
}