Jump to
Ctrl
+
/

Get Block Details By Block Height

GET
/blockchain-data/{blockchain}/{network}/blocks/height/{height}

Through this endpoint customers can obtain basic information about a given mined block, specifically by using the height parameter. These block details could include the hash of the specific, the previous and the next block, its transactions count, its height, etc.

Blockchain specific data is information such as version, nonce, size, bits, merkleroot, etc.

Path Parameters

blockchain string Required

Represents the specific blockchain protocol name, e.g. Ethereum, Bitcoin, etc.

network string Required

Represents the name of the blockchain network used; blockchain networks are usually identical as technology and software, but they differ in data, e.g. - "mainnet" is the live network with actual data while networks like "testnet", "sepolia" are test networks.

height integer Required

Represents the number of blocks in the blockchain preceding this specific block. Block numbers have no gaps. A blockchain usually starts with block 0 called the "Genesis block".

Query Parameters

context string Optional

In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. context is specified by the user.

Response Schema

apiVersion string Required

Specifies the version of the API that incorporates this endpoint.

2023-04-25
requestId string Required

Defines the ID of the request. The requestId is generated by Crypto APIs and it's unique for every request.

601c1710034ed6d407996b30
context string Optional

In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. context is specified by the user.

yourExampleString
data object Required
item object Required
hash string Required

Represents the hash of the block, which is its unique identifier. It represents a cryptographic digital fingerprint made by hashing the block header twice through the SHA256 algorithm.

00000000000000000002ad6f9c74faf503bb055c54e0d0746ef34f888f95890f
height string Required

Represents the number of blocks in the blockchain preceding this specific block. Block numbers have no gaps. A blockchain usually starts with block 0 called the "Genesis block".

673852
nextBlockHash string Required

Representation of the next block hash.

00000000000000000008953625613e60b56194ea31f07aad43c7505fbddce78f
previousBlockHash string Required

Represents the hash of the previous block, also known as the parent block.

00000000000000000008953625613e60b56194ea31f07aad43c7505fbddce77f
timestamp integer Required

Defines the exact date/time when this block was mined in Unix Timestamp.

1681893875
transactionsCount integer Required

Represents the total number of all transactions as part of this block.

12
blockchainSpecific object Required
bits string Required

A sub-unit of BTC equal to 0.000001 BTC, or 100 Satoshi, and is the same as microbitcoin (μBTC). Bits have two-decimal precision.

420773839
chainwork string Required

Represents a hexadecimal number of all the hashes necessary to produce the current chain. E.g., when converting 0000000000000000000000000000000000000000000086859f7a841475b236fd to a decimal you get 635262017308958427068157 hashes, or 635262 exahashes.

0000000000000000000000000000000000000000000003ddecb747af741625d6
difficulty string Optional

Numeric representation of the block difficulty

merkleRoot string Required

Defines the single and final (root) node of a Merkle tree. It is the combined hash of all transactions' hashes that are part of a blockchain block.

7b52cc9ce137b92365eb4d0f8a708da9e3ba199aa422f96352a0c0c87221251b
nonce integer Required

Represents a random value that can be adjusted to satisfy the Proof of Work.

1535290446
size integer Required

Represents the total size of the block in Bytes.

3892
strippedSize integer Required

Defines the numeric representation of the block size excluding the witness data.

2840
version integer Required

Represents the version of the specific block on the blockchain.

545259520
versionHex string Required

Is the hexadecimal string representation of the block's version.

20000
weight integer Required

Represents a measurement to compare the size of different transactions to each other in proportion to the block size limit.

12412

Credits Cost : 500 Credits for 1 Results

Was this page helpful?
Yes
No
Powered by
Language
URL

{
    "apiVersion": "2023-04-25",
    "requestId": "601c1710034ed6d407996b30",
    "context": "yourExampleString",
    "data": {
        "item": {
            "hash": "00000000000000000002ad6f9c74faf503bb055c54e0d0746ef34f888f95890f",
            "height": "673852",
            "nextBlockHash": "00000000000000000008953625613e60b56194ea31f07aad43c7505fbddce78f",
            "previousBlockHash": "00000000000000000008953625613e60b56194ea31f07aad43c7505fbddce77f",
            "timestamp": 1681893875,
            "transactionsCount": 12,
            "blockchainSpecific": {
                "bits": "420773839",
                "chainwork": "0000000000000000000000000000000000000000000003ddecb747af741625d6",
                "difficulty": "",
                "merkleRoot": "7b52cc9ce137b92365eb4d0f8a708da9e3ba199aa422f96352a0c0c87221251b",
                "nonce": 1535290446,
                "size": 3892,
                "strippedSize": 2840,
                "version": 545259520,
                "versionHex": "20000",
                "weight": 12412
            }
        }
    }
}