Hive Developer logo

Hive Developer Portal

Methods:

Used to query values related to the block plugin. These AppBase API methods are still under development and subject to change.

block_api.get_block

Retrieve a full, signed block of the referenced block, or null if no matching block was found.

Parameters:

block_num (int)  
1 Queries the very first block.
8675309 Queries block number 8,675,309.
62396745 Queries block number 62,396,745.
Query Parameters JSON
{"block_num": 0}
Expected Response JSON
{
  "block": {
    "previous": "0000000000000000000000000000000000000000",
    "timestamp": "2016-03-24T16:05:00",
    "witness": "",
    "transaction_merkle_root": "0000000000000000000000000000000000000000",
    "extensions": [],
    "witness_signature": "",
    "transactions": [],
    "block_id": "",
    "signing_key": "",
    "transaction_ids": []
  }
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"block_api.get_block", "params":{"block_num":1}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"block_api.get_block", "params":{"block_num":8675309}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"block_api.get_block", "params":{"block_num":62396745}, "id":1}' https://api.hive.blog

block_api.get_block_header

Retrieve a block header of the referenced block, or null if no matching block was found.

Parameters:

block_num (int)  
1 Queries the block headers for the very first block.
8675309 Queries block headers for block number 8,675,309.
62396745 Queries block headers for block number 62,396,745.
Query Parameters JSON
{"block_num": 0}
Expected Response JSON
{
  "header": {
    "previous": "0000000000000000000000000000000000000000",
    "timestamp": "2016-03-24T16:05:00",
    "witness": "",
    "transaction_merkle_root": "0000000000000000000000000000000000000000",
    "extensions": []
  }
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"block_api.get_block_header", "params":{"block_num":1}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"block_api.get_block_header", "params":{"block_num":8675309}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"block_api.get_block_header", "params":{"block_num":62396745}, "id":1}' https://api.hive.blog

block_api.get_block_range

Retrieve a range of full, signed blocks. The list may be shorter than requested if count blocks would take you past the current head block.

Parameters:

starting_block_num (int) count (int)  
1 10 Queries the block headers for the very first block through the tenth block.
8675309 50 Queries block headers for block numbers 8,675,309 through 8,675,359.
62396745 1000 Queries block headers for block numbers 62,396,745 through 62,397,745.

See: !149, 702ea4a

Query Parameters JSON
{"starting_block_num": 0, "count": 0}
Expected Response JSON
{"blocks": []}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"block_api.get_block_range", "params":{"starting_block_num": 1, "count": 10}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"block_api.get_block_range", "params":{"starting_block_num": 8675309, "count": 50}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"block_api.get_block_range", "params":{"starting_block_num": 62396745, "count": 1000}, "id":1}' https://api.hive.blog