# REST API

# 使用BitCoke的REST API

系統REST API提供兩類數據互動,第一類是行情相關資料的獲取,無需申請秘鑰(API KEY)就可以使用; 第二類是獲取交易數據或發送交易請求,需要用戶登錄系統申請秘鑰(API KEY),並將數據按指定格式加密發送。 兩種方式返回的數據都是基於Json格式。

# 介面管道

BitCoke REST API基於Swagger規範開發,行情介面請點擊Market (opens new window)(裡面交易相關介面會在不久後移除); 交易介面請點擊Trade (opens new window)。 詳細介紹請看下文

# 行情API

行情及報價介面可直接使用,不需要申請API KEY; 請求頻率根據發出請求服務器的IP限制。

# 獲取合約資訊

  • 路徑: Basic Reference => /api/basic/refData

  • 請求頻率限定:1次/秒/IP。

  • 響應結果如下,symbol為合約名; tick為價格最小變動組織; lotSize為合約面值,組織USD; type為合約類型,PERP為永續合約。 如:

     {
       "code": 0,
       "message": "OK",
       "result": [
         {
           "symbol": "XBTCUSD",
           "tick": 1,
           "lotSize": 1,
           "type": "PERP"
         },
         {
           "symbol": "XETHUSD",
           "tick": 0.05,
           "lotSize": 1,
           "type": "PERP"
         },
         {
           "symbol": "XEOSUSD",
           "tick": 0.001,
           "lotSize": 1,
           "type": "PERP"
         },
         {
           "symbol": "XLTCUSD",
           "tick": 0.01,
           "lotSize": 1,
           "type": "PERP"
         },
         {
           "symbol": "XBCHUSD",
           "tick": 0.05,
           "lotSize": 1,
           "type": "PERP"
         }
       ]
     }
    

# 獲取合約最新成交價

  • 路徑:Basic Reference => /api/basic/lastPrice

  • 請求頻率限定:1次/秒/IP。

  • 請求參數:symbols,合約名稱,多個標記以逗號分隔,eg: XBTCUSD,XETHUSD,等。 參數為空時,返回所有合約成交價

  • 響應結果:

        {
          "code": 0,
          "message": "OK",
          "result": [
            {
              "symbol": "XBTCUSD",
              "price": 42259,
              "time": 1632280154441
            },
            {
              "symbol": "XETHUSD",
              "price": 2877.7,
              "time": 1632280154356
            }
          ]
        }
    

# 獲取指數價

  • 路徑:Index Price => /api/basic/indexPrice

  • 請求頻率限定:5次/秒/IP。

  • 請求參數:symbols,標記名稱,多個標記以逗號分隔,eg: BTCUSD,ETHUSD(注意:和合約名稱進行區分,標記名前去掉X

  • 響應結果:

      {
        "code": 0,
        "message": "OK",
        "result": [
          {
            "symbol": "BTCUSD",
            "price": 42236.59225,
            "time": 1632280073988
          }
        ]
      }
    

# 獲取標記價

  • 路徑:Index Price => /api/basic/markPrice

  • 請求頻率限定:5次/秒/IP。

  • 請求參數:symbols,標記名稱,多個標記以逗號分隔,eg: BTCUSD,ETHUSD(注意:和合約名稱進行區分,標記名前去掉X

  • 響應結果:

       {
         "code": 0,
         "message": "OK",
         "result": [
           {
             "symbol": "BTCUSD",
             "price": 42169.00833333333,
             "time": 1632280351964
           },
           {
             "symbol": "ETHUSD",
             "price": 2870.4183333333335,
             "time": 1632280352563
           }
         ]
       }
    

# 獲取市場深度

  • 路徑:Market Depth & Trade Records => /api/depth/depth

  • 請求頻次限定:5次/秒/IP。

  • 請求參數:symbol,合約名稱,eg: XBTCUSD。

  • 響應結果:20檔深度,如下(篇幅太長,只展示了部分內容):

    {
      "code": 0,
      "message": "OK",
      "result": {
        "buyDepth": [
          {
            "price": 7292,
            "qty": 36303,
            "count": 6,
            "iceCount": 0
          },
          {
            "price": 7291,
            "qty": 34378,
            "count": 8,
            "iceCount": 0
          }
        ],
        "sellDepth": [
          {
            "price": 7293,
            "qty": 42245,
            "count": 6,
            "iceCount": 0
          },
          {
            "price": 7294,
            "qty": 53054,
            "count": 6,
            "iceCount": 0
          }
        ],
        "trades": null
      }
    }
    

# 获取最新成交记录

  • 路徑:Market Depth & Trade Records => /api/depth/trades

  • 請求頻次限定:5次/秒/IP。

  • 請求參數:symbol,合約名稱,eg: XBTCUSD; sequence,上一次獲取成交記錄的最新一筆記錄的id; 第一次請求傳入空值,返回最近50筆成交。

  • 響應結果:指定 sequence以後最新成交記錄,如下(篇幅太長,只展示了部分內容):

      {
        "code": 0,
        "message": "OK",
        "result": [
                    {
                      "id": "1577707870474000001",
                      "symbol": "XBTCUSD",
                      "price": 7292,
                      "qty": 484,
                      "buyActive": false,
                      "timestamp": "2019-12-30T12:11:10.476+0000"
                    },
                    {
                      "id": "1577707869615000003",
                      "symbol": "XBTCUSD",
                      "price": 7294,
                      "qty": 900,
                      "buyActive": true,
                      "timestamp": "2019-12-30T12:11:09.616+0000"
                    },
                    {
                      "id": "1577707869064000001",
                      "symbol": "XBTCUSD",
                      "price": 7294,
                      "qty": 91,
                      "buyActive": false,
                      "timestamp": "2019-12-30T12:11:09.064+0000"
                    },
                    {
                      "id": "1577707860030000008",
                      "symbol": "XBTCUSD",
                      "price": 7294,
                      "qty": 1338,
                      "buyActive": false,
                      "timestamp": "2019-12-30T12:11:00.034+0000"
                    }
        ]
      }
    

# 獲取歷史K線以及成交統計相關資料

  • 路徑:K Line & Trade Statistics

    1. /api/kLine/byIndex:通過下標索引獲取歷史K線。請求頻次限定:15次/分/IP。響應結果:
       {
           "code": 0,
           "message": "OK",
           "result": [
             {
               "source": null,
               "symbol": "XBTCUSD",
               "open": 7301,
               "close": 7302,
               "high": 7304,
               "low": 7301,
               "keyTime": "2019-12-30T12:15:00.000+0000",
               "timeStamp": "2019-12-30T12:15:24.515+0000",
               "volume": 17513,
               "turnover": 2.3984301196547184
             },
             {
               "source": null,
               "symbol": "XBTCUSD",
               "open": 7301,
               "close": 7301,
               "high": 7301,
               "low": 7297,
               "keyTime": "2019-12-30T12:14:00.000+0000",
               "timeStamp": "2019-12-30T12:14:58.729+0000",
               "volume": 41975,
               "turnover": 5.7505751906818965
             },
             {
               "source": null,
               "symbol": "XBTCUSD",
               "open": 7296,
               "close": 7301,
               "high": 7301,
               "low": 7294,
               "keyTime": "2019-1  2-30T12:13:00.000+0000",
               "timeStamp": "2019-12-30T12:13:58.178+0000",
               "volume": 48008,
               "turnover": 6.57901338020993
             }
           ]
         }
    
    1. /api/kLine/byTime:通過時間索引獲取歷史K線。請求頻次限定:15次/分/IP。響應結果:
    {
      "code": 0,
      "message": "OK",
      "result": [
        {
          "source": null,
          "symbol": "XBTCUSD",
          "open": 7301,
          "close": 7305,
          "high": 7305,
          "low": 7301,
          "keyTime": "2019-12-30T12:17:00.000+0000",
          "timeStamp": "2019-12-30T12:17:22.071+0000",
          "volume": 24375,
          "turnover": 3.337353658167195
        },
        {
          "source": null,
          "symbol": "XBTCUSD",
          "open": 7304,
          "close": 7301,
          "high": 7308,
          "low": 7300,
          "keyTime": "2019-12-30T12:16:00.000+0000",
          "timeStamp": "2019-12-30T12:16:57.444+0000",
          "volume": 56130,
          "turnover": 7.684110329772189
        },
        {
          "source": null,
          "symbol": "XBTCUSD",
          "open": 7301,
          "close": 7304,
          "high": 7304,
          "low": 7301,
          "keyTime": "2019-12-30T12:15:00.000+0000",
          "timeStamp": "2019-12-30T12:15:53.072+0000",
          "volume": 44210,
          "turnover": 6.054037463066494
        }
      ]
    }
    
    1. /api/kLine/latest:獲取最新一根K線數據。請求頻次限定:75次/分/IP。響應結果:
     {
       "code": 0,
       "message": "OK",
       "result": {
         "source": null,
         "symbol": "XBTCUSD",
         "open": 7306,
         "close": 7308,
         "high": 7311,
         "low": 7306,
         "keyTime": "2019-12-30T12:18:00.000+0000",
         "timeStamp": "2019-12-30T12:18:17.670+0000",
         "volume": 45537,
         "turnover": 6.23014651310752
       }
     }
    
    1. /api/kLine/latestPeriod:獲取上次拉取K線後的更新數據。請求頻次限定:75次/分/IP。響應結果:
     {
       "code": 0,
       "message": "OK",
       "result": [
         {
           "source": null,
           "symbol": "XBTCUSD",
           "open": 7312,
           "close": 7312,
           "high": 7314,
           "low": 7310,
           "keyTime": "2019-12-30T12:19:00.000+0000",
           "timeStamp": "2019-12-30T12:19:08.377+0000",
           "volume": 35453,
           "turnover": 4.848914726098417
         }
       ]
     }
    
    1. /api/kLine/fundingRate:獲取資金費率。請求頻次限定:5次/秒/IP。響應結果:
    {
      "code": 0,
      "message": "OK",
      "result": [
        {
          "symbol": "XBTCUSD",
          "rate": 0.000202,
          "date": "Jun 17, 2020 12:00:00 PM"
        }
      ]
    }
    
    1. /api/kLine/tradeStatistics:獲取最近24小時的成交統計資料。請求頻次限定:5次/秒/IP。響應結果:

       {
         "code": 0,
         "message": "OK",
         "result": [
           {
             "symbol": "XBTCUSD",
             "maxPrice": 7522,
             "minPrice": 7277,
             "priceChange": -18,
             "priceChangeRatio": -0.0024566671216050225,
             "volume": 106729948,
             "turnover": 14465.838637952624,
             "lastPrice": 7309,
             "volumeRatioList": null
           }
         ]
       }
      
    2. /api/kLine/openInterest:獲取系統合約持倉量。 請求參數:symbol,eg: BTCUSD。請求頻次限定:5次/秒/IP。響應結果:

        {
          "code": 0,
          "message": "OK",
          "result": {
            "symbol": "BTCUSD",
            "value": 6323.8854145971545,           
            "date": "Jun 17, 2020 09:42:26 AM",
            "qty": 60000677     
          }
        }
      

# 申请 API KEY

交易API KEY分兩種類型,一種只讀,只允許獲取交易數據;
另一種可交易,可以獲取交易數據以及下單。
申請API Key步驟:主頁面->資產-> API設定;
申請成功後,切記要手動複製並保管好秘鑰資訊。

# 路徑及請求頻次

路徑:Personal Trading Information。 請求頻次:現時交易只讀API根據API Key進行請求頻率限定,如果請求頻次超限,請耐心等待一分鐘,再繼續請求。

# 請求參數

所有只讀API和交易API都必須有以下三個參數,並且這些參數要放在Header中發送:

  • apiKey -申請API時生成的Key
  • expires -請求過期時間的秒數,時區為UTC。 如:當前時間:2019-12-30 11:29:20,請求的有效時間為10秒,就把當前時間加10秒,也就是:2019-12-30 11:29:30,轉換為秒:1577676570; 如果10秒後服務端才收到請求,則回報請求超時
  • signature -請求密文,加密管道:sha256Hex(secret +請求管道GET/POST +請求路徑+ expires); 如:POST請求獲取帳號資訊,sha256Hex(gJQxkMdaLxq9JdQO5yWoRwtaqlUNtwcFv_vk3FNzs5novWWePOST/api/trade/queryAccounts1577458481)

# 交易只讀API

# /api/trade/queryAccounts

査詢用戶的交易帳號資訊。 GET請求。 請求頻率限制:60次/分/Key。 響應數據:

參數 類型 描述 樣例
currency String 幣種
cash Double 總資金
withdrawableCash Double 可提資金
frozenCash Double 凍結資金
urPnl Double 帳戶浮動盈虧

# /api/trade/queryActiveOrders

査詢用戶尚未完成的訂單清單(包括委託單和條件單)。 GET請求。 請求參數:symbol,為可選參數,根據給定值獲取用戶下指定合約的訂單清單; 空則會獲取用戶所有未完成的訂單,按時間倒敘排列。 請求頻率限制:60次/分/Key。 響應數據描述:

參數 類型 描述 樣例
id String 訂單id,eg: O101-20190910-033720-922-1879
currency String 交易幣種
symbol String 合約
created Date 訂單創建時間
modified Date 訂單發生變動時間
side String 訂單方向,Buy/Sell
type String 訂單類型,Limit/Market
price Double 訂單價格
qty Double 訂單數量
openPosition Boolean 開倉/平倉單,開倉為true,平倉為false
cumQty Double 已成交數量
avgPx Double 成交均價
ordStatus String 訂單狀態,NEW -新單; PARTIALLY_ FILLED -部分成交; FILLED -全部成交; CANCELED -已撤; REJECTED -已拒; WAITING -等待(條件單)
iceberg Boolean 是否為冰山單
showQty Double 冰山單顯示數量
source String 訂單來源,Normal -正常下單; Conditional -條件單; StopWin -止盈單; StopLoss -止損單; TrailingStop -追迹止損單; SysRisk -爆倉單
stopLossPrice Double 止損價
stopWinPrice Double 止盈價
stopWinType Double 止盈類型,Limit/Market
trailingStop Double 追迹止損
triggerPrice Double 條件單觸發價
triggerType String 條件單觸發價類型,LAST -最後成交價,INDEX -標記價

# /api/trade/queryOrders

査詢用戶訂單歷史,訂單按時間倒敘排列。 GET請求。 請求參數:prevId,最新訂單id,返回更新時間在該訂單以後(包含該訂單)的訂單,空則返回所有記錄。 請求頻率限制:30次/分/Key。 響應數據描述:

參數 類型 描述 樣例
id String 訂單id,eg: O101-20190910-033720-922-1879
currency String 交易幣種
symbol String 合約名稱
created Date 訂單創建時間
modified Date 訂單發生變動時間
side String 訂單方向,Buy/Sell
type String 訂單類型,Limit/Market
price Double 訂單價格
qty Double 訂單數量
openPosition Boolean 開倉/平倉單,開倉為true,平倉為false
cumQty Double 已成交數量
avgPx Double 成交均價
ordStatus String 訂單狀態,NEW -新單; PARTIALLY_ FILLED -部分成交; FILLED -全部成交; CANCELED -已撤; REJECTED -已拒; WAITING -等待(條件單)
iceberg Boolean 是否為冰山單
showQty Double 冰山單顯示數量
source String 訂單來源,Normal -正常下單; Conditional -條件單; StopWin -止盈單; StopLoss -止損單; TrailingStop -追迹止損單; SysRisk -爆倉單
stopLossPrice Double 止損價
stopWinPrice Double 止盈價
stopWinType Double 止盈類型,Limit/Market
trailingStop Double 追迹止損
triggerPrice Double 條件單觸發價
triggerType String 條件單觸發價類型,LAST -最後成交價,INDEX -標記價

# /api/trade/queryOrderById

根據訂單Id查詢訂單。 請求頻率限制:5次/秒/Key。 響應數據描述:

參數 類型 描述 樣例
id String 訂單id,eg: O101-20190910-033720-922-1879
currency String 交易幣種
symbol String 合約名稱
created Date 訂單創建時間
modified Date 訂單發生變動時間
side String 訂單方向,Buy/Sell
type String 訂單類型,Limit/Market
price Double 訂單價格
qty Double 訂單數量
openPosition Boolean 開倉/平倉單,開倉為true,平倉為false
cumQty Double 已成交數量
avgPx Double 成交均價
ordStatus String 訂單狀態,NEW -新單; PARTIALLY_ FILLED -部分成交; FILLED -全部成交; CANCELED -已撤; REJECTED -已拒; WAITING -等待(條件單)
iceberg Boolean 是否為冰山單
showQty Double 冰山單顯示數量
source String 訂單來源,Normal -正常下單; Conditional -條件單; StopWin -止盈單; StopLoss -止損單; TrailingStop -追迹止損單; SysRisk -爆倉單
stopLossPrice Double 止損價
stopWinPrice Double 止盈價
stopWinType Double 止盈類型,Limit/Market
trailingStop Double 追迹止損
triggerPrice Double 條件單觸發價
triggerType String 條件單觸發價類型,LAST -最後成交價,INDEX -標記價

# /api/trade/queryPosition

査詢用戶的當前持倉。 GET請求。 請求頻率限制:60次/分/Key。 響應數據描述:

參數 類型 描述 樣例
currency String 交易幣種
symbol String 合約名稱
side String 持倉方向,Long - 多倉,Short - 空倉
qty Double 持倉數量
individualPosition Boolean 是否逐倉,true - 逐倉,false - 全倉
price Double 持倉價格
closableQty Double 可平數量
pnlRate Double 浮動盈虧比例
value Double 持倉價值
positionLeverage Double 杠杆
stopLossPrice Double 止損價設定
stopWinPrice Double 止盈價設定
stopWinType String 止盈類型,Limit/Market
trailingStop Double 追踪止損價距
trailingStopPrice Double 根據追迹止損算出的止損價
pnl Double 已實現盈虧
urPnL Double 浮動盈虧
liquidationPrice Double 爆倉價
deposit Double 保證金

# /api/trade/ledger

按幣種分頁査詢用戶交易帳號的帳本記錄,首次通過分頁獲取所有記錄,後續則通過傳入最新記錄ID獲取增量記錄。 GET請求。 請求頻率限制:10次/分/Key。 請求參數:currency,幣種; eg: BTC、EOS等; pageNo:分頁頁數; pageSize:每頁記錄數; from:最新記錄的ID。 響應數據描述:

參數 類型 描述 樣例
id String 帳單ID
currency String 帳號幣種
balance Double 餘額
amount Double 變動數量
transferType String 流水類型
created String 創建時間

# 流水類型(交易帳號)

類型 描述
INVITE_RETURN 邀請返傭
TRADE_FEE 交易費用
POSITION_SETTLE 倉位結算
ACCOUNT_TRANSFER_IN 從錢包帳戶轉入到交易帳戶
ACCOUNT_TRANSFER_OUT 從交易帳戶轉出到錢包帳戶
BUST_ORDER 爆倉
FUNDING 資金費率
GIFT_CREDIT 贈金

# /api/wallet/list

獲取用戶的錢包帳號清單。 GET請求。 請求頻率限制:10次/分/Key。 響應數據描述:

參數 類型 描述 樣例
currency String 帳號幣種
blocked Double 冻结(不可用)
available Double 可用餘額
balance Double 餘額

# /api/wallet/depositAddress

獲取用戶的錢包地址清單。 GET請求。 請求頻率限制:10次/分/Key。 響應數據描述:

參數 類型 描述 樣例
currency String 帳號幣種
address String 地址
memo String 部分幣種需要的標籤

# /api/wallet/ledger

按幣種分頁査詢用戶錢包帳號的帳本記錄,首次通過分頁獲取所有記錄,後續則通過傳入最新記錄ID獲取增量記錄。 GET請求。 請求頻率限制:10次/分/Key。 請求參數:currency,幣種,eg: BTC、EOS等; pageNo:分頁頁數; pageSize:每頁記錄數; from:最新記錄的ID。 響應數據描述:

參數 類型 描述 樣例
id String 帳單ID
currency String 帳號幣種
balance Double 餘額
amount Double 變動數量
fee Double 費用
transferType String 流水類型
transferState String 流水狀態
created String 創建時間

# 流水類型(钱包帳號)

類型 描述
DEPOSIT 充值
WITHDRAW 提現
TRANSFER_IN 從交易帳戶轉入到錢包帳戶
TRANSFER_OUT 從錢包帳戶轉出到交易帳戶
OTC_BUY OTC買
OTC_SELL OTC賣

# 流水狀態

類型 描述
WITHDRAW_REQUEST 提現申請
WITHDRAW_CANCEL 提現撤銷
WITHDRAW_REFUSAL 管理員拒絕提現
WITHDRAW_WAITING 提現在等待確認
WITHDRAW_CONFIRMING 提現在確認中
DEPOSIT_WAITING 充值在等待確認
DEPOSIT_CONFIRMING 充值在確認中,此狀態當前充值的金額不允許提現
AUDIT_SUCCESS 稽核成功
AUDIT_FAIL 稽核失敗
COMPLETE 已完成

# 交易 API (POST)

# /api/trade/enterOrder

下單介面,通過不同參數的組合,支持下普通單、條件單、高級單以及平倉單。 POST請求。 介面請求頻率設在10次/秒/Key。 請求參數描述:

參數 類型 描述 樣例
currency String 帳號幣種
hidden boolean 是否為隱藏單 true/false
showQty double 隱藏單顯示數量 當hidden為true時設定
openPosition boolean 開、平倉單 true為開倉,false為平倉
orderType String 訂單類型 Limit為限價單; Market為市價單
price Double 訂單價格 市價單價格可以為null
qty Double 訂單數量 正整數
side String 訂單方向 Buy買入,Sell賣出
symbol String 合約名稱 XBTCUSD,XEOSUSD,XBCHUSD等
stopLossPrice Double 止損價格 不能和追迹止損(trailingStop)同時設定
trailingStop Double 追迹止損 不能和止損價格(stopLossPrice)同時設定
stopWinPrice Double 止盈價格
stopWinType String 止盈類型 Limit為限價止盈,Market為市價止盈
triggerPrice Double 條件單觸發價
triggerType String 條件單觸發價類型 LAST為最後成交價觸發,INDEX為標記價觸發
tif String 訂單生效設定 GOOD_TILL_ CANCEL:一直有效至消失; IMMEDIATE_OR_ CANCEL:立即成交或取消; FILL_OR_ KILL:完全成交或取消; QUEUE_OR_ CANCEL:被動委託

# /api/trade/cancelOrder

根據訂單Id進行撤單。 POST請求。 介面請求頻率設在20次/秒/Key。 請求參數描述:

參數 類型 描述 樣例
orderId String 訂單 Id

# /api/trade/amendOrder

修改訂單資訊。 POST請求。 介面請求頻率設在5次/秒/Key。 請求參數描述:

參數 類型 描述 樣例
orderId String 訂單Id
price Double 訂單價格 訂單價格修改成功後,系統可能會生產一條新的訂單
qty Double 訂單數量 訂單數量新增修改成功後,系統可能會生產一條新的訂單
stopLossPrice Double 止損價格 不能和追迹止損(trailingStop)同時設定
trailingStop Double 追迹止損 追迹止損,不能和止損價格(stopLossPrice)同時設定
stopWinPrice Double 止盈價格
stopWinType String 止盈類型 Limit為限價止盈,Market為市價止盈
triggerPrice Double 條件單觸發價

# /api/trade/closePosition

市價全部平倉。 POST請求。 介面請求頻率設在4次/秒/Key。 請求參數描述:

參數 類型 描述 樣例
currency String 帳號幣種
symbol String 合約名稱 XBTCUSD,XEOSUSD,XBCHUSD等
side String 所平倉位的方向 Long為多倉,Short為空倉

# /api/trade/changePosLeverage

修改倉位杠杆設定。 POST請求。 介面請求頻率設在4次/秒/Key。 請求參數描述:

參數 類型 描述 樣例
currency String 帳號幣種
symbol String 合約名稱 XBTCUSD,XEOSUSD,XBCHUSD等
leverage Double 倉位杠杆

# /api/trade/riskSetting

修改倉位風控設定。 POST請求。 介面請求頻率設在5次/秒/Key。 請求參數描述:

參數 類型 描述 樣例
currency String 帳號幣種
symbol String 合約名稱 XBTCUSD,XEOSUSD,XBCHUSD等
side String 倉位方向 Long為多倉,Short為空倉
addDeposit Double 追加/减少保證金,只對逐倉模式 備註:追加/减少保證金不能與其他設定一起發送
stopLossPrice Double 止損價格 不能和追迹止損(trailingStop)同時設定
trailingStop Double 追迹止損 不能和止損價格(stopLossPrice)同時設定
stopWinPrice Double 止盈價格
stopWinType String 止盈類型 Limit為限價止盈,Market為市價止盈

# /api/trade/switchPosSide

切換帳號單雙向持倉模式。 POST請求。 介面請求頻率設在4次/秒/Key。 請求參數描述:

參數 類型 描述 樣例
currency String 帳號幣種
twoSidePosition boolean 切換為雙向持倉 true為雙向持倉; false為單向持倉

# /api/trade/changePosMode

將帳號持倉模式從逐倉切換為全倉,或從全倉切換為逐倉。 POST請求。 介面請求頻率設在4次/秒/Key。 請求參數描述:

參數 類型 描述 樣例
currency String 帳號幣種
individual Boolean true ->切換為逐倉模式; false ->切換為全倉模式

# 錯誤代碼清單

錯誤碼 描述
29000 創建API KEY的數量超出上限
29001 無效API KEY
29002 API KEY被禁用
29003 API KEY無許可權
29004 密文有誤
29005 請求超時
29006 無效IP地址
20041 IP地址被限制