Skip to content

下单

下单

创建新的订单。支持限价单、市价单，以及带止盈止损的订单。

HTTP 请求

POST
/api/perp-trade-api/trade/placeorder

请求频率限制:

  • 建议不超过 10 次/秒

认证要求:

  • 需要 JWT Token
  • 需要 X-Wallet-Address 请求头

请求头

名称 类型 必填 描述
Authorization string 是 JWT Token，格式：Bearer {token}
X-Wallet-Address string 是 钱包地址（签名地址）

注意

  • X-Wallet-Address 是请求头携带的签名地址
  • 下单时签名地址（可能是子账户）和订单所属地址（creator）可能不同

请求参数

名称 类型 必填 描述
symbol string 是 交易对，如 ETH-PERP
price string 是 价格（BigInteger 字符串）
quantity string 是 数量（BigInteger 字符串）
side string 是 交易方向：BUY（买入/开多）或 SELL（卖出/开空）
orderType string 是 订单类型：LIMIT（限价）或 MARKET（市价）
leverage string 是 杠杆倍数（BigInteger 字符串）
salt string 是 签名 salt（时间戳，毫秒）
creator string 是 订单所属主账户地址
orderSignature string 是 订单签名
clientId string 否 客户端 ID，用于订单追踪
reduceOnly boolean 否 是否只减仓，默认为 false
triggerWay string 否 标记价触发方式，默认为 "oracle"
tpOrderType string 否 止盈订单类型：LIMIT 或 MARKET
tpTriggerPrice string 否 止盈触发价格
tpOrderPrice string 否 止盈委托价格（市价单为 0）
tpSalt string 否 止盈订单签名 salt
tpOrderSignature string 否 止盈订单签名
slOrderType string 否 止损订单类型：LIMIT 或 MARKET
slTriggerPrice string 否 止损触发价格
slOrderPrice string 否 止损委托价格（市价单为 0）
slSalt string 否 止损订单签名 salt
slOrderSignature string 否 止损订单签名

重要提示

  • salt 必须是当前时间戳（毫秒），允许误差范围：当前时间 ± 5 分钟
  • 如果设置了止盈止损，主订单不能设置为 reduceOnly=true
  • 市价单的委托价格必须为 0
  • 价格和数量不能为负数
  • 存在止盈止损时，主订单不能为减仓单

请求示例

{
  "symbol": "ETH-PERP",
  "price": "2500000000000000000000",
  "quantity": "1000000000000000000",
  "side": "BUY",
  "orderType": "LIMIT",
  "leverage": "5000000000000000000",
  "salt": "1700000000000",
  "creator": "0xab7f6e97232d633689cf762989455cceb769587c69a9f09a23f537f5605f9e78",
  "orderSignature": "0x123...",
  "clientId": "my-order-001",
  "reduceOnly": false,
  "triggerWay": "oracle",
  "tpOrderType": "LIMIT",
  "tpTriggerPrice": "2600000000000000000000",
  "tpOrderPrice": "2600000000000000000000",
  "tpSalt": "1700000000001",
  "tpOrderSignature": "0x456...",
  "slOrderType": "MARKET",
  "slTriggerPrice": "2400000000000000000000",
  "slOrderPrice": "0",
  "slSalt": "1700000000002",
  "slOrderSignature": "0x789..."
}

响应字段说明

名称 类型 描述
data string 订单哈希（orderHash）

响应示例

{
  "code": 200,
  "message": "success",
  "data": "0xabc123def456..."
}