Getting the details of a block

api/v1

Retrieve the details of a block given its hash to lookup.

Path Parameter

Parameter	Type	Required	Description
hash	string	Yes	A hash string of a block to lookup

Response - 200 OK, application/json

Parameter	Type	Description
hash	string	Hash representation of the block
amount	string	Amount of Hycon in the block (sum of transactions)
difficulty	string	Mining difficulty of block
fee	string	Total fees accumulated from transactions in the block
length	number	Number of transactions in the block
volume	string	Amount of Hycon in the block (sum of transactions)
stateRoot	string	Hash of the world state at that block
merkleRoot	string	Merkle hash of all transactions in the block
txs	list	List of transactions in the block
height	number	Height of the block
timestamp	number	Timestamp when the block was added
prevBlock	string	Previous block hash
nonce	string	Value assigned by the miner that constitutes proof of work
miner	string	Wallet address of the miner
resultHash	string	Value assigned by the miner that constitutes proof of work

Response Error Table

Status	Error	Message
404	NOT_FOUND	the block cannot be found

GET/api/v1/block/{hash}

Example request

$ curl -X GET http://localhost:2442/api/v1/block/EL5DXFLKx8Y5YayvJQjqAsb3RvFRV4twUo8ZnNzQsnar \
    -H 'Content-Type: application/json;charset=utf-8'

Response (Success)

{
    "hash": "EL5DXFLKx8Y5YayvJQjqAsb3RvFRV4twUo8ZnNzQsnar",
    "amount": "976.721369496",
    "difficulty": "1.4581169978347811e-9",
    "fee": "0.00003",
    "length": 30,
    "volume": "976.721399496",
    "stateRoot": "GXs3WPMAKaRTB6mx98jPqnmPhnVge86DUN4KaWX5ovNk",
    "merkleRoot": "4e25MRTztFcWYZwB4F7JwA8bfv8nokWQannJdTW6oGim",
    "txs": [
        {
            "hash": "BDaTKkKihPJi3nzB5wmKBMfvdz1oum64FjCVinFkkYJb",
            "amount": "0.137988774",
            "fee": "0.000001",
            "from": "H23fF8ktBWYwK7aHFbPSW52LtoHcbDvmT",
            "to": "H28ohpNTCZgviHTV8ftRQvQKBRVpbC5cr",
            "estimated": "0.137989774",
            "receiveTime": 1541402086473,
            "nonce": 1888209
        },
        ...
    ],
    "height": 317714,
    "timeStamp": 1541402086473,
    "prevBlock": "55FeLzZohwsp7kUyxGBRcHQJAVqRLsar6CQmZvK9ZdpM",
    "nonce": "000016147ffffffc",
    "miner": "H23fF8ktBWYwK7aHFbPSW52LtoHcbDvmT",
    "resultHash": "000000019fd96c80c8fbfd04ee0b339989bc8421da243c59b3979865f8fa4025"
}