查询成交明细

/sapi/v1/trade/order/details

请求类型: GET

是否验签: 是

接口权限: 读取

限频: 每个account 3秒最多 144 次请求(交易接口3秒最多 72 次请求，查询接口3秒最多 72 次请求) (该account的所有币种和不同到期日的合约的所有私有接口共享该限制) 。

接口描述: 此接口用于查询合约进3天订单成交明细

请求地址

环境	地址
线上环境	https://api.sunx.io
线上环境（aws客户首选）	https://api.sunx.io

请求参数

参数	数据类型	是否必填	描述	取值范围	默认值
contract_code	String	false	合约代码
order_id	String	false	订单的订单 ID
start_time	String	false	查询开始时间，UNIX时间戳，以毫秒为单位。	取值范围 [((end-time) – 48h), (end-time)] ，查询窗口最大为48小时，窗口平移范围为最近90天。 默认值 (now) – 48h
end_time	String	false	查询结束时间，UNIX时间戳，以毫秒为单位。	取值范围 [(present-90d), present] ，查询窗口最大为48小时，窗口平移范围为最近90天。 默认值：now
from	Long	false	查询的起始id，默认从0开始
limit	Integer	false	分页页面大小，默认为10，最大为100。
direct	String	false	翻页方向，prev, next，默认next

响应参数

参数	数据类型	是否必填	描述	取值范围
id	String	true	查询id
contract_code	String	true	合约代码	永续："BTC-USDT"... ，交割："BTC-USDT-210625"...
order_id	String	true	订单ID
trade_id	String	true	成交id
side	String	true	交易方向，buy表示买，sell表示卖。
position_side	String	true	仓位方向	"long":多 "short":空 “both”:单向持仓
order_type	String	true	成交类型 "1":"trade", "3":"liquidation" ,"4":"delivery","22":"adl"
margin_mode	String	true	保证金模式	cross：全仓
type	String	true	订单类型；枚举market, limit, post_only
role	String	true	成交角色maker, taker
trade_price	String	true	成交价格
trade_volume	String	true	成交量（张）
trade_turnover	String	true	成交金额（成交数量 * 合约面值 * 成交价格）
created_time	String	true	创建时间
updated_time	String	true	更新时间，默认为撮合成交时间
order_source	String	true	订单来源；	system:系统、web:用户网页、api:用户API、m:用户M站、risk:风控系统、settlement:交割结算、ios：ios客户端、android：安卓客户端、windows：windows客户端、mac：mac客户端、trigger：计划委托触发、tpsl:止盈止损触发、ADL: adl订单）
fee_currency	String	true	手续费币种，多个则使用","分隔
trade_fee	String	true	总手续费(U)
deduction_price	String	true	抵扣币种价格(USDT)
profit	String	true	平仓盈亏
contract_type	String	true	合约类型	swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）

请求示例

GET https://api.sunperp.com/sapi/v1/trade/order/details?order_id=1343541341268738048&SignatureVersion=2&SignatureVersion=2&AccessKeyId=<your key>&Signature=<your signature>&SignatureMethod=HmacSHA256&Timestamp=2025-09-16T07%3A16%3A15

响应示例

{
  "code": 200,
  "message": "Success",
  "data": [
    {
      "id": "1124147771",
      "contract_code": "BTC-USDT",
      "order_id": "1343541341268738048",
      "trade_id": "100000032538647",
      "side": "sell",
      "position_side": "short",
      "order_type": "1",
      "margin_mode": "cross",
      "type": "limit",
      "role": "TAKER",
      "trade_price": "31400",
      "trade_volume": "1",
      "trade_turnover": "31.4",
      "created_time": 1740366817564,
      "updated_time": 1740366817564,
      "order_source": "api",
      "fee_currency": "USDT",
      "trade_fee": "0.01884",
      "deduction_price": "",
      "profit": "0",
      "contract_type": "swap"
    }
  ],
  "ts": 1740377316667
}