兑换订单列表（游标分页）

Scope exchange:read 代会员调用 · 必带 x-on-behalf-of

游标是不透明串，别自己拼。解不开的游标按「从头开始」处理而不是

报错 —— 我方换排序实现时你的下一次调用能自愈。

⚠ 这个端点的金额是最小单位整数串（"500000000"），

与 POST /v1/exchange/orders 的定点串不是同一种形态。

按同一行返回的资产去查 ledger_scale（清单里不带），自己插小数点。

查询参数

字段	类型	必填	说明
`limit`	integer	可选	每页条数。缺省 20，上限 100；非法值一律回落到 20。
`cursor`	string	可选	上一页返回的 `next_cursor`。不透明串，不要解析或自造。

字段	类型	必填	说明
`x-on-behalf-of`	string	必填	只返回这个会员在你名下的兑换单。

响应

200status 取值：quoted / executing / executed / failed / canceled / reversed（后者是后台冲正）。认不出的值原样存下并告警，不要 default。

{
  "data": [
    {
      "id": "exc_7a1e5c30-2b44-4c11-9f8e-31d0a7b62c45",
      "status": "executed",
      "from_asset": "USDT",
      "to_asset": "USD",
      "from_amount": "500000000",
      "to_amount": "498750000",
      "rate": "1.0000",
      "fee_asset": "USD",
      "fee_amount": "1250000",
      "created_at": "2026-08-12T09:30:00Z"
    }
  ],
  "next_cursor": "eyJ2IjoxfQ",
  "has_more": true
}

400member_context_required · member_not_found

403insufficient_scope

调用样例

curl -X GET 'https://api.zise.com/v1/exchange/orders' \
  -H 'authorization: Bearer $TOKEN' \
  -H 'x-zise-merchant: $MERCHANT_ID' \
  -H 'x-on-behalf-of: $MEMBER_ID'

const res = await fetch(
  "https://api.zise.com/v1/exchange/orders",
  {
    method: "GET",
    headers: {
      "authorization": "Bearer $TOKEN",
      "x-zise-merchant": "MERCHANT_ID",
      "x-on-behalf-of": "MEMBER_ID"
    },
  },
);
// 金额一律按字符串读，不要 JSON.parse 成 number
const data = await res.json();

import requests

res = requests.get(
    "https://api.zise.com/v1/exchange/orders",
    headers={
        "authorization": "Bearer $TOKEN",
        "x-zise-merchant": "$MERCHANT_ID",
        "x-on-behalf-of": "$MEMBER_ID"
    },
)
# 金额用 Decimal(str(...))，不要 float
data = res.json()

兑换订单列表（游标分页）

查询参数

请求头

响应