您
软件与故障排查

矿池 API 入门

最后更新:2026年11月5日

从公开的 JSON API 读取实时的矿池和单个矿工统计:两个接口、如何查询您自己的地址,以及多久查询一次。

矿池 API 能用来做什么?

矿池有一个公开的只读 JSON API,提供仪表盘上显示的所有内容。它不需要密钥,也不需要账户。

您可以用它搭建自己的监控、家用仪表盘、机器人,或记录挖矿情况的电子表格。它提供两类数据:

  • 矿池整体统计:算力、全网难度、区块和支付。
  • 任意地址的单个矿工统计。
向矿池统计地址发出的 curl 请求,矿池主机和接口以颜色标出。下方是 JSON 应答。其中矿池部分包含算力、矿工数和矿机数,网络部分包含难度和区块高度。
地址指定矿池和您想要的数据。应答是分为矿池和网络两部分的简单 JSON。

怎样获取矿池整体统计?

矿池统计接口返回的数据与您在页头和仪表盘上看到的相同:

  • 矿池和全网算力。
  • 已连接的矿工。
  • 难度。
  • 最近的区块。
  • 最近的支付。

像获取任何 JSON 网址一样获取它:

矿池统计
curl https://qubitcoin.herominers.com/api/stats

怎样获取我自己地址的统计?

要读取一个地址,把它传给矿工统计接口。把 YOUR_QTC_ADDRESS 换成您的钱包地址。

应答包含该地址的算力、矿机、余额和最近的支付。这就是您仪表盘页面背后的原始数据:

矿工统计
curl https://qubitcoin.herominers.com/api/stats_address?address=YOUR_QTC_ADDRESS

应该多久查询一次 API?

每一两分钟一次就足够了。API 就是给人用的,但请礼貌地查询。

一张按时钟刷新的 API 应答卡片。上方,一串密集的请求被红色划掉,因为每次得到的应答都一样。下方,每个时钟刻度只发一个请求,间隔均匀,得到绿色对勾。
数据每隔一段时间才刷新,所以每一两分钟请求一次就足够了。

它背后的数字只是每隔一段时间更新一次。查询频繁得多只会浪费双方的带宽,并不会给您更新的数据。

把获取到的数据缓存起来。按照仪表盘使用的同样更新节奏来设计。

准备好付诸实践了吗?
挖矿指南会为您选择最近的服务器,并生成您专属的挖矿软件命令。
开始挖 Qubitcoin