getBlockHeader

curl --request POST \
  --url https://api.uniblock.dev/uni/v1/json-rpc?chainId=toncoin \
  --header 'content-type: application/json' \
  --data '{
    "id": 1,
    "jsonrpc": "2.0",
    "method": "getBlockHeader",
    "params": {
      "workchain": -1,
      "shard": "-9223372036854775808",
      "seqno": 39064985
    }
  }'

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {}
}

curl --request POST \
  --url https://api.uniblock.dev/uni/v1/json-rpc?chainId=toncoin \
  --header 'content-type: application/json' \
  --data '{
    "id": 1,
    "jsonrpc": "2.0",
    "method": "getBlockHeader",
    "params": {
      "workchain": -1,
      "shard": "-9223372036854775808",
      "seqno": 39064985
    }
  }'

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {}
}

Parameters

string

default:"toncoin"

required

Unique identifier for a blockchain network.

number

default:1

required

Request identifier used to match responses.

string

default:"2.0"

required

JSON-RPC version.

string

default:"getBlockHeader"

required

JSON-RPC method name.

object

required

TON block header lookup request.Parameters for getBlockHeader:

params.workchain: Block workchain ID. The masterchain uses -1.
params.shard: Block shard ID encoded as a signed 64-bit integer string. The masterchain shard is -9223372036854775808.
params.seqno: Sequence number of the block to retrieve.
params.root_hash: Optional block root hash. Providers may use this to disambiguate or validate the requested block.
params.file_hash: Optional block file hash. Providers may use this to disambiguate or validate the requested block.

Returns

object

TON block header metadata.

Show properties

string

TON object type marker.

object

TON extended block identifier.

Show properties

string

TON object type marker.

integer

Block workchain ID. The masterchain uses -1.

string

Block shard ID encoded as a signed 64-bit integer string.

integer

Block sequence number.

string

Block root hash.

string

Block file hash.

integer

TON network global ID.

integer

Block header version.

integer

Block header flags bitset.

boolean

Whether the block was created after a shard merge.

boolean

Whether the block was created after a shard split.

boolean

Whether the block precedes a shard split.

boolean

Whether the shard wants to merge.

boolean

Whether the shard wants to split.

integer

Short hash of the validator list.

integer

Catchain sequence number.

integer

Minimum referenced masterchain sequence number.

boolean

Whether this block is a key block.

integer

Previous key block sequence number.

string

Start logical time for this block.

string

End logical time for this block.

integer

Unix timestamp when the block was generated.

integer

Vertical sequence number.

array

Previous block identifiers.

Show items

object

TON extended block identifier.

Show properties

string

TON object type marker.

integer

Block workchain ID. The masterchain uses -1.

string

Block shard ID encoded as a signed 64-bit integer string.

integer

Block sequence number.

string

Block root hash.

string

Block file hash.

string

Provider-specific response metadata.

curl --request POST \
  --url https://api.uniblock.dev/uni/v1/json-rpc?chainId=toncoin \
  --header 'content-type: application/json' \
  --data '{
    "id": 1,
    "jsonrpc": "2.0",
    "method": "getBlockHeader",
    "params": {
      "workchain": -1,
      "shard": "-9223372036854775808",
      "seqno": 39064985
    }
  }'

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {}
}

Getting started

API Reference

Parameters

Returns