BTC:  917 PH/s LTC:  16.2 TH/s ETH:  45.6 TH/s ETC:  824 GH/s ZEC:  40.8 Msol/s SC:  73.6 TH/s DASH:  165 TH/s XMR:  1798 KH/s


概述

F2poolAPI是官方提供的向矿池请求用户具体信息数据的访问接口。



词汇

提交请求信息后,F2poolAPI服务器将通过JSON格式的响应返回,返回数据中携带的字段如下:

字段 描述
balance 工资余额
value 总收益
value_last_day 过去24小时收益
hashes_last_day 过去24小时算力
stale_hashes_rejected_last_hour 过去1小时拒绝率
stale_hashes_rejected_last_day 过去24小时拒绝率
hashrate_history 历史算力(过去24小时)
paid 已支付工资
hashes_last_hour 过去1小时算力
workers 矿机数据
worker_length 矿机总数
worker_length_online 在线矿机数
worker_name 矿机名称
payout_history 支付记录
hashrate 算力



请求示例

所有的API访问都是通过HTTP访问的http://api.f2pool.com,所有返回正确数据都以JSON的形式接收,如下:

curl http://api.f2pool.com/bitcoin/user


{
    "balance": 0.000045036645168645,
    "hashes_last_day": 0,
    "value": 0.000045036645168645,
    "stale_hashes_rejected_last_day": 0,
    "workers": [],
    "value_last_day": 0,
    "hashrate_history": {
        "2017-12-21T11:40:00Z": 0
    },
    "stale_hashes_rejected_last_hour": 0,
    "paid": 0,
    "hashes_last_hour": 0,
    "worker_length_online": 0,
    "payout_history": [["2017-11-01T00:00:00Z", "8f8fba3134ce15e9b0001e67cba93c4a2250445310b5cdada1ac676b5a19b8b9", 1.010047060000000000000000]],
    "worker_length": 0,
    "hashrate": 0
}

请求不同的币种的用户数据需要通过不同的URL访问服务器,目前可以获取以下币种的数据:

  1. Bitcoin-比特币

    http://api.f2pool.com/bitcoin/user
  2. Litecoin-莱特币

    http://api.f2pool.com/litecoin/user
  3. Ethereum-Classic 以太坊经典

    http://api.f2pool.com/etc/address
  4. Ethereum-以太坊

    http://api.f2pool.com/eth/address
  5. ZEC-零币

    http://api.f2pool.com/zec/address
  6. SiaCoin

    http://api.f2pool.com/sc/address
  7. XMR-门罗币

    http://api.f2pool.com/monero/address
  8. Dash-达世币

    http://api.f2pool.com/dash/address

如果向F2poolAPI服务器请求了除以上币种外的其他币种,或者参数user/address不合法,则会收到错误的响应消息:404: Not Found。注意: 如果向F2poolAPI服务器频繁的恶意重复请求将会被列入黑名单,或者会收到错误的响应消息:503: GateWay Timeout



请求单个用户数据

单个用户 请求URL:

http://api.f2pool.com/{currency}/{user}

响应:


{
    "balance": 0.000045036645168645,
    "hashes_last_day": 0,
    ...
}
            



请求多个用户数据

F2poolAPI允许一次请求单个用户的详细数据,也允许一次请求多个用户的详细数据,请求多用户数据URL如下:

多个用户 请求URL:

http://api.f2pool.com/{currency}/{user1}?multi_account={user1}&multi_account={user2}

响应:


{
   user1:{
       "balance": 0.000045036645168645,
       "hashes_last_day": 0,
       ...
   },
   user2:{
       "balance": 0.000045036645168645,
       "hashes_last_day": 0,
       ...
   }
}
            

注意:在使用一次查询多用户数据时,url中参数:{currency}位置的后面需要填充一个合法的currency账户(若是匿名币种,需要是合法的币种地址), 否则系统将返回:404: Not Found



请求矿机过去24小时算力数据

矿机历史算力数据 请求URL

http://api.f2pool.com/{currency}/{user}/{worker_name}

响应:


{
    "hashrate_history": {
        "2017-12-21T18:50:00Z": 22906492245,
        "2017-12-21T19:00:00Z": 16950804262,
        "2017-12-21T19:10:00Z": 20157713176,
        ...
    }
}