您想提取挖矿统计/数据自己分析?没问题,我们为您准备了API!
矿池API以JSON文件为格式,提供 统计, 配置和矿工 这三种数据。 您需要在每个API的URL链接中,包括所选币种的简写(例如,BTC)以及访问口令。
获取API验证所需的访问口令,请按照以下步骤:
- 前往矿池网页后台的 设置 > 访问配置
- 选择您访问配置中的一个,或创建一个新配置
- 在访问配置的详细信息中勾选 允许访问网页API
- 点击 生成新口令
- 然后 保存
每个访问配置都有各自独立的访问口令(如已开启API访问)。访问口令可以在任何时候重新生成,这样就可以取消某个旧访问配置的口令。
API验证
访问配置口令必须包括在名为 SlushPool-Auth-Token 或 X-SlushPool-Auth-Token 的HTTP头选项中,以用于验证。
使用 cURL 的请求示例:
curl https://pool.braiins.com/stats/json/btc/ -H "SlushPool-Auth-Token: <您的访问口令>"
API 请求限制
API允许大约每5秒一次请求。 如您短时间超过这一限制,您的部分请求会被忽略。如您长时间或大量超过这一限制,您的IP地址将被封禁。这种情况下,请您联系客服解决。
矿池统计API
提供关于矿池性能和近期出块的信息。
URL地址:
https://pool.braiins.com/stats/json/[币种]/
输出示例:
{
btc: {
luck_b10: "0.77",
luck_b50: "0.85",
luck_b250: "0.93",
hash_rate_unit: "Gh/s",
pool_scoring_hash_rate: 5820970883.3011,
pool_active_workers: 219210,
round_probability: "0.67",
round_started: 1542096907,
round_duration: 5913,
blocks: {
549753: {
date_found: 1542002919,
mining_duration: 3423,
total_shares: 4640771710739,
state: "confirmed",
confirmations_left: 0,
value: "12.92594863",
user_reward: "0.00006194",
pool_scoring_hash_rate: 5878745444.967269,
},
}
}
}
通用矿池统计
项 | 类型 | 描述 |
luck_b10 | 字符串(String) | 近10个区块矿池幸运值 |
luck_b50 | 字符串 | 近50个区块矿池幸运值 |
luck_b250 | 字符串 | 近250个区块矿池幸运值 |
hash_rate_unit | 字符串 | 算力单位 |
pool_scoring_hash_rate | 数字(Number) | 矿池计分算力(Pool scoring hash rate) |
pool_active_workers | 数字 | 矿池活跃矿工数 |
round_probability | 字符串 | 当前轮的CDF(累积分布函数,相对时长预计) |
round_started | 数字 | 当前轮开始时的UNIX时间 |
round_duration | 数字 | 当前轮长度(秒) |
blocks | 对象(Object) | 最近15个区块的信息 (详解见下) |
最新区块
项 | 类型 | 描述 |
date_found | 数字 | 某个区块被开出时的UNIX时间 |
mining_duration | 数字 | 某个区块的轮长度 |
total_shares | 数字 | 某轮中的份额(Share)数量 |
state | 字符串 | 某个区块的状态 |
confirmations_left | 数字 | 剩余确认数 |
value | 字符串 | 区块价值 |
user_reward | 字符串 | 某个区块的用户收益 |
pool_scoring_hash_rate | 数字 | 您出块时的矿池计分算力 |
用户配置API
提供关于用户性能和收益的信息。
URL地址:
https://pool.braiins.com/accounts/profile/json/[币种]/
输出示例:
{
username: "username",
btc: {
confirmed_reward: "0.00765122",
unconfirmed_reward: "0.00062272",
estimated_reward: "0.00006014",
send_threshold: "0.01000000",
hash_rate_unit: "Gh/s",
hash_rate_5m: 27978,
hash_rate_60m: 28191,
hash_rate_24h: 28357,
hash_rate_scoring: 28294,
hash_rate_yesterday: 28197,
low_workers: 0,
off_workers: 0,
ok_workers: 2,
dis_workers: 2,
}
}
项 | 类型 | 描述 |
username | 字符串 | 用户名 |
confirmed_reward | 字符串 | 已确认收益 |
unconfirmed_reward | 字符串 | 未确认收益 |
estimated_reward | 字符串 | 当前区块预计收益 |
hash_rate_unit | 字符串 | 算力单位 |
hash_rate_5m | 字符串 | 近5分钟平均算力 |
hash_rate_60m | 数字 | 近60分钟平均算力 |
hash_rate_24h | 数字 | 近24小平均算力 |
hash_rate_scoring | 数字 | 用户当前计分算力 |
hash_rate_yesterday | 数字 | 最近一天(UTC,协调世界时)的平均算力 |
low_workers | 数字 | “低”状态矿工数 |
off_workers | 数字 | “离线”状态矿工数 |
ok_workers | 数字 | “正常”状态矿工数 |
dis_workers | 数字 | 停用监控矿工数 |
每日收益API
提供关于近90天收益的信息。
URL地址:
输出示例:
项 | 类型 | 描述 |
date | 数字 | Unix时间(日期的第一秒钟) |
total_reward | 数字 | 当天所有收益类型的总和 |
mining_reward | 数字 | 标准挖矿收益 |
bos_plus_reward | 数字 | 使用Braiins OS+固件挖矿,我们返还给您的金额(矿池抽水返水) |
referral_bonus | 数字 | 被其他使用Braiins OS+矿工邀请所获得的奖励 |
referral_reward | 数字 | 由推荐Braiins OS+得到算力而获得的收益 |
区块收益API
提供关于区块收益的信息。
URL地址:
https://pool.braiins.com/accounts/block_rewards/json/[coin]?from=[from date]&to=[to date]
其中COIN就是BTC或者ZEC, FROM date是以ISO格式(年年年年-月月-日日) 表示的日期字符串表示,并TO date是以ISO格式(年年年年-月月-日日) 表示的日期字符串表示。
https://pool.braiins.com/accounts/block_rewards/json/btc?from=2022-05-01&to=2022-05-07
输出示例:
{ "btc": { "block_rewards": [ { "block_found_at": 1651804117, "pool_scoring_hash_rate": 4441768989.204721, "user_scoring_hash_rate": 12981.581642348925, "block_value": "12.59169582", "user_reward": "0.06366676", "block_height": 567815, "mining_reward": "0.06366676", "braiinsos_plus_mining_bonus": "0.00000000", "referral_reward": "0.00000000", "referral_bonus": "0.00000000", "confirmations_left": 0 }, { "block_found_at": 1651811734, "pool_scoring_hash_rate": 4441768989.387698, "user_scoring_hash_rate": 13041.508413918604, "block_value": "12.66780812", "user_reward": "0.07129083", "block_height": 567816, "mining_reward": "0.07129083", "braiinsos_plus_mining_bonus": "0.00000000", "referral_reward": "0.00000000", "referral_bonus": "0.00000000", "confirmations_left": 0 } ], "hash_rate_unit": "Gh/s" } }
Field | Type | Description |
block_found_at | 数字 | 区块被发现的UNIX(UTC)时间戳 |
pool_scoring_hash_rate | 数字 | 在区块被发现时矿池的总计分算力 |
user_scoring_hash_rate | 数字 | 在区块被发现时用户的总计分算力 |
block_value | 字符串 | 区块的总值 |
user_reward | 字符串 | 用户的总收益 |
block_heigh | 数字 | 该币区块链中的区块编号 |
mining_reward | 字符串 | 在区块提交份额的总挖矿收益 |
braiinsos_plus_mining_bonus | 字符串 | 使用Braiins OS+的矿池费用优惠 |
referral_reward | 字符串 | 由推荐Braiins OS+得到算力而获得的收益 |
referral_bonus | 字符串 | 被其他使用Braiins OS+矿工邀请所获得的奖励 |
confirmations_left | 数字 | 在该区块被认为是有效的之前所剩的确认数 |
矿工API
提供账户下每个矿工的性能数据。
URL地址链接:
https://pool.braiins.com/accounts/workers/json/[币种]/
输出示例:
{
btc: {
workers: {
username.worker1: {
state: "ok",
last_share: 1542103204,
hash_rate_unit: "Gh/s",
hash_rate_scoring: 15342,
hash_rate_5m: 14977,
hash_rate_60m: 15302,
hash_rate_24h: 15351,
},
username.worker2: {
state: "ok",
last_share: 1542103200,
hash_rate_unit: "Gh/s",
hash_rate_scoring: 12952,
hash_rate_5m: 13001,
hash_rate_60m: 12889,
hash_rate_24h: 13006,
},
}
}
}
项 | 类型 | 描述 |
last_share | 数字 | 最近一次分额(Share)被接受的UNIX时间 |
state | 字符串 | 矿工状态 (正常/低/离线/已禁用) |
hash_rate_unit | 字符串 | 算力的单位 |
hash_rate_scoring | 数字 | 当前计分算力 |
hash_rate_5m | 数字 | 近5分钟平均算力 |
hash_rate_60m | 数字 | 近60分钟平均算力 |
hash_rate_24h | 数字 | 近24小时平均算力 |