理财 › API 参考 › 产品

理财产品详情

GET /v1/earn/products/{id} scope: earn:read

商户自身

min_amount / max_amount 是最小单位整数串（位数 = 该资产

ledger_scale），不是十进制。

它返回的字段如下（kind = flexible 的产品 term_days 为

0；rollover_mode 的枚举是 none / principal /

principal_interest，不是 both）。

⚠ 定期的 apr_bps 是「现在下单会拿到的那个」，不是任何一张已有

订单的利率 —— 定期利率在下单那一刻快照进订单行，改挂牌价不影响存量。

活期相反：改利率是往历史表插一行，昨天的利息按昨天那一段算。

路径参数

字段	类型	必填	说明
`id`	string	必填	产品 id。带不带 `ern_` 前缀都认。

响应

200修好之后的形状。min_amount / max_amount 为 0 表示不限。

{
  "id": "ern_7d2b48ae-19c3-4f60-8c55-0ab3e9f21744",
  "asset": "USDT",
  "kind": "fixed",
  "term_days": 90,
  "apr_bps": 620,
  "min_amount": "100000000",
  "max_amount": "0",
  "ledger_scale": 6,
  "renewable": true,
  "rollover_mode": "principal",
  "status": "active"
}

403insufficient_scope

404not_found —— 产品不存在，或没有对你开放。两种同一响应。

500api_error —— 本期恒定如此（见上方说明），不是你的请求有问题。

请求

curl -X GET 'https://api.zise.com/v1/earn/products/{id}' \
  -H 'x-auth-token: Bearer $TOKEN'

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

import requests

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

req, _ := http.NewRequest("GET", "https://api.zise.com/v1/earn/products/{id}",
    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/earn/products/{id}"))
    .header("x-auth-token", "Bearer $TOKEN")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();
// 金额字段用 String / BigDecimal，不要 double

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

200

{
  "id": "ern_7d2b48ae-19c3-4f60-8c55-0ab3e9f21744",
  "asset": "USDT",
  "kind": "fixed",
  "term_days": 90,
  "apr_bps": 620,
  "min_amount": "100000000",
  "max_amount": "0",
  "ledger_scale": 6,
  "renewable": true,
  "rollover_mode": "principal",
  "status": "active"
}