跳转到主要内容

创建新订单.

POST 
/order

下订单​

此端点用于下订单。请参阅下面的各个字段以获取更多关于使用的详细信息。

订单类型​

所有订单都需要一个symbol（符号）。除非另有说明，其他字段都是可选的。

这些是有效的ordType（订单类型）：

  • 限制单：默认订单类型。需指定orderQty（订单数量）和price（价格）。
  • 市价单：传统市价单。市价单将执行，直到全部成交或您的破产价格被达到。（此时它将取消）。
  • 止损单：止损市价单。需指定orderQty（订单数量）和stopPx（止损价格）。达到stopPx的时候，订单将会进入挂单。
    • 在卖单中，如果触发价格低于stopPx则触发订单。在买单中，则相反。
    • 注意：止损单在触发前并不占用保证金。务必确保您的账户中有充足保证金以便完全触发订单。
    • Close（平仓）止损单不需要orderQty。请参阅下方执行说明。
  • 止损限价单：如同止损市价单，但不是进入市价单，而是进入限价单。需指定orderQty（订单数量）、stopPx（止损价格）和price（价格）。
  • 止盈触及市价单：类似于止损单，但触发方向相反。对于止盈订单很好用。
  • 止盈触及限价单：如上所述，适用于止盈限价单。
  • 盯盘单：允许用户以当前市场价格为相对基准提交限价单。需指定pegPriceType（盯盘价格类型）和pegOffsetValue（盯盘偏移值）。
    • 盯盘单必须拥有execInst（执行指令）为Fixed（固定）。这意味着限价值在订单被接受的时候确定并且不会随参考价格变化。
    • PrimaryPeg（主盯盘）：价格相对于近端价格设定。
    • MarketPeg（市场盯盘）：价格相对于远端价格设定。
    • 没有ordType（订单类型）的pegPriceType（盯盘价格类型）将被视作盯盘订单。

执行说明​

支持以下execInst（执行指令）。如果使用多个，使用逗号分隔（例如 LastPrice,Close）。

  • ParticipateDoNotInitiate（参与而不发起）：也称为被动委托。如果此委托在放置时即会被执行，则会取消。这旨在保护您在订单运输期间远端触发器将价格向您移动。它并不意在用于投机远端触发器在提交后远离—我们认为这样的行为是滥用，并且监控此行为。
  • MarkPrice, LastPrice, IndexPrice：用于止损和触碰市价单以确定触发价格。默认使用MarkPrice。也用于盯盘订单以定义LastPeg（最后盯盘）的值。IndexPrice（指数价格）不适用于现货交易品种。
  • ReduceOnly （仅减仓）：一个ReduceOnly订单只能减少您的仓位而不能增加。如果您有一个ReduceOnly限价单在订单簿中，并在订单被其他订单减少时, 其订单数量将被修改向下或取消。如有多个ReduceOnly订单, 则最不积极的被首先修改。不适用于现货交易品种。
  • Close（平仓）：Close意味着ReduceOnly（仅减仓）。一个Close订单将在打开数量超过当前仓位的情况下取消其他同一方向和符号的活动限价订单。这对止损来说很有用：通过取消这些订单，确保Close止损能执行且仅能执行至您仓位的最大数量。如果未指定orderQty，则Close订单的orderQty（订单数量）等于当前仓位的大小。不适用于现货交易品种。
    • 请注意，未指定orderQty的Close订单需要一个siden（方向），以告知BitMEX是应该在stopPx（止损价格）之上还是之下触发。
  • LastWithinMark（在标记价格内成交）：用于使用LastPrice的止损订单，以允许止损触发仅在以下情况：
    • 对于卖停损市价单/限价单：
      • 最新成交价 ≤ 止损价
      • 最新成交价 ≥ 标记价格× (1-5%)
    • 对于买停损市价单/限价单：
      • 最新成交价 ≥ 止损价
      • 最新成交价 ≤ 标记价格× (1+5%)
    • 不适用于现货交易标的。
  • Fixed（固定）：盯盘订单必须有一个execInst（执行指令）为Fixed（固定）。这意味着限价在订单被接受时设定且不会随着参考价格变化。

盯盘订单​

盯盘订单允许用户以当前市场价格为相对基准提交限价单。限价在订单提交时设定一次，不随参考价格变化。此订单类型并非意在在提交后盯盘价格反方向移动投机——我们视此类行为为滥用并监控它。

盯盘单的ordType（订单类型）为Pegged（盯盘），execInst（执行指令）为Fixed（固定）。

此外，还必须提交pegPriceType（盯盘价格类型）和pegOffsetValue（盯盘偏移值）：

  • PrimaryPeg - 价格是相对于 近端 价格设定
  • MarketPeg - 价格是相对于 远端价格设定

追踪止损​

使用pegPriceType（盯盘价格类型）为 TrailingStopPeg（追踪止损盯盘）创建追踪止损。

价格在提交时设定，并且如果基础价格（最新成交价/标记价格/指数价格）移动超过0.1%，则每秒更新一次。stopPx（止损价格）会随着市场远离盯盘而移动，并在市场接近盯盘的时候冻结。

使用pegOffsetValue（盯盘偏移值）来设置您订单的stopPx（止损价）。盯盘被设定为在execInst（执行指令）（默认为 MarkPrice）指定的触发价格。对卖出止损和触及买入订单使用负偏移。

需要ordType（订单类型）：Stop（止损）、StopLimit（止损限价）、MarketIfTouched（触及市价单）、LimitIfTouched（触及限价单）。

关联订单​

关联订单是一项高级功能。非常强大，但其使用需要仔细编码和测试。请仔细阅读本文档并在开发时使用Testnet Exchange。

BitMEX提供四种高级关联订单类型：

  • OCO：一取消则另一。标准止损/止盈技术的非常灵活版本。多个订单可以使用单个clOrdLinkID（客户订单链接 ID）关联在一起。给这一系列订单发送 contingencyType 的订单。首个完全或部分执行（或对Stop订单激活）的订单将会取消使用相同clOrdLinkID的其他订单。
  • OTO：一个触发则另一个。给初始订单发送一个contingencyType为'OneTriggersTheOther' 的订单后，接下来的订单拥有相同clOrdLinkID的订单将不会被触发，直到初始订单完全执行。

追踪止损​

您可以使用pegPriceType（盯盘价格类型）为 'TrailingStopPeg'（追踪止损盯盘）创建追踪止损。其盯止损价格stopPx（止损价）将在市场远离盯盘时移动，并在市场向盯盘移动时冻结。

使用pegOffsetValue（盯盘偏移值）来设置您订单的stopPx（止损价）。盯盘设置为在execInst（执行指令）（默认'MarkPrice'）指定的触发价格。对卖出止损和触及买入订单使用负偏移。

需要ordType（订单类型）：'Stop'（止损）、'StopLimit'（止损限价）、'MarketIfTouched'（触及市价）、'LimitIfTouched'（触及限价）。

简单数量​

简单数量自 2018/10/26 起被弃用

速率限制​

您可以通过使用修改端点（PUT /order）提高对市场波动的响应能力，同时保持在速率限制以下。这使您可以留在市场中，但避免取消/替换周期。

跟踪您的订单​

如果您想自己跟踪订单 ID，请为每个订单设置一个唯一的clOrdID（客户订单 ID）。该clOrdID将会作为订单及任何相关执行的属性返回（包括在WebSocket上），并可用于获取或取消订单。最大长度为36个字符。

您还可以通过修改订单、提供一个origClOrdID，以及将期望的新 ID 作为clOrdID参数来改变clOrdID，如下所示：

# 修改订单的 leavesQty，并更新其 clOrdID 为 "def-456"
PUT /api/v1/order {"origClOrdID": "abc-123", "clOrdID": "def-456", "leavesQty": 1000}

请求​

响应​

请求成功