跳至主要内容

執行買入

執行預測市場結果代幣的買入委托，支付 USDC 獲取結果代幣份額。

信息
  • 必須先調用 獲取撮合引擎狀態 確認引擎可用
  • 必須先調用 獲取賽事詳情 獲取 tokenId 並確認市場開放
  • 必須先調用 獲取委托預估 預覽委托結果
  • 必須向用戶展示預估結果並取得明確確認後，方可調用本接口
  • 第一階段僅支持 orderType=1（FOK）——無法完全成交的委托將被取消
  • 200 響應僅表示委托已受理，請調用 獲取委托記錄 查詢最終成交狀態

HTTP 請求​

POST/v5/alpha/prediction/buy

請求參數​

參數是否必需類型說明
tokenIdtruestring要買入的結果代幣 ID（從 獲取賽事詳情 獲取）
amounttruestring投入的 USDC 金額（正數字符串）
payTokenCodetruestring支付代幣代碼，第一階段固定為 USDC
orderTypetrueinteger委托類型。參考 predictionOrderType。第一階段：1（FOK）
slippagetruestring最大可接受滑點（小數）。0.05 = 5% 容忍度
eventIdtruestring代幣對應的賽事 ID

響應參數​

參數類型說明
orderNostring委托號。請調用 獲取委托記錄 查詢成交狀態

請求示例​

POST /v5/alpha/prediction/buy 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

{
    "tokenId": "token_yes_123",
    "amount": "100",
    "payTokenCode": "USDC",
    "orderType": 1,
    "slippage": "0.05",
    "eventId": "event_123"
}

響應示例​

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "orderNo": "ord_buy_20240101_001"
    },
    "retExtInfo": {},
    "time": 1704067200000
}