获取代币总量
更新时间:2020-04-09
获取代币总量
接口描述 根据给定配置计算超级链网络能生成的超级币总量。
权限说明 请求发起人需要具有合法的AccessKeyID和SecretAccessKey才能发起请求。
注意事项
如果请求中没有用户验证信息(即匿名访问),返回403 Forbidden
,错误信息:AccessDenied
。
请求(Request)
- 请求语法
GET /v1/xchain/token/totalQuota
Host: bbe.bj.baidubce.com
Date: <Date>
x-bce-date: 2019-01-06T06:55:42Z
x-bce-request-id: b9485394-c7dc-3cfa-d454-57c34773d08c
Authorization: <Authorization_String>
- 请求头域
除公共头域外,无其它特殊头域。
- 请求参数
名称 | 类型 | 说明 | 是否必须 |
---|---|---|---|
initialQuota | int | 管理账户初始分配代币数,范围 [100000, 1000000000],缺省100000,至少为award的100倍 | 必须 |
award | int | 出块奖励,范围 [1000, 10000000],缺省1000 | 必须 |
awardHeightGap | int | 奖励衰减高度,范围 [1000, 10000000],缺省1000 | 必须 |
awardRatio | float | 奖励衰减系数,范围[0.5, 0.999],缺省 0.5 | 必须 |
响应(Response)
- 响应头域
除公共头域外,无其它特殊头域。
- 响应参数
名称 | 类型 | 描述 |
---|---|---|
totalQuota | int64 | 生成的超级币总量 |
失败响应参考错误码部分。
示例
- 请求示例
GET /v1/xchain/token/totalQuota?awardRatio=0.9&awardHeightGap=1000&award=10000&initialQuota=1000000 HTTP/1.1
content-type: application/json
host: bbe.bj.baidubce.com
x-bce-date: 2019-01-06T06:55:42Z
x-bce-request-id: b9485394-c7dc-3cfa-d454-57c34773d08c
authorization: bce-auth-v1/5fded23b03594981872fbfadaad70ef6/2018-12-06T06:55:42Z/3600/host;x-bce-client-ip;x-bce-date;x-bce-request-id;x-bce-security-token/f86ff010bf7e8b45112357332630de7d48b6fed64f74d6b589c2fcd2e9be3c86
- 响应示例
200
Content-Length: 102
Content-Type: application/json; charset=utf-8
Date: Fri, 04 Jan 2019 10:24:02 GMT
{
"data":{
"totalQuota":101000000
}
}