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.

2021-03-20
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.

000000000000000cf507214c4f86a5048449230bc5c5dbbed59aa74421553f26
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".

1939743
nextBlockHash string Required

Represents the hash of the next block. When this is the last block of the blockchain this value will be an empty string.

000000000000000e2f2e4fab8eaaa6bb39632a79a825d34169d451a86959fe04
previousBlockHash string Required

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

00000000b8c2337ed1221d1861105ad227dfff93b0a1798e78fb6edff58925f5
timestamp integer Required

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

1615378134
transactionsCount integer Required

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

12
blockchainSpecific object Required
difficulty string Required

Represents a mathematical value of how hard it is to find a valid hash for this block.

209515044.4071968
size integer Optional

Numeric representation of the block size

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
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
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
Language
URL

{
    "apiVersion": "2021-03-20",
    "requestId": "601c1710034ed6d407996b30",
    "context": "yourExampleString",
    "data": {
        "item": {
            "hash": "000000000000000cf507214c4f86a5048449230bc5c5dbbed59aa74421553f26",
            "height": 1939743,
            "nextBlockHash": "000000000000000e2f2e4fab8eaaa6bb39632a79a825d34169d451a86959fe04",
            "previousBlockHash": "00000000b8c2337ed1221d1861105ad227dfff93b0a1798e78fb6edff58925f5",
            "timestamp": 1615378134,
            "transactionsCount": 12,
            "blockchainSpecific": {
                "difficulty": "209515044.4071968",
                "size": "",
                "bits": "420773839",
                "chainwork": "0000000000000000000000000000000000000000000003ddecb747af741625d6",
                "merkleRoot": "7b52cc9ce137b92365eb4d0f8a708da9e3ba199aa422f96352a0c0c87221251b",
                "nonce": 1535290446,
                "strippedSize": 2840,
                "version": 545259520,
                "versionHex": "20000",
                "weight": 12412
            }
        }
    }
}