BTCMEX HTTP REST API
通過使用我們的 HTTP REST API 示例,可以迅速開始使用 API 進行交易。
API Endpoints
請查看 API 流覽器 中的 REST 文檔來瞭解 API 以及返回類型。
接入準備
在你登入 BTCMEX 後,你可以訪問API 密鑰管理介面,創建不同許可權的 API Secret。
當前支持的許可權有兩種:
- 閱讀(Reading) ,只能用於查詢數據API,例如:訂單查詢,成交查詢等,不能進行交易等交易操作。
-
委託+閱讀(Entrust+Reading):可使用所有 API 介面,包括下單、改單、撤單等。
創建成功後請務必記住以下資訊:
- API 訪問密鑰
-
API Secret 簽名認證加密所使用的密鑰(僅申請時可見)
注意:創建 API Key 時可以綁定 IP 地址
風險提示:這兩個密鑰與帳號安全緊密相關,無論何時都請勿將二者同時向其他人透露。API Key 的洩露可能會造成您的資產損失,若發現 API Key 洩露請儘快刪除該 API Key。
API 的密鑰使用方法見 API 密鑰使用方法
API 規範
BTCMEX API 中的 REST API 符合 Swagger規範。 任何相容 Swagger 的客戶端都可以連接到 BTCMEX API。
請注意,所有返回的比特幣單位均為 Satoshi(聰): 1 XBt (Satoshi) = 0.00000001 XBT (Bitcoin)。
限頻規則
每個 IP 地址在 1 秒之內限制 30 次。
如果你已超過頻率限制,並且認為這是合理的需求,請聯繫客服來提高你的頻率限制。
當你發送提高頻率限制的郵件給我們時,請包括︰
-
您的應用程式的目的和預期的增長
-
您所需的速率限制
-
確認您的程式在有效地使用 API
委託數量限制
為了保持有序的市場,BTCMEX 為每個用戶的待交易委託數量設置上限:
-
每個用戶每個合約最多 200 筆未執行交易委託數量;
-
每個用戶每個合約最多 20 筆止損交易委託數量;
當發出超過這些上限的新交易委託時,該交易將被拒絕,並顯示“太多交易委託”。
最小交易限制
我們特意將 BTCMEX 產品的合約規模設定為很小的值,以鼓勵機構和個人交易員在 BTCMEX 上進行交易。 但是,一些交易員濫用這種機制,並通過發送很多小訂單來破壞訂單簿。
如果用戶的未執行交易訂單過多且總值低於 0.0025 XBT ,則用戶會被標記為垃圾用戶。
如果您被標記為垃圾用戶:
-
您的帳戶交易許可權將被限制為只可平倉或撤單;
-
已發出的價值低於 0.0025 XBT的垃圾委託將被自動撤單;
- 如果您想要解除垃圾帳戶限制,請用該帳戶所綁定的郵箱向 support@btcmex.com發送郵件申請解除限制,或等待 24 小時後自動恢復。
API 密鑰使用方法
身份驗證可通過發送以下 HTTP Headers 完成:
api-expires :這個 UNIX 時間戳以後請求不再有效, 這是為了防止重放攻擊。UNIX 時間戳以秒為單位。 例如, 2019-08-08T10:15:42Z 為 1565230542。此時間戳在到達交易引擎前會與我們的系統時間進行比較。
api-key :您的API公鑰
api-signature: 你的當前請求的簽名。 它的計算方法為 hex(HMAC_SHA256(apiSecret, verb + path + nonce + data))。 其中 verb 是 GET/POST/PUT/DELETE 中的一個。請參閱 我們的示例。
評論
0 條評論
請登入寫評論。