Stats API

Standard endpoints

class blockscan.modules.stats.Stats(parent_connection)[source]
get_currency_last_price()[source]

Get the last price of the main currency against BTC and USD.

Returns

Latest dictionary of currency price pairs.

Return type

dict

get_nodes_size(start_date: str, end_date: str, client_type: str, sync_mode: str, sort: str) → str[source]

Get the size of the blockchain, in bytes, over a date range.

Parameters

  • start_date (str) – the starting date in yyyy-MM-dd

  • end_date (str) – the end date in yyyy-MM-dd

  • client_type (str) – The node client to use (i.e geth or parity)

  • sync_mode (str) – type of node, default or archive

  • sort (str) – the sorting preference (asc or desc)

Returns

blockchain size

Return type

str

get_total_currency_supply()[source]

Get total supply of main currency on selected chain.

Returns

The total supply of currency.

Return type

str

get_total_eth2_supply()[source]

Get total supply of ETH2 currency.

Returns

The total supply of ETH2.

Return type

str

get_validators_list()[source]

Get list of validators on POE network.

Returns

All validators as a list of dictionaries.

Return type

List[dict]

Pro endpoints

class blockscan.modules.stats.ProStats(parent_connection)[source]
get_daily_average_network_difficulty(start_date: str, end_date: str, sort: str) → str[source]

Note

Pro API token required

Get the historical mining difficulty of the network within a date range

Parameters

  • start_date (str) – the starting date in yyyy-MM-dd

  • end_date (str) – the end date in yyyy-MM-dd

  • sort (str) – the sorting preference (asc or desc)

Returns

daily mining difficulty

Return type

str

get_daily_average_network_hash_rate(start_date: str, end_date: str, sort: str) → str[source]

Note

Pro API token required

Get the historical measure of processing power of the network within a date range

Parameters

  • start_date (str) – the starting date in yyyy-MM-dd

  • end_date (str) – the end date in yyyy-MM-dd

  • sort (str) – the sorting preference (asc or desc)

Returns

daily hashrate

Return type

str

get_daily_network_utilization(start_date: str, end_date: str, sort: str) → str[source]

Note

Pro API token required

Get the daily average gas used over gas limit, in percentage within a date range

Parameters

  • start_date (str) – the starting date in yyyy-MM-dd

  • end_date (str) – the end date in yyyy-MM-dd

  • sort (str) – the sorting preference (asc or desc)

Returns

daily average gas used over gas limit

Return type

str

get_daily_new_address_count(start_date: str, end_date: str, sort: str) → str[source]

Note

Pro API token required

Get the number of new addresses created per day within a date range

Parameters

  • start_date (str) – the starting date in yyyy-MM-dd

  • end_date (str) – the end date in yyyy-MM-dd

  • sort (str) – the sorting preference (asc or desc)

Returns

daily new address

Return type

str

get_daily_tx_count(start_date: str, end_date: str, sort: str) → str[source]

Note

Pro API token required

Get the number of transactions performed on the blockchain per day within a date range

Parameters

  • start_date (str) – the starting date in yyyy-MM-dd

  • end_date (str) – the end date in yyyy-MM-dd

  • sort (str) – the sorting preference (asc or desc)

Returns

number of transactions

Return type

str

get_eth_daily_network_tx_fee(start_date: str, end_date: str, sort: str) → str[source]

Note

Pro API token required

Get the amount of transaction fees paid to miners per day within a date range

Parameters

  • start_date (str) – the starting date in yyyy-MM-dd

  • end_date (str) – the end date in yyyy-MM-dd

  • sort (str) – the sorting preference (asc or desc)

Returns

Transaction fees paid

Return type

str

get_eth_hist_price(start_date: str, end_date: str, sort: str) → str[source]

Note

Pro API token required

Get the historical price of 1 unit of the currency within a date range

Parameters

  • start_date (str) – the starting date in yyyy-MM-dd

  • end_date (str) – the end date in yyyy-MM-dd

  • sort (str) – the sorting preference (asc or desc)

Returns

daily price

Return type

str

get_hist_daily_market_cap(start_date: str, end_date: str, sort: str) → str[source]

Note

Pro API token required

Get the historical daily market capitalization within a date range

Parameters

  • start_date (str) – the starting date in yyyy-MM-dd

  • end_date (str) – the end date in yyyy-MM-dd

  • sort (str) – the sorting preference (asc or desc)

Returns

daily market capitalization

Return type

str