Response (latest block)

api/v3

Response (latest block)200 OK, application/json

If range is not set or set to 1, the following object is returned. Else, a block list with the following objects as elements is returned:

Parameter	Type	Description
height	number	Height of the block.
hash	string	Hash value representing the block.
difficulty	string	Difficulty of the mined block.
merkleRoot	string	Merkle hash of all transactions in the block.
stateRoot	string	Hash of the world state at that block.
timestamp	number	Timestamp when the block was added.
txs	array	List of transactions in the block.
nonce	string	Nonce of the block.
miner	string	A Hycon wallet address of the miner.
uncleHash	array	List of hash values of uncle block.
previousHash	string	The hash value of the previous block.

Response Error Table

Status	Error	Message
400	BAD_REQUEST	The parameter value passed as count is invalid
404	NOT_FOUND	Tip information is undefined in consensus

Example request without specified range

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

Response (Success) without specified range

{
    "height": 412510,
    "hash": "6ZDkzCeih26nQ6ry84FhvJackNpRgKGKmFCrhvQsdfMf",
    "difficulty": "2.2465660159450127e-9",
    "merkleRoot": "8FKVTsPMMfgjp7tWZLgmrodcFPy8PcVMMc9r3fPdvu5p",
    "stateRoot": "DVuavQUzM2GTD7D43n83vDm1TDnb5r6dVc2UDNZbdJon",
    "timestamp": 1543462655832,
    "txs": [
        {
            "amount": "28.312759446",
            "to": "H3mt6xb2evbvJ5m58181t2hjQxrhE6gFz",
            "txhash": "4qpzsvd9YtZAtU7UWnByN8JTfbkYHrGd2PjZ9pQNepTj",
            "fee": "0.000001",
            "from": "H23fF8ktBWYwK7aHFbPSW52LtoHcbDvmT",
            "nonce": 2667656
        },
        ...
    ],
    "nonce": "16769771563250614862",
    "miner": "H23fF8ktBWYwK7aHFbPSW52LtoHcbDvmT",
    "uncleHash": [
        "7ZY6RZGxLeBnzenpYL6m8x1F1sq3umsyW5ZEry3d1D8o"
    ],
    "previousHash": "3ZPBmRgzt3sN1QqvbArfvDG465b47FUR7bPvRwtnxWbS"
}

Example request with specified range

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

Response (Success) with specified range

[
    {
        "height": 412509,
        "hash": "3ZPBmRgzt3sN1QqvbArfvDG465b47FUR7bPvRwtnxWbS",
        "difficulty": "2.267803372508838e-9",
        "merkleRoot": "xyw95Bsby3s4mt6f4FmFDnFVpQBAeJxBFNGzu2cX4dM",
        "stateRoot": "EryxtWHTHorKRmqozQe63XmYLezjdaNxcAZESyWdaCPd",
        "timestamp": 1543462624068,
        "txs": [],
        "nonce": "16909528905709264102",
        "miner": "H23fF8ktBWYwK7aHFbPSW52LtoHcbDvmT",
        "uncleHash": [],
        "previousHash": "BtGd36He84SMQYv61Tr1wowtnoE1Ey1HiMTW2QwajQea"
    },
    ...
]