---
title: "未来收益"
method: GET
path: "/v1/stake/public/future"
tags: ["PUBLIC SERVICE"]
---

# 未来收益

`GET /v1/stake/public/future`

## Query parameters

- `address` string, required

## Response `200`

OK

- XListFutureDailyBillPayload
  - `code` integer — 成功返回0，其他均为错误
  - `msg` string — 发生错误时候返回的消息
  - `sub_code` string
  - `sub_msg` string
  - `data` FutureDailyBillPayload[]
    - `billing_timestamp` integer — 下一次计费时间
    - `project_id` integer — 关联的项目ID
    - `project_name_en` string — 项目英文名称
    - `project_name_zh` string — 项目中文名称
    - `resource_type` 'ENERGY' | 'BANDWIDTH' — 资源类型
    - `staked_address` string — 质押地址
    - `receiver` string — 接收资源地址
    - `staked_amount_sun` integer — 质押给该项目的金额
    - `valid_staked_amount_sun` integer — 质押给该项目的有效金额
    - `power_amount_sun` integer — 用于计费的依据，单位是 能量x时
    - `apy` integer — 年化*100 存整数
    - `earning_amount_sun` integer — 预计下一次收益金额
    - `daily_earning_amount_sun` integer — 预计日收益
    - `transaction_bill_list` TransactionBillPayload[] — 结算周期内代理信息变化
      - `hash` string — 交易hash
      - `last_billing_timestamp` integer — 结算开始时间，上次结算时间
      - `last_staked_amount_sun` integer — 上次质押金额
      - `last_valid_staked_amount_sun` integer — 上次质押有效金额
      - `billing_timestamp` integer — 结算时间,代理时间
      - `transaction_type` 'PERMISSION' | 'STAKE' | 'UNSTAKE' | 'DELEGATE' | 'RECLAIM' — 交易类型，12：代理，13：回收
      - `staked_amount_sun` integer — 质押给该项目的金额
      - `valid_staked_amount_sun` integer — 质押给该项目的有效金额
      - `power_amount_sun` integer — 用于计费的依据，单位是 能量x时
      - `earning_amount_sun` integer — 收益金额

---

[API](https://skmtc.net/catfee/apis/stake-vault-api.md) · [All operations](https://skmtc.net/catfee/apis/stake-vault-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/catfee/stake-vault-api/revisions/6978b1e208fa/schema)