Z Zise Developers
/
稳定币账户 › API 参考 › 充值

入金记录（我方账本视角）

GET /v1/deposits scope: deposits:read
代会员调用 · 必带 x-on-behalf-of

列的是我方账本里真的记过的那些入金凭证，不是你那边的入金台账。

对账时以这一份为准：你上报了但这里没有的，就是没记上。

id 是 dep_ + 你当初传的 reference，出参里另有一个独立的

reference 字段 —— 拿它直接跟你自己的台账对，不需要额外映射表，

也不用去切 id 的前缀。

⚠ 这是真游标分页，与 GET /v1/transactions 同一套。

照 while (has_more) 写就对了；只取第一页会静默漏掉更早的记录。

⚠⚠ amount 是「该资产 ledger_scale 位的定点整数串」，

不是插好小数点的十进制数：USDT（scale 6）的 1500 在这里是

"1500000000"。这与 POST /v1/deposits 的响应形态不同

（那一边给的是 "1500.000000"）。差别是历史遗留，我方不会

悄悄改这个端点的格式 —— 改一次，已经按整数解完的调用方会在我方

部署的那一刻把金额算大 10^scale 倍且零报错。

ledger_scale 与金额一起下发，请用它还原，不要假定 6 位。

⚠ 链上四个字段（network / txid / from_address / to_address）

只有在你上报时传了才有值；POST /v1/deposits 支持这几个字段

之前记的那些入金，这里一律是空串 —— 那是「当时确实没有溯源」，

不是「查不到」。

查询参数

字段类型必填说明
limit integer 可选 缺省 20，上限 100。
cursor string 可选 上一页的 next_cursor 原样回传。
reference string 可选 按你当初传的业务流水号精确过滤（不带 dep_ 前缀）。 ⚠ 这不是 GET /v1/deposits/{id} 的重复：流水号里含 / 时它 进不了路径段，这一条是那种情况下唯一走得通的查法。
asset string 可选 按资产过滤，自动转大写。
from string 可选 起始时间（含），ISO-8601。比的是入账时间。
to string 可选 结束时间（不含），ISO-8601。
字段类型必填说明
x-on-behalf-of string 必填 查谁的入金记录

响应

200OK
{
  "data": [
    {
      "id": "dep_0xa3f1c2e9-0",
      "reference": "0xa3f1c2e9-0",
      "asset": "USDT",
      "amount": "1500000000",
      "ledger_scale": 6,
      "status": "credited",
      "network": "BSC",
      "txid": "0xa3f1c2b7d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8f",
      "from_address": "0x9C3f1B7a5E2d4C6b8A0f2E4d6C8b0A2f4E6d8C0b",
      "to_address": "0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed",
      "created_at": "2026-08-12T08:04:57.204Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}
400invalid_fields from 或 to 不是合法 ISO-8601
404member_not_found 会员不存在 / 属于别的商户 / 已停用
请求 
curl -X GET 'https://api.zise.com/v1/deposits' \
  -H 'x-auth-token: Bearer $TOKEN' \
  -H 'x-on-behalf-of: $MEMBER_ID'
const res = await fetch("https://api.zise.com/v1/deposits", {
  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/deposits",
    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/deposits",
    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/deposits"))
    .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/deposits');
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": [
    {
      "id": "dep_0xa3f1c2e9-0",
      "reference": "0xa3f1c2e9-0",
      "asset": "USDT",
      "amount": "1500000000",
      "ledger_scale": 6,
      "status": "credited",
      "network": "BSC",
      "txid": "0xa3f1c2b7d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8f",
      "from_address": "0x9C3f1B7a5E2d4C6b8A0f2E4d6C8b0A2f4E6d8C0b",
      "to_address": "0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed",
      "created_at": "2026-08-12T08:04:57.204Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}