Get consensus block

Returns the latest block that has reached consensus and is guaranteed to be final. This block will never be reverted, making it safe for confirming transactions that require absolute finality.

GET /api/v2/getConsensusBlock

Get consensus block

cURL

curl --request GET \
  --url https://toncenter.com/api/v2/getConsensusBlock \
  --header 'X-API-Key: <api-key>'

200

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

Authorizations

APIKeyHeaderAPIKeyQuery

X-API-Key · string · header · required

API key header of the form X-API-Key: <token>, where <token> is the API key. Requests without a key are limited to 1 RPS. Refer to the authentication guide for details.

Response

200

application/json

The latest masterchain block that has achieved finality, guaranteed to never be reverted. Returns its sequence number and Unix timestamp.

ok · boolean · default: true · required

Returns true if the request succeeded; otherwise false. See the error field for details.

result · object · required

Response data. Present only when ok is true.

Show child attributes

@extra · string

Optional request ID that can be passed in the request and received back in the response. Useful for matching async responses.