账户中心 › API 参考 › 商户账户

预付充值地址清单

GET /v1/merchant/deposit-addresses scope: merchant:read

商户自身

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

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

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

⚠ 三处容易读错：

network 给的是机读码（TRC20 / ERC20 / BSC …），可以原样

回传给 POST；展示名在 network_name（TRON (TRC20)）。

这是一处破坏性变更：此前 network 出的是展示名，而 POST 要的是

机读码 —— 原样回传必然 asset_not_allowed。现在两边同口径了。

机读码的完整清单在 GET /v1/assets 的 networks[]。

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

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

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

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

不表示可以省略。

响应

200OK

{
  "data": [
    {
      "network": "TRC20",
      "network_name": "TRON (TRC20)",
      "asset": "USDT",
      "address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
      "memo": "",
      "created_at": "2026-08-11T11:02:44.010Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}

403insufficient_scope 缺 merchant:read

请求

curl -X GET 'https://api.zise.com/v1/merchant/deposit-addresses' \
  -H 'x-auth-token: Bearer $TOKEN'

const res = await fetch("https://api.zise.com/v1/merchant/deposit-addresses", {
  method: "GET",
  headers: {
    "x-auth-token": "Bearer $TOKEN",
  },
});
// 金额按字符串读，别让它变成 number
const data = await res.json();

import requests

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

req, _ := http.NewRequest("GET", "https://api.zise.com/v1/merchant/deposit-addresses",
    nil)
req.Header.Set("x-auth-token", "Bearer $TOKEN")
res, err := http.DefaultClient.Do(req)
// 金额字段用 string 接，不要 float64

HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://api.zise.com/v1/merchant/deposit-addresses"))
    .header("x-auth-token", "Bearer $TOKEN")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();
// 金额字段用 String / BigDecimal，不要 double

$ch = curl_init('https://api.zise.com/v1/merchant/deposit-addresses');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'x-auth-token: Bearer $TOKEN',
  ],
]);
$res = curl_exec($ch);
// 金额用 bcmath / 字符串，不要 floatval

200

{
  "data": [
    {
      "network": "TRC20",
      "network_name": "TRON (TRC20)",
      "asset": "USDT",
      "address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
      "memo": "",
      "created_at": "2026-08-11T11:02:44.010Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}