Z Zise Developers
GET /v1/members/{id}/limits

该会员的额度占用(只读,不下发上限

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

给它是为了让你能解释「为什么这一笔被拒」—— 失败码本身刻意只给

limit_exceeded,不带阈值。

不下发上限。 上限是平台配置且随风控档位变化;下发一个数会被

你拿去在自己那边先判一次,于是两个事实源,而漂移的表现是

「你判过了,我方仍然拒」。

会员由路径参数定位,x-on-behalf-of 在这个端点上不生效。

路径参数两种标识都认。

window 自带作用域与日期(形如 exch:day:USDT-USD:2026-08-12

itr:send:day:2026-08-12),原样给、原样显示 —— 切开反而丢信息,

而窗口键的构成规则不是公开契约、随业务线新增而扩充。

used定点整数串,位数看该资产的 ledger_scale

(从 GET /v1/assets 取)。没有任何占用的会员返回空数组。

路径参数

字段类型必填说明
id string 必填 external_member_idmem_<uuid>这个端点不看 x-on-behalf-of,会员完全由这个路径参数决定。

响应

200OK
{
  "data": [
    {
      "window": "exch:day:USDT-USD:2026-08-12",
      "asset": "USDT",
      "used": "500000000",
      "op_count": 3,
      "updated_at": "2026-08-12T09:31:02.441Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}
404member_not_found(含「属于别的商户」)
调用样例
curl -X GET 'https://api.zise.com/v1/members/{id}/limits' \
  -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/members/{id}/limits",
  {
    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/members/{id}/limits",
    headers={
        "authorization": "Bearer $TOKEN",
        "x-zise-merchant": "$MERCHANT_ID",
        "x-on-behalf-of": "$MEMBER_ID"
    },
)
# 金额用 Decimal(str(...)),不要 float
data = res.json()