Z Zise Developers
/
理财 › API 参考 › 持仓

活期持仓详情（含其中未起息）

GET /v1/earn/positions/{id} scope: earn:read
代会员调用 · 必带 x-on-behalf-of

GET /v1/earn/positions 只给总本金。这一条多给一件事：pending_principal —— 其中还没起息的那部分。

它是客服工单量最大的那个问题唯一的答案：「我昨天存了钱，今天为什么没收益。」拿不到它，你只能回一句「系统正在计算」。

由步长表实时算（不是存储列）。pending_value_at 是最早那一笔的起息时刻，空串 = 全部已起息。

⚠ pending_principal 是其中的一部分，已经包含在 principal 里，不是另加。

⚠ 活期赎回是 LIFO（先扣没起息的那部分）—— 所以这个数同时也是「现在赎回不损失任何已计利息的额度」。

pending_interest 是已计未发；paid_interest 是已经发到可用余额的。

路径参数

字段类型必填说明
id string 必填 持仓 id。带不带 erp_ 前缀都收。
字段类型必填说明
x-on-behalf-of string 必填

响应

200OK
{
  "id": "erp_7c1e",
  "product_id": "ern_8c1d",
  "asset": "USDT",
  "ledger_scale": 6,
  "display_scale": 2,
  "apr": "3.50%",
  "settle_cycle": "daily",
  "principal": "1500.000000",
  "pending_principal": "500.000000",
  "pending_value_at": "2026-08-15T00:00:00.000Z",
  "pending_interest": "0.410958",
  "paid_interest": "12.300000",
  "status": "active",
  "opened_at": "2026-07-01T08:12:00.000Z"
}
404not_found 持仓不存在，或不在这个会员/这个商户名下
请求 
curl -X GET 'https://api.zise.com/v1/earn/positions/{id}' \
  -H 'x-auth-token: Bearer $TOKEN' \
  -H 'x-on-behalf-of: $MEMBER_ID'
const res = await fetch("https://api.zise.com/v1/earn/positions/{id}", {
  method: "GET",
  headers: {
    "x-auth-token": "Bearer $TOKEN",
    "x-on-behalf-of": "$MEMBER_ID",
  },
});
// 金额按字符串读，别让它变成 number
const data = await res.json();
import requests

res = requests.get(
    "https://api.zise.com/v1/earn/positions/{id}",
    headers={
        "x-auth-token": "Bearer $TOKEN",
        "x-on-behalf-of": "$MEMBER_ID",
    },
)
# 金额用 Decimal(str(...))，不要 float
data = res.json()
req, _ := http.NewRequest("GET", "https://api.zise.com/v1/earn/positions/{id}",
    nil)
req.Header.Set("x-auth-token", "Bearer $TOKEN")
req.Header.Set("x-on-behalf-of", "$MEMBER_ID")
res, err := http.DefaultClient.Do(req)
// 金额字段用 string 接，不要 float64
HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://api.zise.com/v1/earn/positions/{id}"))
    .header("x-auth-token", "Bearer $TOKEN")
    .header("x-on-behalf-of", "$MEMBER_ID")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();
// 金额字段用 String / BigDecimal，不要 double
$ch = curl_init('https://api.zise.com/v1/earn/positions/{id}');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'x-auth-token: Bearer $TOKEN',
    'x-on-behalf-of: $MEMBER_ID',
  ],
]);
$res = curl_exec($ch);
// 金额用 bcmath / 字符串，不要 floatval
200 
{
  "id": "erp_7c1e",
  "product_id": "ern_8c1d",
  "asset": "USDT",
  "ledger_scale": 6,
  "display_scale": 2,
  "apr": "3.50%",
  "settle_cycle": "daily",
  "principal": "1500.000000",
  "pending_principal": "500.000000",
  "pending_value_at": "2026-08-15T00:00:00.000Z",
  "pending_interest": "0.410958",
  "paid_interest": "12.300000",
  "status": "active",
  "opened_at": "2026-07-01T08:12:00.000Z"
}