你的提现地址簿(只读,没有 POST)
商户自身
⚠ 这个资源在开放 API 上没有写口,而且不是「还没做」。
新增提现地址只能在商户后台完成,那里有两道闸:强认证与
24 小时冷静期。冷静期这一道在机器接口上保得住,强认证保不住 ——
API Key 是常驻凭据,既没有第二因子,也没有任何「有个人坐在屏幕前」
的证据。而新增一个收款出口,正是账号被接管之后最直接的提款路径。
所以这一页只回答一个问题:我现在有哪些地址、哪些能用了。
usable是布尔结论,usable_at是冷静期结束的时刻。
冷静期未过的地址提现会被拒 —— 只给时间点的话你得自己比时钟,
而看不见这一位的人会以为地址加完即可用,然后在后台点提现被拒、
找不到原因。
- 已撤销的地址不出现(撤销不删行,只是不列)。
asset/network/label可能是空串:后台加地址时这三项
不是必填。别拿空的 network 去匹配你自己的链枚举。
这张表不分页(next_cursor 恒为 null)。
响应
200OK
{
"data": [
{
"id": "3f9c1a5e-88b1-4b0e-9a2d-7c1f0e5b4a33",
"asset": "USDT",
"network": "BSC",
"address": "0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed",
"label": "结算主地址",
"usable": true,
"usable_at": "2026-08-12T03:20:00.000Z",
"created_at": "2026-08-11T03:20:00.000Z"
}
],
"next_cursor": null,
"has_more": false
}403
insufficient_scope 缺 merchant:read请求
curl -X GET 'https://api.zise.com/v1/merchant/payout-addresses' \
-H 'x-auth-token: Bearer $TOKEN'const res = await fetch("https://api.zise.com/v1/merchant/payout-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/payout-addresses",
headers={
"x-auth-token": "Bearer $TOKEN",
},
)
# 金额用 Decimal(str(...)),不要 float
data = res.json()req, _ := http.NewRequest("GET", "https://api.zise.com/v1/merchant/payout-addresses",
nil)
req.Header.Set("x-auth-token", "Bearer $TOKEN")
res, err := http.DefaultClient.Do(req)
// 金额字段用 string 接,不要 float64HttpRequest req = HttpRequest.newBuilder()
.uri(URI.create("https://api.zise.com/v1/merchant/payout-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/payout-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": [
{
"id": "3f9c1a5e-88b1-4b0e-9a2d-7c1f0e5b4a33",
"asset": "USDT",
"network": "BSC",
"address": "0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed",
"label": "结算主地址",
"usable": true,
"usable_at": "2026-08-12T03:20:00.000Z",
"created_at": "2026-08-11T03:20:00.000Z"
}
],
"next_cursor": null,
"has_more": false
}