成交流水

GET/api/v1/markets/{marketId}/trades公开

Trading API价 E4 · 量 E2 · 金额 E6（整数）YES | NO

按 (ts_ms DESC, seq DESC) 倒序；ts_ms 缺失的历史行排最末尾不丢弃。分页是 keyset:nextCursor 非空则原样带回 before 翻更早一段。跨时间分析型读，传 `minCursor` 直接 400。

路径参数

marketIdstringpath必填
引擎市场 id（读取类端点不接受 slug，除非该端点文档另有说明）
示例"mkt-0001"

查询参数

beforestringquery可选
不透明游标（上一页 nextCursor）
limitintegerquery可选
每页条数（1–500）
默认100范围1 – 500示例20

响应

200成交一页

tradesobject(TradeResponse)[]
成交列表，最新在前
takerOrderIdstring
吃单订单 id
示例"takerOrder_01K5H2M3N7"
makerOrderIdstring
挂单订单 id
示例"makerOrder_01K5H2M3N7"
priceE4integer
成交价，YES 计价（1e-4）
示例5200
sizeE2int64
成交量（1e-2 份）
示例1000
settlementMINT | MATCH | MERGE | REDEEM
MINT=铸币；MATCH=对碰；MERGE=合并；REDEEM=赎回
示例"MINT"
seqint64
引擎内序号（同市场单调）
示例1
tsMsint64可为空
撮合时刻（epoch 毫秒）；未记录时间戳的历史成交为 null，排在流水最末尾
示例1758240000000
nextCursorstring可为空
不透明游标（编码 (ts_ms, seq)）;null = 已到最后一页
示例"eyJhZnRlciI6I…dC0wMDIwIn0"

在响应示例中切换状态码查看错误响应，完整错误码见错误码页。

请求

curl -X GET "$BASE_URL/api/v1/markets/mkt-0001/trades?limit=100"

响应

成交一页

{
  "trades": [
    {
      "takerOrderId": "takerOrder_01K5H2M3N7",
      "makerOrderId": "makerOrder_01K5H2M3N7",
      "priceE4": 5200,
      "sizeE2": 1000,
      "settlement": "MINT",
      "seq": 1,
      "tsMs": 1758240000000
    }
  ],
  "nextCursor": "eyJhZnRlciI6Im1rdC0wMDIwIn0"
}

路径参数

marketIdstringpath必填
引擎市场 id（读取类端点不接受 slug，除非该端点文档另有说明）
示例"mkt-0001"

查询参数

beforestringquery可选
不透明游标（上一页 nextCursor）
limitintegerquery可选
每页条数（1–500）
默认100范围1 – 500示例20

响应

200成交一页

tradesobject(TradeResponse)[]
成交列表，最新在前
takerOrderIdstring
吃单订单 id
示例"takerOrder_01K5H2M3N7"
makerOrderIdstring
挂单订单 id
示例"makerOrder_01K5H2M3N7"
priceE4integer
成交价，YES 计价（1e-4）
示例5200
sizeE2int64
成交量（1e-2 份）
示例1000
settlementMINT | MATCH | MERGE | REDEEM
MINT=铸币；MATCH=对碰；MERGE=合并；REDEEM=赎回
示例"MINT"
seqint64
引擎内序号（同市场单调）
示例1
tsMsint64可为空
撮合时刻（epoch 毫秒）；未记录时间戳的历史成交为 null，排在流水最末尾
示例1758240000000
nextCursorstring可为空
不透明游标（编码 (ts_ms, seq)）;null = 已到最后一页
示例"eyJhZnRlciI6I…dC0wMDIwIn0"

在响应示例中切换状态码查看错误响应，完整错误码见错误码页。