Bitcoin time series extends the TimeSeriesAsset object to include custom time aggregated fields related to the Bitcoin peer-to-peer network and blockchain.
You can access these fields by using the ... on TimeSeriesBtc inline fragment when using TimeSerisAsset property in a time series query. Inline fragments are a way to specify additional properties on an object that can take on many forms, such as the TimeSeriesAsset type.
You can read more information about inline fragments in the the GraphQL documentation.
This example shows onchain data statistics over aggregated by day over a 3 day period.
query bitcoinTimeSeries {
timeseries(resolution: _1d, limit: 3, startDate: "2019-02-01", sort: OLD_FIRST) {
startDate
assets(filter: { assetSymbol: { _eq: "BTC" } }) {
assetSymbol
... on TimeSeriesBtc {
onchain {
totalBlocks
startHeight
endHeight
avgDifficulty
targetHashRate
avgBlockTime
avgBlockSize
totalSize
startSize
endSize
totalTxs
avgTxsPerBlock
totalFees
avgFeesPerBlock
totalSubsidy
avgSubsidyPerBlock
totalReward
avgRewardPerBlock
startSupply
endSupply
totalExpectedSubsidy
startExpectedSupply
endExpectedSupply
totalValueOut
avgValueOutPerBlock
totalInputs
avgInputsPerBlock
totalOutputs
avgOutputsPerBlock
totalCoinbaseOutputs
avgCoinbaseOutputsPerBlock
}
}
}
}
}{
"data": {
"timeseries": [
{
"startDate": "2019-02-01T00:00:00.000Z",
"assets": [
{
"assetSymbol": "BTC",
"onchain": {
"totalBlocks": "158",
"startHeight": "560983",
"endHeight": "561141",
"avgDifficulty": "5814661935891.805",
"targetHashRate": "41623.60654575",
"avgBlockTime": "555.816",
"avgBlockSize": "1024592.437",
"totalSize": "161885605",
"startSize": "407767294122",
"endSize": "407929179727",
"totalTxs": "339183",
"avgTxsPerBlock": "2146.728",
"totalFees": "33.11076701",
"avgFeesPerBlock": "0.20956182",
"totalSubsidy": "1975.00000000",
"avgSubsidyPerBlock": "12.500",
"totalReward": "2008.11076701",
"avgRewardPerBlock": "12.70956182",
"startSupply": "17512271.04497312",
"endSupply": "17514246.04497312",
"totalExpectedSubsidy": "1975.00000000",
"startExpectedSupply": "17512300.00000000",
"endExpectedSupply": "17514275.00000000",
"totalValueOut": "2803583.71450016",
"avgValueOutPerBlock": "17744.20072468",
"totalInputs": "715300",
"avgInputsPerBlock": "4527.215",
"totalOutputs": "822971",
"avgOutputsPerBlock": "5208.677",
"totalCoinbaseOutputs": "396",
"avgCoinbaseOutputsPerBlock": "2.506"
}
}
]
},
{
"startDate": "2019-02-02T00:00:00.000Z",
"assets": [
{
"assetSymbol": "BTC",
"onchain": {
"totalBlocks": "144",
"startHeight": "561141",
"endHeight": "561285",
"avgDifficulty": "5814661935891.805",
"targetHashRate": "41623.60654575",
"avgBlockTime": "598.167",
"avgBlockSize": "981337.799",
"totalSize": "141312643",
"startSize": "407929179727",
"endSize": "408070492370",
"totalTxs": "321888",
"avgTxsPerBlock": "2235.333",
"totalFees": "18.92618462",
"avgFeesPerBlock": "0.13143184",
"totalSubsidy": "1800.00000000",
"avgSubsidyPerBlock": "12.500",
"totalReward": "1818.92618462",
"avgRewardPerBlock": "12.63143184",
"startSupply": "17514246.04497312",
"endSupply": "17516046.04497312",
"totalExpectedSubsidy": "1800.00000000",
"startExpectedSupply": "17514275.00000000",
"endExpectedSupply": "17516075.00000000",
"totalValueOut": "1527138.57361821",
"avgValueOutPerBlock": "10605.12898346",
"totalInputs": "604181",
"avgInputsPerBlock": "4195.701",
"totalOutputs": "761788",
"avgOutputsPerBlock": "5290.194",
"totalCoinbaseOutputs": "413",
"avgCoinbaseOutputsPerBlock": "2.868"
}
}
]
},
{
"startDate": "2019-02-03T00:00:00.000Z",
"assets": [
{
"assetSymbol": "BTC",
"onchain": {
"totalBlocks": "138",
"startHeight": "561285",
"endHeight": "561423",
"avgDifficulty": "5814661935891.805",
"targetHashRate": "41623.60654575",
"avgBlockTime": "622.703",
"avgBlockSize": "935500.210",
"totalSize": "129099029",
"startSize": "408070492370",
"endSize": "408199591399",
"totalTxs": "300033",
"avgTxsPerBlock": "2174.152",
"totalFees": "14.74322284",
"avgFeesPerBlock": "0.10683495",
"totalSubsidy": "1725.00000000",
"avgSubsidyPerBlock": "12.500",
"totalReward": "1739.74322284",
"avgRewardPerBlock": "12.60683495",
"startSupply": "17516046.04497312",
"endSupply": "17517771.04497312",
"totalExpectedSubsidy": "1725.00000000",
"startExpectedSupply": "17516075.00000000",
"endExpectedSupply": "17517800.00000000",
"totalValueOut": "690916.78426866",
"avgValueOutPerBlock": "5006.64336427",
"totalInputs": "556906",
"avgInputsPerBlock": "4035.551",
"totalOutputs": "700986",
"avgOutputsPerBlock": "5079.609",
"totalCoinbaseOutputs": "340",
"avgCoinbaseOutputsPerBlock": "2.464"
}
}
]
}
]
}
}| Field | Type | Description |
|---|---|---|
| assetSymbol | String | The asset symbol |
| onchain | TimeSeriesBtcOnchain | Time series on-chain data |
| Field | Type | Description |
|---|---|---|
| totalBlocks | String | Number of blocks solved in period |
| startHeight | String | Block height at start of period |
| endHeight | String | Block height at end of period |
| avgDifficulty | String | Average difficulty per block |
| targetHashRate | String | Hash rate in petahash based on the difficulty and target block time of 10 minutes |
| avgBlockTime | String | Average time to solve a block in seconds |
| avgBlockSize | String | Average size of blocks in bytes |
| totalSize | String | Total size of all blocks solved in this period |
| startSize | String | Starting cumulative size of all blocks solved at the start of the period |
| endSize | String | ending cumulative size of all blocks solved at the end of the period |
| totalTxs | String | Number of user transactions (excludes coinbase) |
| avgTxsPerBlock | String | Average number of user transactions (excludes coinbase) per block |
| totalFees | String | Total fees collected in all blocks |
| avgFeesPerBlock | String | Average fees per block |
| meanFeesPerTx | String | Mean fees per transaction |
| medianFeesPerTx | String | Median fees per transaction |
| totalSubsidy | String | Total number of bitcoin created |
| avgSubsidyPerBlock | String | Average number of bitcoin created per block |
| totalReward | String | Total bitcoin rewarded (subsidy + fees) to miners for all blocks |
| avgRewardPerBlock | String | Average bitcoin rewarded (subsidy + fees) to miners per block |
| startSupply | String | Supply at start of period |
| endSupply | String | Supply at end of period |
| totalExpectedSubsidy | String | Expected ubsidy created based on number of blocks solved |
| startExpectedSupply | String | Expected supply based on starting block height |
| endExpectedSupply | String | Expected supply based on ending block height |
| totalValueOut | String | Total value in bitcoin of all outputs |
| avgValueOutPerBlock | String | Average value in bitcoin of all outputs per block |
| meanValueOutPerTx | String | Mean transaction value in bitcoin |
| medianValueOutPerTx | String | Median transaction value in bitcoin |
| totalInputs | String | Total number of inputs used (excludes coinbase) |
| avgInputsPerBlock | String | Average number of inputs used per block |
| totalOutputs | String | Total number of outputs generated (excludes coinbase) |
| avgOutputsPerBlock | String | Average number of outputs generateed per block |
| totalCoinbaseOutputs | String | Total number of outputs created in coinbase transactions |
| avgCoinbaseOutputsPerBlock | String | Average number of outputs created in coinbase transactions per block |
| activeAddressCount | String | Count of unique addresses used. Represents the upper bound of people sending or receiving. |
| activeSendAddressCount | String | Count of unique sending addresses. Represents the upper bound of people sending. |
| activeReceiveAddressCount | String | Count of unique receiving addresses. Represents the upper bound of people receiving. |