Account Center › API Reference › Merchant Account

Prepaid deposit address list

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

Merchant account

We allocate addresses and reuse them by merchant and network; you always have one address per chain.

Lists only entries with an address already allocated. Newly requested entries still being created upstream are omitted. Not seeing a just-requested address does not mean failure; submit POST again.

⚠ Three commonly misread details:

network is the machine-readable code (TRC20 / ERC20 / BSC, etc.), which may be passed unchanged to POST. The display name is in network_name, such as TRON (TRC20). This was a breaking change: previously network returned a display name while POST required a machine-readable code, so sending it back caused asset_not_allowed. Both now use the same convention. The complete code list is in networks[] from GET /v1/assets.
asset is one asset found by reverse lookup from the chain, which may support multiple tokens. The deposit address itself is chain-level; other tokens on the same chain can also be credited. Do not interpret this field as restricting deposits to that asset.
On chains requiring memo, omitting it prevents credit. An empty string means the chain does not need one, not that a required memo may be omitted.

Parameters

This endpoint takes no parameters: no path parameters, query parameters or request body. For the authentication header (x-auth-token) and on-behalf-of header (x-on-behalf-of), see Authentication and Signing.

Response

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: missing merchant:read.

Request

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

const res = await fetch("https://api.zinfra.vip/v1/merchant/deposit-addresses", {
  method: "GET",
  headers: {
    "x-auth-token": "Bearer $TOKEN",
  },
});
// Keep monetary amounts as strings, never numbers.
const data = await res.json();

import requests

res = requests.get(
    "https://api.zinfra.vip/v1/merchant/deposit-addresses",
    headers={
        "x-auth-token": "Bearer $TOKEN",
    },
)
# Use Decimal(str(...)) for amounts, not float.
data = res.json()

req, _ := http.NewRequest("GET", "https://api.zinfra.vip/v1/merchant/deposit-addresses",
    nil)
req.Header.Set("x-auth-token", "Bearer $TOKEN")
res, err := http.DefaultClient.Do(req)
// Decode amount fields as string, not float64.

HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://api.zinfra.vip/v1/merchant/deposit-addresses"))
    .header("x-auth-token", "Bearer $TOKEN")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();
// Use String / BigDecimal for amounts, not double.

$ch = curl_init('https://api.zinfra.vip/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);
// Use bcmath / strings for amounts, not 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
}