跳到主要内容

获取单个订单

请求类型 GET

接口描述: /v4/order/{orderId}

请求参数​

参数名类型是否必填默认值描述
orderIdnumber是—订单ID

限频规则​

  • 10次/秒/每apikey

请求示例​

curl --location --request GET 'https://sapi.xt.com/v4/order/xxxxxxxxxxx' \     // xxxxxxxxxxx：orderId
--header 'accept: */*' \
--header 'Content-Type: application/json' \
--header 'validate-algorithms: HmacSHA256' \
--header 'validate-recvwindow: 60000' \
--header 'validate-appkey: xxxxxxxxxx' \
--header 'validate-timestamp: xxxxxxxxxx' \
--header 'validate-signature: xxxxxxxxxx'

响应示例​

Response
{
  "rc": 0,
  "mc": "string",
  "ma": [{}],
  "result": {
    "symbol": "BTC_USDT",
    "orderId": "6216559590087220004",
    "clientOrderId": "16559590087220001",
    "baseCurrency": "string",
    "quoteCurrency": "string",
    "side": "BUY",                // 订单方向: BUY, SELL
    "type": "LIMIT",              // 订单类型: LIMIT, MARKET
    "timeInForce": "GTC",         // 有效方式: GTC, IOC, FOK, GTX
    "price": "40000",
    "origQty": "2",               // 原始数量
    "origQuoteQty": "48000",      // 原始金额
    "executedQty": "1.2",         // 已成交数量
    "leavingQty": "string",       // 待成交数量 (取消/拒绝时为0)
    "tradeBase": "2",             // 成交数量
    "tradeQuote": "48000",        // 成交金额
    "avgPrice": "42350",          // 平均成交价格
    "fee": "string",              // 手续费
    "feeCurrency": "string",
    "state": "NEW",               // 订单状态: NEW, PARTIALLY_FILLED, FILLED, CANCELED, REJECTED, EXPIRED
    "time": 1655958915583,        // 下单时间
    "ip": "127.0.0.1",            // 请求IP
    "updatedTime": 1655958915583  // 最后更新时间
  }
}