Get consensus block

Returns the latest block that has reached consensus. Unlike the latest block from getMasterchainInfo, this block is guaranteed to be final and will never be reverted. Use this when you need absolute certainty that a transaction is permanent.

POST /api/v2/getConsensusBlock

Get consensus block

cURL

curl --request POST \
  --url https://toncenter.com/api/v2/getConsensusBlock \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{}'

200

{
  "ok": true,
  "result": {
    "@type": "ext.blocks.consensusBlock",
    "consensus_block": 123,
    "timestamp": 123
  },
  "@extra": "<string>"
}

Authorizations

APIKeyHeaderAPIKeyQuery

X-API-Key · string · header · required

Body

application/json

Empty request body for endpoints that require no parameters.

Response

200

application/json

OK

Response containing the latest consensus block information.

ok · boolean · default: true · required

Indicates if the request succeeded. If false, check the error field for details.

result · object · required

The response data. Only present when ok is true.

Show child attributes

@extra · string

Optional request ID that you can pass in the request and receive back in the response. Useful for matching async responses.