Z Zise Developers
/
API 参考 › 兑换

兑换单详情（按 id 查一笔）

GET /v1/exchange/orders/{id} scope: exchange:read
代会员调用 · 必带 x-on-behalf-of

这个端点存在的理由是超时后确认「到底成没成」。成交请求超时时你

手上一定有一个 id：走锁价的话 quote_id 就是订单号，不走锁价的话

用同一把幂等键重投会拿回原单（duplicated: true）。在它出现之前，

查一笔具体的兑换只能从列表最新一页往回翻。

⚠ 金额是定点十进制串（"500.000000"），与

POST /v1/exchange/orders、POST /v1/exchange/quotes 一致；

而 GET /v1/exchange/orders（列表）给的是最小单位整数串。

列表是这条线上唯一的异类 —— 不要跨这两个端点复用解析函数。

三个 ledger_scale_* 随行下发，任何一侧都不用猜。

⚠ status 认不出就原样存下并告警，不要 default 成「处理中」。

这条线没有中间态：quoted 是一份还没成交的锁价（到期即作废），

executed 是终态，reversed 是后台冲正。

⚠ 我方的成本价与上游价一个字段都不下发（与汇款 / 扫码付详情同一

条纪律）。你看到的 rate 与 fee_amount 就是这一单对你的会员生效的

那一套。

路径参数

字段类型必填说明
id string 必填 订单号。带不带 exc_ 前缀都认（服务端会剥）。锁价拿到的 quote_id 也是它。
字段类型必填说明
x-on-behalf-of string 必填 代哪个会员查。两种标识都收：你自己的 external_member_id， 或我方发出去的 mem_<uuid>。

响应

200OK。quote_expires_at 只在 status = quoted 时有意义（成交之后 它只是一段历史）；为空表示这一单不是经锁价建出来的。 executed_at 未成交时是空串 —— 不要用它反推状态，状态看 status。
{
  "id": "exc_7a1e5c30-2b44-4c11-9f8e-31d0a7b62c45",
  "status": "executed",
  "from_asset": "USDT",
  "to_asset": "USD",
  "from_amount": "500.000000",
  "to_amount": "498.750000",
  "rate": "1.0000",
  "fee_asset": "USD",
  "fee_amount": "1.250000",
  "ledger_scale_from": 6,
  "ledger_scale_to": 6,
  "ledger_scale_fee": 6,
  "quote_expires_at": "2026-08-13T09:31:30Z",
  "created_at": "2026-08-13T09:30:00Z",
  "executed_at": "2026-08-13T09:30:12Z"
}
400member_context_required 缺 x-on-behalf-of · member_not_found 会员不存在 / 不属于你 / 已停用（三种同一响应）
403insufficient_scope —— 这把 Key 没有 exchange:read
404not_found —— 这一单不在这个会员名下，或根本不存在。 两种同一响应：分开就等于给了一个订单号探测接口。
请求 
curl -X GET 'https://api.zise.com/v1/exchange/orders/{id}' \
  -H 'x-auth-token: Bearer $TOKEN' \
  -H 'x-on-behalf-of: $MEMBER_ID'
const res = await fetch("https://api.zise.com/v1/exchange/orders/{id}", {
  method: "GET",
  headers: {
    "x-auth-token": "Bearer $TOKEN",
    "x-on-behalf-of": "$MEMBER_ID",
  },
});
// 金额按字符串读，别让它变成 number
const data = await res.json();
import requests

res = requests.get(
    "https://api.zise.com/v1/exchange/orders/{id}",
    headers={
        "x-auth-token": "Bearer $TOKEN",
        "x-on-behalf-of": "$MEMBER_ID",
    },
)
# 金额用 Decimal(str(...))，不要 float
data = res.json()
req, _ := http.NewRequest("GET", "https://api.zise.com/v1/exchange/orders/{id}",
    nil)
req.Header.Set("x-auth-token", "Bearer $TOKEN")
req.Header.Set("x-on-behalf-of", "$MEMBER_ID")
res, err := http.DefaultClient.Do(req)
// 金额字段用 string 接，不要 float64
HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://api.zise.com/v1/exchange/orders/{id}"))
    .header("x-auth-token", "Bearer $TOKEN")
    .header("x-on-behalf-of", "$MEMBER_ID")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();
// 金额字段用 String / BigDecimal，不要 double
$ch = curl_init('https://api.zise.com/v1/exchange/orders/{id}');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'x-auth-token: Bearer $TOKEN',
    'x-on-behalf-of: $MEMBER_ID',
  ],
]);
$res = curl_exec($ch);
// 金额用 bcmath / 字符串，不要 floatval
200 
{
  "id": "exc_7a1e5c30-2b44-4c11-9f8e-31d0a7b62c45",
  "status": "executed",
  "from_asset": "USDT",
  "to_asset": "USD",
  "from_amount": "500.000000",
  "to_amount": "498.750000",
  "rate": "1.0000",
  "fee_asset": "USD",
  "fee_amount": "1.250000",
  "ledger_scale_from": 6,
  "ledger_scale_to": 6,
  "ledger_scale_fee": 6,
  "quote_expires_at": "2026-08-13T09:31:30Z",
  "created_at": "2026-08-13T09:30:00Z",
  "executed_at": "2026-08-13T09:30:12Z"
}