API 参考 › 会员

该会员的额度占用（只读，不下发上限）

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_id` 或 `mem_<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 'x-auth-token: Bearer $TOKEN' \
  -H 'x-on-behalf-of: $MEMBER_ID'

const res = await fetch("https://api.zise.com/v1/members/{id}/limits", {
  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/members/{id}/limits",
    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/members/{id}/limits",
    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/members/{id}/limits"))
    .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/members/{id}/limits');
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

{
  "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
}