Skip to main content

get_blocks_details

Return blocks details for a specified range of heights.

Request​

{
    "jsonrpc": "2.0",
    "id": 0,
    "method": "get_blocks_details",
    "params": {
        "height_start": 1,
        "count": 1
    }
}

Request parameters​

  • height_start - starting height
  • count - number of blocks to be requested

Response​

{
    "id": 0,
    "jsonrpc": "2.0",
    "result": {
        "blocks": [
            {
                "actual_timestamp": 1557342384,
                "already_generated_coins": "17517204000000000000",
                "base_reward": 1000000000000,
                "blob": "",
                "block_cumulative_size": 0,
                "block_tself_size": 0,
                "cumulative_diff_adjusted": "2",
                "cumulative_diff_precise": "1",
                "difficulty": "1",
                "effective_fee_median": 10000,
                "height": 1,
                "id": "901214ab938219f5b33b547008607aee14d29950a34834a2e9973b96269bd0b0",
                "is_orphan": false,
                "miner_text_info": "",
                "object_in_json": "{\n  \"major_version\": 0, \n  \"nonce\": 1532031558827332528, \n  \"prev_id\": \"cc608f59f8080e2fbfe3c8c80eb6e6a953d47cf2d6aebd345bada3a1cab99852\", \n  \"minor_version\": 0, \n  \"timestamp\": 1557342384, \n  \"flags\": 0, \n  \"miner_tx\": {\n    \"version\": 1, \n    \"vin\": [ {\n        \"gen\": {\n          \"height\": 1\n        }\n      }\n    ], \n    \"vout\": [ {\n        \"amount\": 1000000000000, \n        \"target\": {\n          \"key\": \"ffd231f5386282c281f58c8d578c95b429b1b8ed5bddd6472d58b911384cd99300\"\n        }\n      }\n    ], \n    \"extra\": [ {\n        \"pub_key\": \"24196c9ab3f827a586cc906a6133f0b4b0663eb15491fae33e9ade63d34ae398\"\n      }, {\n        \"extra_padding\": , \n        \"buff\": [ ]\n      }, {\n        \"etc_tx_flags16\": , \n        \"v\": 63119\n      }, {\n        \"unlock_time\": , \n        \"v\": 11\n      }, {\n        \"string\": 8\"8f3f4736b24f69a8\"\n      }], \n    \"signatures\": [ ], \n    \"attachment\": [ ]\n  }, \n  \"tx_hashes\": [ ]\n}",
                "penalty": 0,
                "pow_seed": "",
                "prev_id": "cc608f59f8080e2fbfe3c8c80eb6e6a953d47cf2d6aebd345bada3a1cab99852",
                "summary_reward": 1000000000000,
                "this_block_fee_median": 0,
                "timestamp": 1557342384,
                "total_fee": 0,
                "total_txs_size": 0,
                "transactions_details": [
                    {
                        "amount": 1000000000000,
                        "blob": "",
                        "blob_size": 96,
                        "fee": 0,
                        "id": "8d0fbc9ee9948bc74bf6b80914e95997e9769641f3a20ef963c4264922ac004b",
                        "keeper_block": 1,
                        "object_in_json": "",
                        "pub_key": "24196c9ab3f827a586cc906a6133f0b4b0663eb15491fae33e9ade63d34ae398",
                        "timestamp": 1557342384
                    }
                ],
                "type": 1
            }
        ],
        "status": "OK"
    }
}

Response information​

  • status — string; call result. OK if the request has been processed successfully, BUSY if the core is not ready yet, otherwise an error string.

  • blocks — array of block_rpc_extended_info objects, one per block in the requested range, ordered by ascending height. Fields of each object:

  • actual_timestamp — unsigned int; timestamp for the moment of block creation (for PoW blocks equal to timestamp, for PoS they differ).

  • already_generated_coins — unsigned int; total number of coins generated, including this block.

  • base_reward — unsigned int; base reward for the block (equal to reward if there are no transactions except the miner tx).

  • blob — string; reserved for the raw serialized block blob. The core does not populate it for this call, so it is always returned as an empty string. Use object_in_json to inspect the block contents, or getblockheaderbyhash / get_main_block_details if you need header data.

  • block_cumulative_size — unsigned int; total size of block's transactions, in bytes. Miner tx is included in special cases.

  • block_tself_size — unsigned int; reserved for the size of the block structure itself (i.e. excluding its transactions), in bytes. The core does not populate it for this call, so it is always returned as 0.

  • cumulative_diff_adjusted — unsigned int; cumulative PoS or PoW difficulty for the block, adjusted by the sequence factor (number of same type - blocks going sequentially one-by-one).

  • cumulative_diff_precise — unsigned int; precise cumulative PoS or PoW difficulty for the block.

  • difficulty — unsigned int; difficulty of the block.

  • effective_fee_median — unsigned int; median of transaction fees within a specific window used in calculations for this block.

  • height — unsigned int; block height.

  • id — string; block hash identifier.

  • is_orphan — boolean; orphan status for the block. False for normal blocks.

  • miner_text_info — string; undefined text inserted by miner when the block was mined.

  • object_in_json — string; JSON-serialized block object.

  • penalty — unsigned int; difference between summary_reward and base_reward.

  • pow_seed — string; reserved for the hex-encoded ethash seed hash of the epoch this block belongs to (the value a miner needs in order to build the PoW dataset for the block). The core does not populate it for this call, so it is always returned as an empty string; use getblocktemplate instead, whose seed field carries this value for the block being mined.

  • prev_id — string; hash identifier of the previous block.

  • summary_reward — unsigned int; amount of coins this block has generated in miner tx.

  • this_block_fee_median — unsigned int; median fee among the transactions for this block.

  • timestamp — unsigned int; block timestamp (serves a special purpose for PoS blocks, which is why actual_timestamp should be used as actual block timestamp).

  • total_fee — unsigned int; sum of transaction fees in this block.

  • total_txs_size — unsigned int; total transaction size in this block (excluding the miner tx).

  • transactions_details — array of tx_rpc_extended_info objects, one per transaction in the block (including the miner tx). This call returns the short form of the object; the full form, with ins, outs, extra and attachments, is returned by get_tx_details. Fields:

    • amount — unsigned int; total amount of coins in the transaction outputs, in atomic units.
    • blob — string; reserved for the raw serialized transaction blob. The core does not populate it for this call, so it is always returned as an empty string.
    • blob_size — unsigned int; size of the serialized transaction, in bytes.
    • fee — unsigned int; fee paid by the transaction, in atomic units. 0 for the miner tx.
    • id — string; hex-encoded transaction hash identifier.
    • keeper_block — signed int; height of the block that contains this transaction. -1 means the transaction is unconfirmed (still in the tx pool).
    • object_in_json — string; JSON-serialized transaction object. Only filled in by the calls that return the full form of the object, so it is empty here.
    • pub_key — string; hex-encoded transaction public key taken from the transaction extra field.
    • timestamp — unsigned int; UNIX timestamp of the block that contains this transaction; for pool transactions, the moment the transaction was received.

  • type — unsigned int; 0 if this is PoS block, 1 if this is PoW block