跳至主要内容

模擬交易

概覽​

Bybit v5 Open API支持模擬交易帳戶, 但是由於模擬交易的主要目的是為了體驗基礎交易功能, 僅支持有限的功能, 所以部分接口不支持使用。

創建API Key​

  1. 您需要登入到Bybit 主網帳戶;
  2. 切換到模擬交易, 注意: 模擬交易擁有自己獨立的帳戶ID;
  3. 懸停鼠標在用戶頭像上, 然後點擊"API" 來創建key和secret;

使用規則​

  • 基礎交易規則和實盤保持一致
  • 模擬盤的訂單僅保留7天
  • 默認請求頻率, 無法提頻

域名​

主網模擬盤:
Rest API: https://api-demo.bybit.com
Websocket : wss://stream-demo.bybit.com (請注意模擬交易僅支持私有頻道; 公共頻道請使用 wss://stream.bybit.com; WS下單服務不支持)

小建議​

  • 請注意模擬交易是獨立模塊, 當創建了模擬交易的api key後, 請使用以上域名進行連接
  • 順便說下, 在測試網使用模擬交易服務是無意義的, 因為二者都是沙盒環境, 若要使用模擬交易, 請至主網生成模擬交易的api key

可用接口列表​

目錄接口名路由
公有行情所有所有接口
交易創建委託單/v5/order/create
修改委託單/v5/order/amend
撤銷委託單/v5/order/cancel
查詢實時委託段/v5/order/realtime
撤銷所有訂單/v5/order/cancel-all
查詢歷史訂單/v5/order/history
查詢成交紀錄/v5/execution/list
批量創建委託單/v5/order/create-batch (期貨/期權)
批量修改委託單/v5/order/amend-batch (期貨/期權)
批量撤銷委託單/v5/order/cancel-batch (期貨/期權)
持倉查詢持倉/v5/position/list
設置槓桿/v5/position/set-leverage
切換持倉模式/v5/position/switch-mode
設置止盈止損/v5/position/trading-stop
設置自動追加保證金/v5/position/set-auto-add-margin
手動增加或減少保證金/v5/position/add-margin
查詢平常盈虧/v5/position/closed-pnl
帳戶查詢錢包餘額/v5/account/wallet-balance
查詢利息紀錄/v5/account/borrow-history
設置抵押品幣種/v5/account/set-collateral-switch
查詢抵押品信息/v5/account/collateral-info
查詢Greeks信息/v5/asset/coin-greeks
查詢帳戶配置/v5/account/info
查詢交易日誌/v5/account/transaction-log
設置保證金模式/v5/account/set-margin-mode
設置現貨對衝/v5/account/set-hedging-mode
資產查詢交割紀錄/v5/asset/delivery-record
查詢USDC結算紀錄/v5/asset/settlement-record
全倉槓桿全倉槓桿開關/v5/spot-margin-trade/switch-mode
全倉槓桿設置/v5/spot-margin-trade/set-leverage
查詢開關狀態和倍數/v5/spot-margin-uta/status
WS私有推送order,execution,position,wallet,greeks/v5/private

獲取模擬資金接口​

API頻率: 每分鐘1次

HTTP請求​

POST /v5/account/demo-apply-money

請求參數​

參數是否必需類型說明
adjustTypefalseinteger0(默認): 增加模擬資金; 1: 減少模擬資金
utaDemoApplyMoneyfalsearray
> coinfalsestring申請的幣種, 支持 BTC, ETH, USDT, USDC
> amountStrfalsestring申請的金額, 每次請求最多支持申請如下金額
  • BTC: "15"
  • ETH: "200"
  • USDT: "100000"
  • USDC: "100000"

    • 請求示例​

    POST /v5/account/demo-apply-money HTTP/1.1
    Host: api-demo.bybit.com
    X-BAPI-SIGN: XXXXXXX
    X-BAPI-API-KEY: XXXXXXX
    X-BAPI-TIMESTAMP: 1711420489915
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json

    {
        "adjustType": 0,
        "utaDemoApplyMoney": [
            {
                "coin": "USDT",
                "amountStr": "109"
            },
            {
                "coin": "ETH",
                "amountStr": "1"
            }
        ]
    }

    創建模擬交易帳戶​

    API 頻率: 5次/秒
    權限: 帳戶劃轉, 母子帳戶劃轉

    信息
    • 使用生產環境的母子帳戶調用該接口, 域名需要是"api.bybit.com"
    • 如果模擬帳戶已經存在, 這個POST接口直接返回存在的模擬帳戶UID
    • 如果使用的母帳戶key調接口, 則創建的模擬帳戶存在於該母帳戶下面
    • 如果使用的子帳戶key調接口, 則創建的模擬帳戶存在於該子帳戶下面

    HTTP 請求​

    POST /v5/user/create-demo-member

    請求參數​

    無

    響應參數​

    參數類型說明
    subMemberIdstring模擬帳戶UID

    請求實例​

    POST /v5/user/create-demo-member HTTP/1.1
    Host: api.bybit.com
    X-BAPI-SIGN: XXXXXXX
    X-BAPI-API-KEY: XXXXXXX
    X-BAPI-TIMESTAMP: 1728460942776
    X-BAPI-RECV-WINDOW: 5000
    Content-Type: application/json
    Content-Length: 2

    {}

    創建模擬帳戶API Key​

    信息
    • 參數填寫模擬帳戶UID
    • 使用生產環境母帳戶調用接口, 域名需要是"api.bybit.com"

    更新模擬帳戶API Key​

    信息
    • 使用生產環境母帳戶調用接口, 域名需要是"api.bybit.com"

    查詢模擬帳戶API Key信息​

    信息
    • 使用對應的模擬帳戶調用接口, 域名需要是"api-demo.bybit.com"

    刪除模擬帳戶API Key​

    信息
    • 使用生產環境母帳戶調用接口, 域名需要是"api.bybit.com"