统计图表数据API

统计图表数据API提供blockchain.info上各种图表与统计信息的访问接口。

日期参数表示为YYYY-MM-DDThh:mm:ss或者YYYY-MM-DD，时区为UTC， 时间跨度由数值和单位拼接组成，例如1year、3months等，有效的时间 单位包括：minute、 hour、day、 week和year。

API清单

• charts - 获取图表数据
• stats - 获取统计数据
• pools - 获取交易池信息

charts - 获取图表数据

使用charts调用获取图表数据。

API调用

GET charts/$chartName

URI参数：

• $chartName：图表名称，所支持的图表可以到这里查看：https://www.blockchain.com/charts 查询参数：

• timespan：时间范围，可选。对大多数图表其默认值为1年，对内存池图表则默认值为1周

• rollingAverage：滑动平均窗口，可选
• start：图表数据起始时间
• format：数据格式，json - JSON，csv - CSV，默认为JSON格式
• sampled：是否采样，可选，默认值：true。当设置为true时，将通过采样以保证返回的数据大小大约为1.5k，避免性能恶化

API返回值

返回数据根据format参数可能为JSON或CSV格式，当返回JSON数据时，主要字段如下：

• status：调用执行状态
• name：图表名称
• unit：图表单位
• period：数据周期
• description：图表描述
• values：图表数据数组，每个成员的x和y分别表示图表的x轴和y轴数据值

示例代码

使用curl调用charts的示例代码如下：

curl  https://api.blockchain.info/charts/transactions-per-second?timespan=5weeks&rollingAverage=8hours&format=json

返回值：

{
  "status": "ok",
  "name": "Transaction Rate",
  "unit": "Transactions Per Second",
  "period": "minute",
  "description": "The number of Bitcoin transactions added to the mempool per second.",
  "values": [
    {
      "x": 1554621960,
      "y": 3.9451041666666677
    },
    {
      "x": 1554624000,
      "y": 3.91482638888889
    },
    ...
  ]
}

stats - 获取统计数据

使用stats调用获取统计数据。

API调用

GET stats

API返回值

返回数据为统计信息对象，主要字段如下：

• timestamp：时间戳
• market_price_usd：以美元结算的比特币市场价格
• hash_rate：哈希速率
• total_fees_btc：比特币手续费总额
• n_btc_mniced：挖出比特币总额
• n_tx：比特币交易总数
• n_blocks_mined：挖出区块总数
• estimated_transaction_volume_usd：以美元为单位的交易量估算值
• blocks_size：区块大小
• miners_revenue_usd：美元为单位的矿工收益总额
• nextretarget：下次调整难度目标的区块高度
• difficulty：当前难度目标
• estimated_btc_sent：发送比特币估算量
• miners_revenue_btc：矿工收益比特币总量
• total_btc_sent：发送比特币总量
• trade_volume_btc：比特币交易量
• trade_volume_usd：以美元为单位的比特币交易量

示例代码

使用curl调用stats的示例代码如下：

curl  https://api.blockchain.info/stats

返回值：

{
  "timestamp": 1557646525000,
  "market_price_usd": 7292.97,
  "hash_rate": 44977500727.36728,
  "total_fees_btc": 11648437530,
  "n_btc_mined": 168750000000,
  "n_tx": 335667,
  "n_blocks_mined": 135,
  "minutes_between_blocks": 9.8507,
  "totalbc": 1769555000000000,
  "n_blocks_total": 575644,
  "estimated_transaction_volume_usd": 985067994.1395454,
  "blocks_size": 164076254,
  "miners_revenue_usd": 13156403.929531645,
  "nextretarget": 576575,
  "difficulty": 6702169884349,
  "estimated_btc_sent": 13507089623837,
  "miners_revenue_btc": 1803,
  "total_btc_sent": 112633530925902,
  "trade_volume_btc": 52607.99,
  "trade_volume_usd": 383668492.8303
}

pools - 获取矿池信息

使用pools调用获取矿池信息。

API调用

GET pools

查询参数：

• timespan：统计时间跨度，默认值：4天，最大值：10天，可选

API返回值

返回矿池相关数据。

示例代码

使用curl调用pools的示例代码如下：

curl https://api.blockchain.info/pools?timespan=5days

返回值：

{
  "SlushPool": 75,
  "BitClub Network": 16,
  "Poolin": 75,
  "BTC.com": 117,
  "Unknown": 99,
  "BitFury": 22,
  "AntPool": 88,
  "BTC.TOP": 46,
  "DPOOL": 7,
  "ViaBTC": 37,
  "F2Pool": 85,
  "Bitcoin.com": 11,
  "Bixin": 8,
  "KanoPool": 1
}