Z Zise Developers
GET /v1/merchant/deposit-addresses

预付充值地址清单

Scope merchant:read 商户自身

地址由我方分配,按 (商户, 网络) 复用 —— 同一条链上你永远只有一个地址。

只列已经拿到地址的那些:刚申请、上游还没建出来的行不出现在这里。

看不到你刚申请的那条不代表申请失败,重新 POST 一次即可。

⚠ 三处容易读错:

  • network 这里给的是展示名(如 TRON (TRC20)),而

POST 那一侧要的是短代码(如 TRC20)。原样回传会被拒。

  • asset 是按链反查出来的一个币种,而一条链上可能挂着多个币。

充值地址本身是链级的,同一条链上的其它代币打进来一样能到账 ——

别把这个字段当成「只能充这个币」。

  • memo 在需要它的链上缺了钱到不了账。空串表示这条链不需要,

不表示可以省略。

响应

200OK
{
  "data": [
    {
      "network": "TRON (TRC20)",
      "asset": "USDT",
      "address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
      "memo": "",
      "created_at": "2026-08-11T11:02:44.010Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}
403insufficient_scopemerchant:read
调用样例
curl -X GET 'https://api.zise.com/v1/merchant/deposit-addresses' \
  -H 'authorization: Bearer $TOKEN' \
  -H 'x-zise-merchant: $MERCHANT_ID'
const res = await fetch(
  "https://api.zise.com/v1/merchant/deposit-addresses",
  {
    method: "GET",
    headers: {
      "authorization": "Bearer $TOKEN",
      "x-zise-merchant": "MERCHANT_ID"
    },
  },
);
// 金额一律按字符串读,不要 JSON.parse 成 number
const data = await res.json();
import requests

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