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 条评论
请登录写评论。