BTC Network Data

Bitcoin on-chain network data including but not limited to token movements, fees, supply, address movements, etc. All metrics have data entries starting from the genesis block (block height 0, datetime 2009-01-03 18:15:05).

Supply

get

This endpoint returns metrics related to bitcoin supply, i.e. the amount of bitcoin in existence. We currently provide two metrics, supply_total , the total amount of bitcoins in existence (sum of all bitcoins issued by the coinbase reward), and supply_new, the amount of newly issued tokens in a given window.

Authorizations

AuthorizationstringRequired

For each API request, include this HTTP header: Authorization with the Bearer {access_token}. Bearer access token is the type of HTTP Authorization. You have to include access token to the HTTP header and note that leading bearer is required. You must include your access token in HTTP header in every request you make. The token is unique, issued for each client, and regularly changed(once a year). To obtain an access token, please upgrade your plan to Professional or Premium plan. You'll be able to see your access token on the API tab of your profile page after the subscription.

Query parameters

windowstringOptional

Currently we support day, hour, and block.

Default: dayExample: day

fromanyOptional

This defines the starting time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the earliest time.

Example: 20191001T100000

toanyOptional

This defines the ending time for which data will be gathered, formatted as YYYYMMDDTHHMMSS (indicating YYYY-MM-DDTHH:MM:SS, UTC time). If window=day is used, it can also be formatted as YYYYMMDD (date). If window=block is used, you can also specify the exact block height (e.g. 510000). If this field is not specified, response will include data from the latest time.

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

supply_total, supply_new

application/json

get/btc/network-data/supply

curl "https://api.cryptoquant.com/v1/btc/network-data/supply?window=day&limit=2"

200

supply_total, supply_new

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "block",
    "data": [
      {
        "date": "2019-09-02",
        "supply_total": 15924414.7953033,
        "supply_new": 12.5
      },
      {
        "date": "2019-09-01",
        "supply_total": 15924414.7953033,
        "supply_new": 12.5
      }
    ]
  }
}

Velocity

get

This endpoint returns metrics related to the velocity of bitcoin. Bitcoin's velocity is calculated by dividing the trailing 1 year estimated transaction volume(the cumulated sum of transferred tokens) by current supply. Velocity is a metric that explains how actively is money circulating in the market.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

Estimated transaction volume in the trailing 1 year divided by current total supply.

application/json

get/btc/network-data/velocity

curl "https://api.cryptoquant.com/v1/btc/network-data/velocity?window=day&limit=2"

200

Estimated transaction volume in the trailing 1 year divided by current total supply.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2019-09-02",
        "velocity_supply_total": 7.3124
      },
      {
        "date": "2019-09-01",
        "velocity_supply_total": 7.3124
      }
    ]
  }
}

Transactions Count

get

This endpoint returns metrics related to the number of transactions. We provide several metrics, transactions_count_total, the total number of transactions, and transactions_count_mean, the mean number of transactions.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

transactions_count_total, transactions_count_mean

application/json

get/btc/network-data/transactions-count

curl "https://api.cryptoquant.com/v1/btc/network-data/transactions-count?window=day&limit=2"

200

transactions_count_total, transactions_count_mean

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2019-09-02",
        "transactions_count_total": 78912,
        "transactions_count_mean": 1248
      },
      {
        "date": "2019-09-01",
        "transactions_count_total": 78912,
        "transactions_count_mean": 1248
      }
    ]
  }
}

Addresses Count

get

This endpoint returns metrics relating to the number of used bitcoin addresses. We provide several metrics, addresses_count_active, the total number of unique addresses that were active (either sender or receiver) on the blockchain, addresses_count_sender, the number of addresses that were active as a sender, and addresses_count_receiver, the number of addresses that were active as a receiver.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

addresses_count_active, addresses_count_sender, addresses_count_receiver,

application/json

get/btc/network-data/addresses-count

curl "https://api.cryptoquant.com/v1/btc/network-data/addresses-count?window=day&limit=2"

200

addresses_count_active, addresses_count_sender, addresses_count_receiver,

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2019-09-02",
        "addresses_count_active": 102832,
        "addresses_count_sender": 60123,
        "addresses_count_receiver": 51231
      },
      {
        "date": "2019-09-01",
        "addresses_count_active": 102832,
        "addresses_count_sender": 60123,
        "addresses_count_receiver": 51231
      }
    ]
  }
}

Tokens Transferred

get

This endpoint returns metrics related to the number of tokens transferred, i.e transaction volume. We provide several metrics, tokens_transferred_total, the total number of transferred tokens, tokens_transferred_mean, the mean of number of transferred tokens per transaction, and tokens_transferred_median, the median of tokens transferred per transaction.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

tokens_transferred_total, tokens_transferred_mean, tokens_transferred_median

application/json

get/btc/network-data/tokens-transferred

curl "https://api.cryptoquant.com/v1/btc/network-data/tokens-transferred?window=day&limit=2"

200

tokens_transferred_total, tokens_transferred_mean, tokens_transferred_median

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2019-09-02",
        "tokens_transferred_total": 78912.12373645,
        "tokens_transferred_mean": 1248.47276264,
        "tokens_transferred_median": 1321.53121331
      },
      {
        "date": "2019-09-01",
        "tokens_transferred_total": 78912.12373645,
        "tokens_transferred_mean": 1248.47276264,
        "tokens_transferred_median": 1321.53121331
      }
    ]
  }
}

Block Bytes

get

The mean size(in bytes) of all blocks generated.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

The mean size(in bytes) of all blocks generated.

application/json

get/btc/network-data/block-bytes

curl "https://api.cryptoquant.com/v1/btc/network-data/block-bytes?window=day&limit=2"

200

The mean size(in bytes) of all blocks generated.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2019-09-02",
        "block_bytes": 1003264
      },
      {
        "date": "2019-09-01",
        "block_bytes": 897233
      }
    ]
  }
}

Block Count

get

The number of blocks generated in a given window.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently, we support day and hour.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

The number of blocks generated in a given window.

application/json

get/btc/network-data/block-count

curl "https://api.cryptoquant.com/v1/btc/network-data/block-count?window=day&limit=2"

200

The number of blocks generated in a given window.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2019-09-02",
        "block_count": 152
      },
      {
        "date": "2019-09-01",
        "block_count": 134
      }
    ]
  }
}

Block Interval

get

The average time between blocks generated displayed in seconds.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

The average time between blocks generated in seconds.

application/json

get/btc/network-data/block-interval

curl "https://api.cryptoquant.com/v1/btc/network-data/block-interval?window=day&limit=2"

200

The average time between blocks generated in seconds.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2019-09-02",
        "block_interval": 712
      },
      {
        "date": "2019-09-01",
        "block_interval": 592
      }
    ]
  }
}

UTXO Count

get

The number of total number of unspent transaction outputs existing at the specified point.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

Number of total number of unspent transaction outputs at a given period.

application/json

get/btc/network-data/utxo-count

curl "https://api.cryptoquant.com/v1/btc/network-data/utxo-count?window=day&limit=2"

200

Number of total number of unspent transaction outputs at a given period.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "block",
    "data": [
      {
        "date": "2019-09-02",
        "utxo_count": 2931
      },
      {
        "date": "2019-09-01",
        "utxo_count": 3142
      }
    ]
  }
}

Fees

get

This endpoint returns the statistics related to fees that are paid to bitcoin miners. In general, fees are calculated by subtracting the newly issued bitcoin from the total block reward of each blocks. We provide three statistics, fees_total, the sum of all fees, fees_block_mean, the average fee per block, and fees_reward_percent, the percentage of fees relative to the total block reward. Additionally, these can be viewed in terms of USD.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

fees_total, fees_total_usd, fees_block_mean, fees_block_mean_usd, fees_reward_percent.

application/json

get/btc/network-data/fees

curl "https://api.cryptoquant.com/v1/btc/network-data/fees?window=day&limit=2"

200

fees_total, fees_total_usd, fees_block_mean, fees_block_mean_usd, fees_reward_percent.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2019-09-02",
        "fees_block_mean": 0.00013123,
        "fees_block_mean_usd": 0.11,
        "fees_total": 11.21331723,
        "fees_total_usd": 3010.23,
        "fees_reward_percent": 0.012
      },
      {
        "date": "2019-09-01",
        "fees_block_mean": 0.00013123,
        "fees_block_mean_usd": 0.11,
        "fees_total": 11.21331723,
        "fees_total_usd": 3010.23,
        "fees_reward_percent": 0.012
      }
    ]
  }
}

Fees Transaction

get

This endpoint returns the statistics related to fees per transaction that are paid to bitcoin miners. In general, fees are calculated by subtracting the newly issued bitcoin from the total block reward of each blocks, and this is divided by the number of transactions to calculate the average fee per transaction in each block. We provide two statistics, fees_transaction_mean, the average fee per transaction, fees_transaction_median, the median fee per transaction. Additionally, these values can be calculated in USD.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

fees_transaction_mean, fees_transaction_mean_usd, fees_transaction_median, fees_transaction_median_usd

application/json

get/btc/network-data/fees-transaction

curl "https://api.cryptoquant.com/v1/btc/network-data/fees-transaction?window=day&limit=2"

200

fees_transaction_mean, fees_transaction_mean_usd, fees_transaction_median, fees_transaction_median_usd

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2019-09-02",
        "fees_transaction_mean": 0.00001321,
        "fees_transaction_mean_usd": 0.000312,
        "fees_transaction_median": 0.00001221,
        "fees_transaction_median_usd": 0.000289
      },
      {
        "date": "2019-09-01",
        "fees_transaction_mean": 0.00001321,
        "fees_transaction_mean_usd": 0.000312,
        "fees_transaction_median": 0.00001221,
        "fees_transaction_median_usd": 0.000289
      }
    ]
  }
}

Blockreward

get

The sum of block rewards (including mining or staking rewards and transaction fees). We also provide this value in usd.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

The sum of block rewards (including mining or staking rewards and transaction fees). We also provide this value in usd.

application/json

get/btc/network-data/blockreward

curl "https://api.cryptoquant.com/v1/btc/network-data/blockreward?window=day&limit=2"

200

The sum of block rewards (including mining or staking rewards and transaction fees). We also provide this value in usd.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "block",
    "data": [
      {
        "date": "2019-09-02",
        "blockreward": 23.61,
        "blockreward_usd": 210351.12
      },
      {
        "date": "2019-09-01",
        "blockreward": 29.32,
        "blockreward_usd": 278263.04
      }
    ]
  }
}

Difficulty

get

The mean difficulty of mining a new block.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

The mean difficulty of mining a new block.

application/json

get/btc/network-data/difficulty

curl "https://api.cryptoquant.com/v1/btc/network-data/difficulty?window=day&limit=2"

200

The mean difficulty of mining a new block.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "day",
    "data": [
      {
        "date": "2019-09-02",
        "difficulty": 11425323412355.53
      },
      {
        "date": "2019-09-01",
        "difficulty": 17234123523452.25
      }
    ]
  }
}

Hashrate

get

The mean speed at which miners in the network are solving hash problems. It is displayed as hashes (Gigabytes) per second.

Authorizations

AuthorizationstringRequired

Query parameters

windowstringOptional

Currently we support day, hour, and block.

Default: dayExample: day

fromanyOptional

Example: 20191001T100000

toanyOptional

Example: 20191001T103025

limitinteger · min: 1 · max: 100000Optional

The maximum number of entries to return before the latest data point (or before to if specified). This field ranges from 1 to 100,000.

Default: 100Example: 100

formatstringOptional

A format type about return message type. Supported formats are json, csv.

Default: jsonExample: json

Responses

200

The mean speed at which hash problems are being solved across all miners in the network. It is displayed as hashes(Bytes) per second.

application/json

get/btc/network-data/hashrate

curl "https://api.cryptoquant.com/v1/btc/network-data/hashrate?window=day&limit=2"

200

The mean speed at which hash problems are being solved across all miners in the network. It is displayed as hashes(Bytes) per second.

{
  "status": {
    "code": 200,
    "message": "success"
  },
  "result": {
    "window": "block",
    "data": [
      {
        "date": "2019-09-02",
        "hashrate": 8561054
      },
      {
        "date": "2019-09-01",
        "hashrate": 9242532
      }
    ]
  }
}

PreviousBTC Entity Status

NextBTC Market Data

Last updated 7 months ago

Was this helpful?